# Create Shopify coupons

> Let Releva create unique one-time discount codes in your Shopify store, with the discount, combinations and active dates you choose, and hand one to each recipient.

A Shopify coupon is a pool of unique, one-time discount codes that Releva creates in your Shopify store for you. You set the discount once; Releva creates the codes, keeps the pool topped up and hands each recipient a different code through the merge tag `{{dynamicCoupons.<name>}}`. You do not export or upload any codes. For how this differs from an uploaded list, read [How dynamic coupons work](https://releva.ai/documentation/learn/dynamic-coupons/how-dynamic-coupons-work/).

## Before you start

* Your shop runs on Shopify and is connected through the Releva app from the Shopify App Store. On other shops **Dynamic Coupons** has no **Shopify Coupons** tab: use [Upload a list of coupon codes](https://releva.ai/documentation/guides/dynamic-coupons/upload-a-list-of-coupon-codes/) instead.
* The Releva app is allowed to create discounts in Shopify. If you installed it before Shopify coupons existed, Shopify may ask you to approve the new permission first: see [Re-authorize Releva in Shopify](https://releva.ai/documentation/guides/dynamic-coupons/re-authorize-releva-in-shopify/).
* You have chosen a name. Names use only letters, numbers and underscores, must be unique in your shop, and become part of the merge tag: a coupon named `WELCOME_10` is used as `{{dynamicCoupons.WELCOME_10}}`.
* Your plan includes creating coupons. If **Create Shopify Coupon** shows a lock icon, ask your account owner to unlock it.

## Steps

1. Go to **Data Platform › Dynamic Coupons** and open the **Shopify Coupons** tab.

   If your shop has no coupons yet, the page shows **No coupons yet** instead of the tabs.

2. Select **Create Shopify Coupon**.

   The form opens under **New Shopify Coupon**.

3. Under **Coupon details**, in **Name**, enter a name with only letters, numbers and underscores. You use this name in the merge tag.

   The field is prefilled with `New_generated_coupon`. A name with a space or another character shows **Please use only letters, numbers, or underscores ( \_ )** and **Save** stays disabled.

4. Optional: in **Prefix**, enter the start that every code shares, for example `WELCOME-`.

   A prefix has up to 20 letters, numbers and hyphens. Each code is the prefix followed by 8 random letters and numbers. Without a prefix, a code is the 8 random characters only. The letters I and O and the digits 0 and 1 are never used, so codes are easy to type.

5. Under **Discount**, choose the **Discount type**: **Fixed amount**, **Percentage** or **Free shipping**, and enter the value.

   * **Percentage**: enter **Percent off**, from 0.01 to 100. The default is 10.
   * **Fixed amount**: enter **Value off** in your shop’s currency, greater than 0. The default is 10.
   * **Free shipping**: optionally enter a **Maximum shipping rate**. Leave it empty to cover any shipping rate.

6. Choose what the discount applies to.

   * For **Percentage** and **Fixed amount**, under **Applies to** select **Entire order**, **Specific products** or **Specific collections**. For products or collections, type in **Search products…** or **Search collections…** and select at least one. The list comes from your Shopify store.
   * For **Free shipping**, under **Country eligibility** select **All countries**, or **Selected countries** and choose at least one country.

7. Optional: under **Minimum purchase**, select **Require minimum purchase**, then choose **Minimum purchase amount** or **Minimum quantity of items** and enter the value.

8. Under **Combinations**, in **Can combine with**, select the other Shopify discounts a code can be used together with: **Product and collection coupons**, **Entire order coupons** and **Free shipping coupons**.

   By default none is selected, so the code cannot be combined with other discounts. **Free shipping coupons** is not offered for a free shipping coupon.

9. Under **Active dates**, choose when each code starts and ends.

   * **Activation**: **At send time** (default) makes each code valid from the moment it is sent. **On a specific date** makes the codes valid from the date and time you pick.
   * **Expiration**: **After 1 year** (default) and **After a certain number of days/hours** count from the moment a code is sent, or from the activation date if that is later. **On a specific date** ends all codes at the date and time you pick, which must be in the future and after the activation date.

10. Select **Save**.

    **Save** stays disabled while a field is invalid; the reason is shown under the field. Releva checks that it may create discounts in your Shopify store, saves the coupon and takes you back to **Shopify Coupons**.

## Check it worked

* The new coupon is at the top of the **Shopify Coupons** tab. Under its name you see a summary of the discount, for example “10% off any order”.
* Its **Status** reads **Generating** while the first codes are created, then **Live**. For a moment a new coupon also shows **Low stock: 0 left** next to **Generating**; the badge goes away once the first codes are ready. **Available/Total** grows as Releva creates codes in Shopify, in batches, until about 1,000 unused codes are ready.
* Select the coupon’s name. The **Sample codes** section lists up to 10 unused codes. In your Shopify admin, under **Discounts**, each code appears as its own discount, named after the code and limited to one use.
* In the message editors, the **Merge Tags** picker lists the coupon as **Dynamic coupon:** followed by its name written as words, once it has at least one unused code. Send yourself a test message to see a real code.

## Troubleshooting

**“Releva needs permission to create discounts” after Save.** The Releva app in Shopify does not have permission to create discounts. Select **Re-authorize Releva in Shopify** in the message, approve the permission in Shopify, then select **Save** again. See [Re-authorize Releva in Shopify](https://releva.ai/documentation/guides/dynamic-coupons/re-authorize-releva-in-shopify/).

**“Could not reach the store integration. Try again later.”** Releva could not reach your Shopify store to check the permission. Nothing was saved. Wait a few minutes and select **Save** again.

**“Coupon name must be unique!”** A coupon or uploaded list with that name already exists in your shop. Choose another name.

**“Releva needs permission to read your catalog” under Applies to.** Releva could not search your products or collections in Shopify. Select **Re-authorize Releva in Shopify** in the message and approve the app’s permissions.

**Save stays disabled.** A field shows a hint under it, for example **Select at least one product.**, **Enter a percentage from 0.01 to 100.** or **The expiration date must be after the activation date.** Fix that field.

**Status shows Error.** Hover over **Error** to read the reason. If it says the store integration must be re-authorized, follow [Re-authorize Releva in Shopify](https://releva.ai/documentation/guides/dynamic-coupons/re-authorize-releva-in-shopify/). If it says the expiration date has passed, [change the coupon](https://releva.ai/documentation/guides/dynamic-coupons/change-a-shopify-coupon/) and pick a new date.

## Next steps

* [How dynamic coupons work](https://releva.ai/documentation/learn/dynamic-coupons/how-dynamic-coupons-work/): Learn how the merge tag hands each recipient a code and how Releva keeps the pool stocked.
* [Add codes to a Shopify coupon](https://releva.ai/documentation/guides/dynamic-coupons/add-codes-to-a-shopify-coupon/): Create extra codes ahead of a send bigger than the pool.
* [Change a Shopify coupon](https://releva.ai/documentation/guides/dynamic-coupons/change-a-shopify-coupon/): Change the discount or dates later and see the history of past settings.
* [Delete a Shopify coupon](https://releva.ai/documentation/guides/dynamic-coupons/delete-a-shopify-coupon/): Remove a coupon and its unsent codes from Shopify when the offer ends.