# Referral at Checkout Page

{% hint style="info" %}
This feature is available for the **Ultimate** plan and Shopify Plus for [Checkout Extensibility](https://www.shopify.com/plus/upgrading-to-checkout-extensibility)
{% endhint %}

### Overview

Let customers enter a referral link or code directly at checkout to instantly claim their referral reward.\
This helps shorten the referral flow, increase visibility, and improve conversion.

> ⚡ Available for **Shopify Plus** stores (Checkout Extensibility only).\
> 🧩 Cart Drawer support will be available soon.

***

### How to set up

{% embed url="<https://app.arcade.software/share/fWbNIAibXLTHqDMIqQT9>" %}

1. Go to **Joy App → On-site content → Checkout page**.
2. Find the block **Referral at Checkout** and click **Edit in Theme Editor**.
3. In the **Theme Editor**, find the block **Referral at Checkout Page**.
4. Drag and place it where you want on the checkout page.
5. Edit text if needed:
   * **Title:** “Have a referral link?”
   * **Description:** “Enter your referral link or code below to claim your {{ referral\_reward }} discount.”
6. Click **Save** to apply changes.

***

### Customer experience

1. Customer enters a referral link or code and clicks **Apply**.
2. The system validates:
   * ✅ **If valid:**
     * Shows message: “Successful referral! You’ve received a discount code: {coupon\_code}.”
     * Displays a button **Apply coupon** next to it.
     * Customer clicks **Apply coupon** → the system applies the discount to the order.
       * If the coupon is valid and applicable → order total updates immediately.
       * If the coupon cannot be applied (expired, not applicable, etc.) → shows an error message.
   * ❌ **If invalid:**
     * Shows message: “Referral link or code is invalid. Please try again.”

<figure><img src="/files/AVUJ6ZfFaFnGxBdk4bex" alt=""><figcaption></figcaption></figure>

***

<figure><img src="/files/Tj7fwVKq4wGIyMEYeaD5" alt=""><figcaption></figcaption></figure>

### FAQ

**1. Who can use this feature?**\
→ Only available for **Shopify Plus** stores using Checkout Extensibility.

**2. What happens if the coupon is invalid or expired?**\
→ The system will show an error message and the coupon won’t be applied.

**3. Can I customize the reward amount?**\
→ The reward amount follows your referral program settings.

**4. Can I add this to the Cart Drawer?**\
→ Not yet, but support for Cart Drawer is coming soon.

***

### Related articles

* [Referral Block on Thank You Page](https://help.joy.so/on-site-content/thank-you-page/referral-block)
* [Reward Celebration](https://help.joy.so/on-site-content/thank-you-page/reward-celebration)
* [Available Rewards at Checkout](https://help.joy.so/on-site-content/checkout-page/available-rewards)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.joy.so/on-site-content/checkout-page/referral-at-checkout-page.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.