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

# Promotions and vouchers in checkout

This extension allows customers to redeem discounts, while giving merchants full control over visibility. The key benefits are:

* Customers can apply discounts easily, reducing friction in checkout
* The retailer can choose to display offers to everyone or only logged-in users
* Management and smart targeting of promotions can be done  directly in Engage

<Frame>
  <img src="https://mintcdn.com/voyado-partners/udFIduGtQ0zV1daN/images/shopify/shopify-checkout-01.png?fit=max&auto=format&n=udFIduGtQ0zV1daN&q=85&s=43eb37974b67775014b39cf6085113a4" alt="shopify-checkout-01" width="1660" height="1273" data-path="images/shopify/shopify-checkout-01.png" />
</Frame>

This guide explains enabling and configuring the **Loyalty Checkout** extension to display promotions and reward vouchers at checkout, enabling a smooth redemption experience for the customer.

## Limitations and requirements

1. **Shopify Plus** is required since Checkout UI extensions are not available for standard plans
2. You must enable either **Promotion sync** or **Voucher sync** (or both) in the Voyado Engage app settings. If neither is enabled, the extension will not sync or display anything at checkout
3. Promotions are **language-specific** and must be created per language in Engage and assigned to matching customer segments
4. Only **Engage-linked promotions and vouchers** are supported — Shopify-native discounts that aren't linked are not displayed within the app block
5. The app block UI components adhere to Shopify’s **Checkout UI component framework**

## Configuration

Follow these steps to configure Engage promotions and vouchers in your Shopify store checkout.

<Steps>
  <Step title="Add the app block">
    * Go to **Shopify Admin > Settings > Checkout > Customize Checkout**
    * In the checkout editor, add the app block **Loyalty Checkout extension** where you want it displayed. Recommended placement is just below the discount code field
  </Step>

  <Step title="Configure if customer login is required">
    Choose whether promotions/vouchers should be shown to:

    * All users (anonymous visitors)
    * Only logged-in customers

    If a customer is not logged in, they are identified when they input their email address during checkout. Then the app syncs with Engage and displays relevant promotions and vouchers.

    <Warning>
      Promotions assigned to a customer in Engage will not be synced or redeemable if the customer does not exist in Shopify. Make sure the customer profile is created in both systems.
    </Warning>
  </Step>

  <Step title="Configure label overrides (optional)">
    You can customize heading and button text labels within the app block settings.

    <Danger>
      Overriding these labels disables translation support.
    </Danger>

    Labels are auto-translated into: English (en), Swedish (sv), Spanish (es), Norwegian (nb), Italian (it), Greek (el), German (de), Arabic (ar), Portuguese (pt), Hungarian (hu), Danish (da), Dutch (nl), French (fr), Bosnian (bs), Malaysian (ms), Indonesian (id), Finnish (fi), Mandarin (zh).

    * **Your offers** (can be overridden)
    * **Apply** (can be overridden)
    * **Applied** (can be overridden)
    * **Show**
    * **Hide**
    * **\[Amount] off your order**
    * **\[Currency code] will be converted to your currency**
  </Step>

  <Step title="Manage display via general app settings">
    * **Enable Promotion Sync** to show promotions managed via Engage.
    * **Enable Voucher Sync** to display reward vouchers.
    * **Enable Both:** Show both promotions and vouchers.
    * **Disable Both:** Nothing will be shown at checkout.

    <Warning>
      Vouchers will be shown in the group currency defined in the general app settings, which should match your default Shopify store currency.
    </Warning>
  </Step>

  <Step title="Create campaigns in Engage">
    Now set up and manage promotions or reward vouchers directly in Engage. Make sure they’re assigned to the appropriate customer segments and linked to the correct language (if multilingual).
  </Step>
</Steps>