---
title: "Creating Code Entry Earning Rules on Other Platforms"
slug: "code-entry-earning-rule"
tags: ["Loyalty and Referrals", "Shopify Plus", "Shopify", "Adobe Commerce (Magento)", "BigCommerce", "Salesforce Commerce Cloud", "Custom"]
updated: 2025-04-16T14:36:24Z
published: 2025-04-16T14:36:24Z
canonical: "support.yotpo.com/code-entry-earning-rule"
---

> ## 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.

# Creating Code Entry Earning Rules on Other Platforms

Products

  

Loyalty & Referrals

###### Supported plans

Premium, Enterprise

###### eCommerce Platform

BigCommerce, Salesforce Commerce Cloud, Adobe Commerce (Magento), Custom

## Goals and Outcomes

Code Entry is an [advanced earning rule](https://support.yotpo.com/v1/docs/campaigns-overview#advanced-earning-rules) that you can use to promote marketing events and offline purchases by offering a reward for entering a code. There are many ways to use this earning rule:

- Reward customers who made a purchase either through your physical store or from your affiliates, so they may also take advantage of your rewards program.
- When you want to reward your customers for participating in your marketing events and store activities.
- You can also be creative and label physical products with codes for a more exciting way of giving rewards.

This earning rule will:

- Help your store's SEO as it increases the store's online traffic, by using redeemable codes as a way to encourage your customers to go online and get rewards.
- Encourage your customers to participate in your loyalty program.

> [!NOTE]
> Is this article for me?
> 
> If you’re using Shopify or Shopify Plus, please refer to our guide on [Setting Up Code Entry Earning Rules on Shopify](https://support.yotpo.com/docs/setting-up-code-entry-earning-rules-on-shopify).

## Creating a Code Entry Earning Rule

1. From your main menu, go to **Manage Program > Earning Rules**.
2. Click on **Create earning rule**.
3. Click **Select** on **Code entry.**

### Setting up Your Code Entry Earning Rule

![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/e22e51d8-0c24-4d5a-b3aa-24c9f8862766.png?sv=2026-02-06&spr=https&st=2026-11-12T22%3A22%3A15Z&se=2026-11-12T23%3A22%3A15Z&sr=c&sp=r&sig=ZJMQV8FuUH6rHuucZ5%2B%2FSqTHoSVQxHuPPJyaS7vZwDE%3D)

Below are the descriptions of each setting found in your earning rule for your reference.

### Basic Settings

The settings shown below are options available for all of our Loyalty & Referrals plans.

<editor360-custom-block data-preprocessing="true" data-sanitizationtags="strong"><ul><li><strong>What kind of Reward - </strong>Choose the kind of reward that you wish to give to your customers. Reward either a <strong>discount coupon </strong><strong>or loyalty points,</strong> for completing the earning rule. Some fields on the setup change depending on the type of reward that you choose. If you select:</li></ul></editor360-custom-block>

**Points**

The field "**How many points?"** will appear when you choose to reward your customers with points. This is where you can enter the number of points to be given to shoppers after completing the earning rule.

![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/cd92064a-8497-4f0c-ab8f-d38870710aee.png?sv=2026-02-06&spr=https&st=2026-11-12T22%3A22%3A15Z&se=2026-11-12T23%3A22%3A15Z&sr=c&sp=r&sig=ZJMQV8FuUH6rHuucZ5%2B%2FSqTHoSVQxHuPPJyaS7vZwDE%3D)

**Coupon**

The field "**Which coupon should the customer get?"** will appear. You may then select from the dropdown which coupon to apply for the specific earning rule.

![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/c71f3428-01c9-467b-b672-027e6e936f96.png?sv=2026-02-06&spr=https&st=2026-11-12T22%3A22%3A15Z&se=2026-11-12T23%3A22%3A15Z&sr=c&sp=r&sig=ZJMQV8FuUH6rHuucZ5%2B%2FSqTHoSVQxHuPPJyaS7vZwDE%3D)

<editor360-custom-block data-preprocessing="true" data-sanitizationtags="strong"><section class="errorBox"><div class="title">Important</div><div class="content"><p>Initially, the coupon selection is at <strong>$</strong><strong>0.00 </strong>as no coupon still exists. You may refer to <a href="/v1/docs/direct-and-redeemable-coupons-overview" rel="noopener noreferrer" target="_blank">Creating a Coupon</a> article to learn how to create coupons.</p></div></section></editor360-custom-block>

- **Campaign Name -** This is the name of the earning rule as it appears on the rewards pop-up or rewards page. By default, the name is set to **"Code Entry",** you may change it according to your preference
- **Reward Text -** The text that usually appears under the title and shows the customer what they will receive if they participate in the earning rule. The Rewards Text will also be reflected in the Rewards History

Note

Please make sure that the reward text matches your chosen reward as **it will not change automatically** when you change the reward

- **Description Text -** The text that appears on the pop-up window after a customer clicks on the earning rule. It gives a brief idea of how a Code Entry reward can be earned
- **Icon -**The default icon for the code entry earning rule is an asterisk. However, you can replace it with any other [Font Awesome icon](https://en.wikipedia.org/wiki/Font_Awesome)
- **Call to Action -** This appears when your customers click on the code entry earning rule option on their Rewards Popup or Rewards Page. The call to action is a message that prompts them to complete the action to receive the reward.
- **Already Completed Message -** This message will appear once your customers click on a an earning rule that they have already completed.
- **Invalid Code Error Message -** This error message will appear on the Rewards Popup if the customer entered an incorrect or invalid code.

## Advanced Settings

Advanced settings are available only for Yotpo Loyalty & Referrals [Premium and Enterprise plans](https://loyalty-app.yotpo.com/admin/#/plans).

- **Maximum Times Completed Total -** The maximum number of participants that can complete the earning rule (e.g. if you set it to 50 only the first 50 customers to finish the earning rule will get the reward).
- **Minimum Actions Required -** The minimum number of times a user may perform this action.
- **Maximum Times Complete Per User -** The maximum number of times a single user can participate in this earning rule.
- **Restrict to VIP tiers -** This field will allow you to create an earning rule with specific rewards per [VIP Tier](/v1/docs/loyalty-referrals-vip-tiers).
- **Display On-Site?** - By default, this is toggled to "Yes", meaning that if you save this earning rule after creating/editing, it will be visible on your Rewards Page. Select "No" if you'd like to set up an earning rule that doesn't appear on your Rewards Page.
- [**Schedule Campaign**](/v1/docs/campaign-scheduling) - This will allow you to run a special promotion for a **limited period of time** or a promotion that **recurs daily, weekly, or monthly.**

### Adding Codes to Your Rule

For your customers to successfully redeem their rewards with code entry, you need to validate the codes by uploading a CSV file with the list of acceptable and valid codes of your choice.

Note

- You can upload as many codes as you'd like. There is no limitation on the number of uploaded codes
- We recommend uploading the codes in batches of 1000 per file
- Uploading a large amount of codes may take some time

To upload a CSV file:

1. Go to your Code entry earning rule card on the **Earning Rules** page, and click on the **Ellipsis** (three vertical dots).
2. Click on **Add Codes.** ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/3533c1bb-fcec-4367-ae62-51d9885ff728.png?sv=2026-02-06&spr=https&st=2026-11-12T22%3A22%3A15Z&se=2026-11-12T23%3A22%3A15Z&sr=c&sp=r&sig=ZJMQV8FuUH6rHuucZ5%2B%2FSqTHoSVQxHuPPJyaS7vZwDE%3D)
3. Click **Choose File** and select the relevant **CSV file** from your computer ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/375613d9-3457-4aa7-a641-cd21ca69128b.png?sv=2026-02-06&spr=https&st=2026-11-12T22%3A22%3A15Z&se=2026-11-12T23%3A22%3A15Z&sr=c&sp=r&sig=ZJMQV8FuUH6rHuucZ5%2B%2FSqTHoSVQxHuPPJyaS7vZwDE%3D)
4. Make sure that the correct CSV file is selected, and click on the import button. The button will show the total number of codes that were found in the file ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/36304068-2eda-432c-af53-50366e83b348.png?sv=2026-02-06&spr=https&st=2026-11-12T22%3A22%3A15Z&se=2026-11-12T23%3A22%3A15Z&sr=c&sp=r&sig=ZJMQV8FuUH6rHuucZ5%2B%2FSqTHoSVQxHuPPJyaS7vZwDE%3D)
5. You may check the number of successfully imported codes in your code entry earning rule, in the **Earning Rules** section of your admin ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/57ab5d96-725f-4438-8b8c-7aa93461ef2f.png?sv=2026-02-06&spr=https&st=2026-11-12T22%3A22%3A15Z&se=2026-11-12T23%3A22%3A15Z&sr=c&sp=r&sig=ZJMQV8FuUH6rHuucZ5%2B%2FSqTHoSVQxHuPPJyaS7vZwDE%3D)

