> For the complete documentation index, see [llms.txt](https://docs.perkville.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perkville.com/features/referrals/configuring-your-referral-program/referral-offer.md). # Referral offer A referral offer is the incentive your customers can share with friends. Once your referral earning activity is configured, you can create and customize the offer that referred prospects will see and claim. ## Creating a referral offer From your business dashboard, go to **Reward Program** in the left navigation menu. Scroll to **Earning Activities** and click the **“+”** icon next to **Create New Referral Offer** in the Referral section. You must have an active referral earning activity before you can create a referral offer. {% hint style="info" %} We recommend creating referral offers that are better than what a regular prospect can get online or by walking into your location. This helps customers feel like they are giving their friends access to something special. {% endhint %} Referral offers can be limited to specific locations, which lets you run different offers across different branches. ## Referral offer fields ### Title Give the offer a clear name, such as **Free Week Pass** or **20% Off Any Purchase**. ### Image Choose one of the provided images or upload your own. Uploaded images should be JPEG files with minimum dimensions of **620 × 368 pixels**. ### Promotion details Describe what the referred prospect will receive and any important details about the product or service covered by the offer. ### Fine print Add exclusions, limitations, expiration information, or other conditions the referred prospect should understand before claiming the offer. ### Agreement terms Specify any terms and conditions the referred prospect must agree to in order to claim the offer. See [Agreements](/features/settings/advanced/agreements.md) for more information about configuring and tracking agreement terms. ### Locations Choose the [locations](/features/settings/locations.md) where the offer is available so referred prospects know where they can redeem it. ### Initial voucher status Choose the initial status assigned to the voucher after the referred prospect claims the offer. ### Redemption instructions Explain how the referred prospect should redeem the voucher. Clear instructions can reduce confusion and make the redemption experience smoother. ### SEO title The SEO title appears in search results and social media previews and helps search engines, users, and assistive technologies understand the offer. It defaults to the referral offer title. ### SEO description The SEO description provides a short summary of the offer in search results and social media previews. It defaults to the referral offer details. ## Referral offer claim options Additional settings under **Settings > Advanced > Referral offer claim options** let you control aspects of the claim experience, including: * Requiring a phone number to claim the referral offer. * Displaying the built-in marketing opt-in alert. * Customizing the message shown when someone is ineligible to claim the referral offer. * Allowing referred prospects to use their location to find the nearest participating location. See [Referral offer claim options](/features/settings/advanced/referral-offer-claim-options.md) for configuration details. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.perkville.com/features/referrals/configuring-your-referral-program/referral-offer.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.