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

# Widgets

> Embedding referral points on your store

Referbro provides two types of widgets to integrate the referral experience into your customer's journey.

For a screen-by-screen Shopify setup walkthrough, see [How to Configure Refer and Earn Widgets in Shopify](https://scribehow.com/viewer/How_to_Configure_Refer_and_Earn_Widgets_in_Shopify__GxG4UYOETyqp12igzNa-dA).

## Theme Widgets (App Embeds)

These are added via the Shopify Theme Editor and appear on your storefront.

### Refer & Earn Floating Button

A floating launcher button usually placed at the bottom corner of the screen.

* **Behavior**: Opens a modal or sidebar with the user's referral link and sharing options.
* **Customization**: Color and position can be matched to your brand.

### Referral Received Popup

A popup displayed to *referees* (friends) when they visit the store via a referral link.

* **Purpose**: Acknowledges the referral and shows the discount code they can use.
* **Auto-Apply**: In many cases, the discount is auto-applied to the cart.

## Checkout Extensions

Designed for Shopify Plus and valid checkout extensibility contexts.

### Order Status Page

This is the most effective placement for referrals. Capture customers when they are happiest—right after purchase.

* **Important**: You should use the new **Thank You** and **Order Status** pages provided by Shopify to use the widget on these pages.
* **Content**: "Love your purchase? Refer a friend and get \$10 off your next order!"
* **Features**: One-click WhatsApp sharing pre-filled with the message.

### Checkout Page

Can be placed in the checkout flow to encourage sharing before completion, though typically used less frequently than the Order Status page to avoid distraction.