> ## 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.

# Checkout Extensions

> How referral codes are generated and displayed at checkout

## Overview

Referbro includes a **Checkout Extension** that integrates directly into Shopify's checkout and post-purchase pages. It automatically generates referral codes for customers and displays sharing options at the most impactful moment — right after purchase.

## How It Works

1. A customer **completes a purchase** on your store.
2. The checkout extension **identifies the customer** from the order.
3. A **unique referral code** is generated (or retrieved if one already exists).
4. The customer sees a **widget** with their referral link and sharing options.

## Widget Placements

### Thank You Page

Displayed immediately after the customer completes checkout. This is the **highest-conversion** placement — customers are happiest right after purchase.

* Shows the customer's unique referral link
* Provides one-click WhatsApp sharing with a pre-filled message
* Displays the campaign's incentive text (e.g., "Share and earn ₹150!")

### Order Status Page

Displayed when customers return to check their order status. Reinforces the referral offer on repeat visits.

## Enabling Checkout Extensions

<Steps>
  <Step title="Open the Checkout Editor">
    Go to **Shopify Admin → Settings → Checkout → Customize** (or navigate to **Online Store → Themes → Customize** and select the Checkout page).
  </Step>

  <Step title="Add the Referbro Widget">
    Add the **Referbro Widget** block to:

    * **Thank You** page *(recommended)*
    * **Order Status** page *(recommended)*
    * **Checkout** page *(optional)*
  </Step>

  <Step title="Save">
    Click **Save** to publish the changes.
  </Step>
</Steps>

<Note>
  Checkout extensions work with Shopify's Checkout Extensibility. They are available on all Shopify plans that support checkout customization.
</Note>