> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nudj.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Widget overview

> The embeddable loyalty widget you may see inside a brand's store

The Nudj widget is an embeddable surface that brands can drop into their site or app (commonly a Shopify storefront). It gives members a compact loyalty UI — wallet snapshot, challenges, rewards, referrals, tiers, and more — without leaving the host site.

## How it's embedded

The host site loads the widget as an iframe. The widget runs the Nudj user app inside that iframe, scoped to the brand's community. Mobile nav positioning uses absolute positioning so it renders correctly inside the iframe.

## Signed-out state

If you open the widget as a guest, the widget shows a **signed-out value-prop** — a compact sell for what you'd gain by signing in (points balance, rewards, referrals). Tapping the sign-in CTA opens the sign-in flow.

## What's inside

Depending on the community's widget configuration, the widget can include:

* **Wallet snapshot** — balance and recent assets.
* **Quick actions** — shortcuts to the most common tasks ([Quick actions](/user-guide/widget/quick-actions)).
* **Tier display** — your current loyalty tier and progress ([Tiers](/user-guide/widget/tiers)).
* **Challenges carousel** — active and upcoming challenges.
* **Rewards list** — featured and available rewards.
* **Refer-a-friend card** — a compact referral surface ([Refer-a-friend](/user-guide/widget/refer-a-friend)).
* **Section titles with optional tooltips** — each section can include a small ? tooltip that explains what it contains.

## Card layouts

Widgets support different card layouts — direct item linking, featured products, AI-generated imagery on reward cards. The exact mix is configured per community.

## Deep linking

The widget supports deep links that open a specific reward, challenge, or wallet view directly. See [Deep linking](/user-guide/widget/deep-linking).

## Performance

The widget is optimised for fast load in a constrained iframe environment — minimal initial payload, progressive content, and the brand's theme colours applied without re-flashes.

## Related

<CardGroup cols={4}>
  <Card title="Deep linking" icon="link" href="/user-guide/widget/deep-linking">
    Direct-open URLs.
  </Card>

  <Card title="Quick actions" icon="bolt" href="/user-guide/widget/quick-actions">
    Fast shortcuts.
  </Card>

  <Card title="Tiers" icon="ranking-star" href="/user-guide/widget/tiers">
    Loyalty tiers.
  </Card>

  <Card title="Refer-a-friend" icon="share-nodes" href="/user-guide/widget/refer-a-friend">
    Referrals inside the widget.
  </Card>
</CardGroup>
