Promotions

introduction the promotions feature allows you to give discounts to customers sales and discounts attract new customers, increase conversions, and drive sales chord provides a powerful rule based promotions system that allows you to grant flexible discounts to your customers in many different scenarios what is a promotion? discounts can be applied to different amounts that make up the order ‌discounts can apply to the entire order's cost discounts can apply to a line item (or a set of line items) on the order discounts can apply to the shipping charges on the order discounts can be applied using a coupon code discounts can be automatically applied to the order promotion architecture the promotions system is composed of four concepts promotion handlers are responsible for activating a promotion at the right step of the customer experience promotion rules are responsible for checking whether an order is eligible for a promotion promotion actions define the discount(s) applied to eligible orders adjustments are responsible for storing discount information single promotion code you will be able to create a promo code and share it with your customers the following sections summarize the main parts of the promotion name the name for the promotion that name is displayed to customers as an adjustment label when the promo code is applied ex if your promo code is testing123! and the name of your promotion is promotion testing, your customers will see promotion testing at checkout ensure that the promotion name is unique and has not been used in past promotions to avoid confusion description description of the promotion this description will be used/seen by internal users only to verify what the promo is about when you start entering a lot of promotion codes, it is always best practice to add as much information as to what this promo is and who can use it so that you can keep track of them in a more organized way usage limit how many times the promotion can be used before becoming inactive start and end dates optional date values for the start and end of the promotion if the start date field is left blank, the promotion will start automatically, and if the end date is left blank, the promotion will never expire per code usage limit specifies how often each code can be used before it becomes inactive always apply by default, the chord oms promo/discount only applies one promotion adjustment rule at a time if more than one promotion is eligible for a specific order, we apply the one with the discount with the highest dollar value with always apply enabled, the rule will disregard this one discount limitation, and the oms will always apply the promotion in addition to any other that the order is eligible for essentially allowing for “stacked” promotions apply to subscriptions only always apply starting from january 2024, there will be a limit of 3 active automatic promotions at any given time this measure is implemented to avoid performance issues that may arise when you have numerous automatic promotions and concurrent checkout sessions promotion category select the category that relates to your promotion think of a category as a way to determine what type of promotion your discount is the category can be defined in promotions > promotion category activation section single promotion code you will be able to create a promo code and share it with your customers multiple promo codes selecting this option will promote creating batch promo codes example promotion code this is the promo code the customers will provide at checkout do not make your promotion code too easy or too complex! discount rules section this is where you can determine what will trigger the discount that allows you to grant flexible discounts to your customers in many different scenarios promotion rules are responsible for checking whether an order is eligible for a promotion itemtotal eligible if the order total (before any adjustments) is less than or greater than a specified amount you can use this promotion rule if you wanted to provide a discount to an order total that meets a specific amount criteria for instance, if the order is greater than $300, you might want to provide a discount product eligible for specified products only you can use this promotion rule if you want to give your customer a discount if their order included specific product(s) user eligible for specified users only you can use the promotion rule to discount the specific customer(s) firstorder eligible for a customer's first order only the email address will be verified, so the user will need to be logged in userloggedin eligible for users who are logged in this promotion will only be available to logged in users oneuseperuser eligible for use one time for each user the user will need to be logged in taxon eligible for products with specified taxons taxons and taxonomies are a categorization structure created in the oms, and products can be associated with multiple taxons e g taxonomy > taxon > taxon > taxon category > home > kitchen brand > nike nthorder eligible for a customer's n th order only you can use this promotion rule if you want to give a customer a discount after a certain number of orders that the customers is placing optionvalue eligible for specified variants (product option values) only option values are associated to variants, and this promotion rule will select all variants in the cart with a particular option value, such as "storage 500gb" firstrepeatpurchasesince eligible for a customer's first repeat purchase since a specified date you can use this promotion if you want to give your customers who have not placed an order within a certain amount of time this is calculated in \<days> userrole eligible for users with the specified user role you can use this promotion if you wanted to give your influencers, ambassadors, affiliates or any social marketing programs you are using with this specific roles to create a role please refer to this guide store eligible for users who are shopping in the store you select you can use your promotion to specific sites/stores you have the discount will only apply to the one you specify here affiliate eligible for affiliates who will share their promo codes for the affiliate programs you can use this promotion after you have created an affiliate program please refer to this document create affiliate program referral used for referral program you can use this promotion after you have created a referral program please refer to this document create a referral program order contains subscription eligible for users whose orders contain a subscription, whether it is a new or existing promotion you can use this promotion to discount your customers by placing a subscription order your customers could use a promo code defined here, or you could use "apply to all orders" to have it automatically applied we will cover this in the single promotion document item count greater than eligible for users whose cart contains the item you will select greater than you can use this promotion to set up a certain amount of items your customers must have in their cart for the discount to apply subscription interval greater eligible for users whose subscription interval length is greater than you can use this promotion to set a certain interval unit your customers must have in their subscription for the discount to apply this is defined in days, weeks, months, or even years for instance, if the subscription is greater than 2 months, the discount would apply customer has subscription with tags eligible when a customer has a subscription and the subscription has tags order has subscription with tags eligible when the order is a subscription and that subscription has tags subscription creation order apply only to orders that will create a new subscription subscription installment order apply only to orders that are an installment of a subscription before using your promotion, please refer to these api documents below to help you understand tags and how to set them up adding tags to subscription orders adding tags to order dynamic promotions eligible when there is a dynamic promotion tag associated with an order line item this adds the ability to associate a promotion to a line item “on the fly,” e g , an individualized "last chance" promotion advert create a promotion in the admin ui with associated “dynamic promotion codes ” associate the dynamic promotion code via the api when adding the line item to the cart oms api documentation with an example request body forpostcheckout cross sell eligible only during the cross sell phase after checkout is completed a checkbox on the discount calculator defines if it will apply to the quantity cross sold post checkout variants(s) eligible for products' variants only you can use this promotion to give your customers a discount based on variants in their cart a variant can be a size small and color green of a t shirt (t short being the product) at least one = one of the variants you selected must be in the customer's cart all = all of the variants you selected must be in the customer's cart none = none of the variants you selected must be in the customer's cart at least two = two of the variants you selected must be in the customer's cart at least three = three of the variants you selected must be in the customer's cart orderincountry eligible to all countries that are active in your store you can use this promotion to give your customer a specific discount based on a specific country you would need to be set up for localization please refer to this document document subscription creation order eligible for users who are creating a new subscription at checkout this promotion will only work for new subscriptions subscription installment order eligible for users whose subscription has installments match policy by default, all promotions have a match policy value of all , meaning that all promotion rules must be met before the promotion is eligible however, this can be changed to any if you wanted to create a promotion to ensure that your customers have either $100 worth of products in their cart or 2 specific products, you would want to use match any of these rules adjustment type promotion actions define the discount(s) to be applied to eligible orders create per line item adjustments creates an adjustment for each applicable line item in the current order create per quantity adjustments creates per quantity adjustments for example, you could create an action that discounts customers on each group of three t shirts they order at once add free item(s) when selected, an item of your choice is added to the order variant/item will be selected after you click add freeshipping this creates an adjustment that negates all shipping charges if you have any questions or need help, please reach out to us at help\@chord co