Make sure to upload the CSV file after creating your earning rule and before giving out any codes, to prevent the **'Invalid Code'** error message from appearing upon redemption.

## What’s Next

### Add the Rule to Your Rewards Page

After setting up your Code Entry earning rule and adding codes, make sure it’s [available on your Rewards page](https://support.yotpo.com/docs/creating-a-rewards-page):

1. Go to your **Rewards page** and click **Edit**.
2. Click **Earning Points > Layout.**
3. From the dropdown, **add the Code Entry earning rule** and customize the tile to your preference.
4. **Save & Publish** the changes.

![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/rewards-page-code-entry.png?sv=2026-02-06&spr=https&st=2026-11-12T22%3A22%3A15Z&se=2026-11-12T23%3A22%3A15Z&sr=c&sp=r&sig=ZJMQV8FuUH6rHuucZ5%2B%2FSqTHoSVQxHuPPJyaS7vZwDE%3D)

### How Customers Redeem Code Entry Rewards

Customers can redeem rewards by entering their discount code on your store’s Rewards page after logging into their account.

**Redemption process:**

1. Customers visit your **Rewards page** and log in to their account.
2. They enter a **valid code** in the provided field.

![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/enter-code-here.png?sv=2026-02-06&spr=https&st=2026-11-12T22%3A22%3A15Z&se=2026-11-12T23%3A22%3A15Z&sr=c&sp=r&sig=ZJMQV8FuUH6rHuucZ5%2B%2FSqTHoSVQxHuPPJyaS7vZwDE%3D)
3. Based on the reward type:

![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/successful-code-entry.png?sv=2026-02-06&spr=https&st=2026-11-12T22%3A22%3A15Z&se=2026-11-12T23%3A22%3A15Z&sr=c&sp=r&sig=ZJMQV8FuUH6rHuucZ5%2B%2FSqTHoSVQxHuPPJyaS7vZwDE%3D)
  1. **Points-based reward** – Their points balance will update automatically.
  2. **Discount-based reward** – They can copy the discount code from their Rewards history and apply it at checkout.