Documentation Index

Fetch the complete documentation index at: https://support.yotpo.com/llms.txt

Use this file to discover all available pages before exploring further.

LLM Discoverability Guide for Yotpo Loyalty & Referrals

Prev Next

Products


Loyalty & Referrals

Supported plans

All plans

eCommerce Platform

Shopify, Shopify Plus

Goals and Outcomes

A growing number of shoppers use AI assistants like ChatGPT and Gemini to research brands before making a purchase. These assistants are powered by Large Language Models (LLMs), which generate answers based on information they can find and understand on your website.

To help AI assistants provide accurate information about your loyalty program, that content needs to be accessible and easy for LLMs to interpret.

In this article, you'll learn what LLM discoverability is and how to make your loyalty program easier for AI chatbots to find, read, and interpret using Yotpo’s recommended implementation methods.

What Is LLM Discoverability?

LLM Discoverability refers to how easily AI assistants can access and understand public information about your loyalty program on your website. When customers ask questions such as:

  • How does this brand’s rewards program work?

  • Can I earn points when I buy from this brand?

  • How can I save money with this brand?

  • Are there benefits for VIP members?

  • Does this store offer referral rewards?

LLMs can generate answers based on information available on your website. The easier it is for LLMs to access and interpret your loyalty program content, the more likely they are to provide accurate responses in conversational queries.

AI search engines and assistants rely on well-structured, machine-readable content within a page source when generating answers. Through the solutions we recommend below, you can make key loyalty program information available in formats that LLMs can easily access and interpret.

Note

Currently, LLMs can only surface public loyalty program information available to non-logged-in visitors. Information shown only to logged-in members, such as points balances and current tier, is not exposed.

These improvements are designed to help AI assistants better understand your loyalty program today while preparing your store for emerging AI shopping experiences and agentic commerce capabilities in the future.

Ways to Improve Loyalty Program Discoverability

Yotpo recommends the following solutions for improving the discoverability of your loyalty program:

1. Add a Loyalty Program FAQ

Adding FAQ collapsible section on Horizon

Creating a dedicated FAQ section or page helps LLMs understand your loyalty program and surface accurate answers about rewards, points, tiers, and referrals.

We recommend adding a structured FAQ section to your:

  • Rewards page

  • Product pages

  • Loyalty program landing page

  • Or other relevant customer-facing pages

Example FAQ

It’s important that your FAQ content includes concise, self-contained answers with details about your specific loyalty program configuration. Make sure to include all rewards, tiers, ways to earn, redemption options, and other details you want LLMs to surface.

For detailed instructions on how to add the section to your Shopify theme, as well as best FAQ practices, see Adding a Loyalty Program FAQ to Improve LLM Discoverability.

2. Make Your Rewards Page & Loyalty Widgets AI-Readable

Another way to improve LLM discoverability is to publish your Rewards Page or standalone loyalty widgets in a machine-readable format.

These enhancements make your loyalty program content easier for LLMs to access and understand. When supported implementation methods are used, Yotpo automatically generates the required Shopify metafields from your published Rewards Page. This allows AI assistants to reference the same up-to-date loyalty information shown to your shoppers without requiring you to create or manage metafields yourself.

Shopify 2.0 Themes

adding an Instance ID to app block

For Shopify Online Store 2.0 themes, publish your Rewards Page using the Rewards Page Widgets app block and your widget Instance ID. This is the recommended implementation, which automatically includes Yotpo's machine-readable enhancements. No additional setup is required. See the step-by-step instructions on adding the app block.

The app block is available for the Rewards Page Builder and can only be added to the Rewards page in your Shopify theme. To publish standalone loyalty widgets elsewhere in your storefront, use the Custom Liquid implementation.

Tip

Use the Rewards Page Widgets app block settings if you want to show/hide it for specific locales.

Locale settings in the Rewards Page Widgets app block

Custom Theme Implementations

If your storefront requires additional customizations, you can publish loyalty widgets using Custom Liquid and the complete widget code snippet. See how to implement it here.

Like the Rewards Page Widgets app block, the Custom Liquid implementation also supports Yotpo's machine-readable enhancements.

Legacy Themes

If you’re using a legacy Shopify theme, you can still enable Yotpo’s machine-readable enhancements by publishing your Rewards Page through a Liquid page template.

To do this:

  1. Copy your Rewards Page Instance ID from your Yotpo admin.

  2. In your Shopify theme, create a reusable Liquid snippet (Online Store > Edit code > Snippets > e.g., yotpo-loyalty-widget.liquid).

  3. Create a page template of type page (Online Store > Edit code > Templates) and insert your Instance ID into the template.

  4. Assign the custom page template to your Rewards page.


Note

  • If your loyalty widgets are currently published using another implementation method, such as manually added HTML code, you need to remove the existing implementation before publishing widgets using the Rewards Page Widgets app block or Custom Liquid. Running multiple implementations simultaneously may result in duplicate widgets appearing in your store.

  • Widgets published using the HTML implementation don't support Yotpo's machine-readable enhancements as Shopify metafields aren’t generated with this method. To enable them, switch to the app block or Custom Liquid.