Promotions & coupons

Updated Jun 3, 2026 Promotions & Growth

Promotions are how you run discounts in TitanCart — from a quiet “10% off everything this weekend” that applies on its own, to a printed SAVE15 coupon a customer types in at the cart. One screen, Growth → Promotions, drives both. A promotion is simply a rule: conditions that decide when it applies, and a bonus that says what the customer gets. It’s built into TitanCart with nothing extra to install.

Note: A coupon code is not a separate thing from a promotion — it’s a code attached to one. You build the discount as a promotion (the conditions, the bonus, the dates), then, if you want it to require a code, you add one or more coupon codes to it. That’s why there’s no separate “Coupons” menu: codes live inside each promotion. For other ways to discount — buy-together sets and quantity tiers — see Product Bundles and Wholesale & bulk pricing.

1. Where promotions live

Open Growth → Promotions. The list shows every promotion with its Type, Status (Active or Disabled), Uses (how many times it’s been redeemed), whether it requires a Coupon, and its Expires date. Use + New Promotion to create one, or click any row to edit it. Each row also has quick Disable / Enable and Del actions.

Tip: When you create a new promotion you start on the General tab. The Conditions, Bonuses and Coupons tabs only appear after you’ve saved the promotion once — so fill in the name and details, click Create Promotion, and the rest of the tabs unlock.

2. Automatic vs. coupon promotions

Every promotion is one of two kinds, set by a single checkbox on the General tab:

Automatic — leave “Requires coupon code” unticked. The promotion is checked against every cart and applies on its own whenever its conditions are met. No code needed. This is how you run a site-wide sale or a “spend $100, get free shipping” offer.
Coupon-required — tick “Requires coupon code”. Now the discount only applies when the shopper enters a matching code at the cart. You add the codes on the Coupons tab (see section 5).

3. Setting the conditions

On the Conditions tab you build the requirements a cart must meet. All conditions must be met — they’re combined with AND logic. A promotion with no conditions always applies (handy for a blanket store-wide discount). The available conditions are:

Cart Subtotal — compare the cart’s subtotal against an amount (greater than / less than / equal to). E.g. subtotal ≥ $100.
Items in Cart — compare the total quantity of items against a count. E.g. ≥ 3 items.
Specific Products — the cart must contain at least one of the product IDs you list.
Product Categories — the cart must contain at least one item from the categories you list.
Customer Email — the promotion applies only to shoppers whose email is in the list you enter. For a logged-in customer this is their account email; for a guest it’s matched against the email they enter at checkout.

Note: The comparison operator (≥, ≤, =, and so on) applies to the Cart Subtotal and Items in Cart conditions. For Specific Products and Product Categories, the test is simply “the cart contains at least one of these” — the operator there doesn’t change the result. Enter product or category IDs as a comma-separated list.

Tip: With a Customer Email condition, a logged-in customer sees the discount throughout, because their account email is known the whole time. A guest’s email isn’t known until checkout, so an email-targeted discount won’t show in a guest’s cart preview — it’s applied once they enter a matching email at checkout. If you want the discount visible from the cart for everyone you’re targeting, use a coupon-required promotion and give those people the code instead.

4. Choosing the bonus

The Bonuses tab is the reward — what actually happens when the conditions pass. Pick one or more:

Cart Discount (%) — a percentage off the cart subtotal.
Cart Discount (Fixed $) — a flat amount off the cart.
Product Discount (%) — a percentage off specific products (list their IDs); leave the list empty to discount every item.
Free Shipping — waives the shipping cost at checkout.

You can add more than one bonus to a single promotion and they add together — for example “10% off the cart and free shipping.” The combined discount can never push a cart below zero; it’s capped at the subtotal.

5. Coupon codes

If a promotion requires a code, open its Coupons tab to manage the codes. You have two ways to create them:

Add a single code — type the code (for example SAVE15) and save it. Codes are stored in upper case and matched case-insensitively, so save15 and SAVE15 are the same code.
Bulk generate — produce many unique codes at once. Choose how many and an optional prefix (e.g. XMAS-), and TitanCart creates that many random one-time codes — ideal for a mailing list or an influencer drop where every recipient gets a different code.

Each code can carry its own usage limit and expiry date, separate from the promotion’s own limits and dates. So one promotion can have a permanent SAVE10 alongside a batch of single-use giveaway codes that expire next month.

Customers redeem a code in the “Enter promo code” field on the cart page. When it’s valid, the discount shows on the cart as a Discount line with the code in brackets, and they can remove it again.

6. Stacking, priority & usage limits

More than one automatic promotion can apply to the same cart — their discounts simply add up. Two controls on the General tab let you shape that:

Priority — promotions are evaluated lowest-number-first. Lower priority = applied earlier.
“Stop other promotions if this one matches” — when a promotion with this ticked applies, TitanCart stops checking the remaining (lower-priority) promotions. Use it for an exclusive offer that shouldn’t combine with anything else.

To cap redemptions, use:

Usage Limit (total) — the most times this promotion can ever be used across all customers. Leave blank for unlimited.
Per Customer Limit — the most times one customer can use it.
Per-code limits on the Coupons tab, for finer control over individual codes.

Note: A use is only counted once the order’s payment is confirmed, not the moment the order is placed. So an abandoned or declined order never burns a redemption, and your usage limits stay accurate.

What promotions do — and don’t

Note: Promotions discount the cart — they reduce what the shopper pays at checkout. They don’t rewrite a product’s listed price on the catalog or product page (that price stays the same; the saving appears as a discount line in the cart), and they don’t change inventory. To restrict a discount to specific people, either add a Customer Email condition or use a coupon-required promotion and hand the code only to the customers you want.

Troubleshooting

I can’t see the Conditions, Bonuses or Coupons tabs. They appear only after the promotion has been saved once. Fill in the General tab and click Create Promotion first.
My promotion isn’t applying. Check it’s Active and inside its Valid From / Valid To window; that the cart actually meets every condition (they’re AND-joined); and, if it requires a code, that the customer entered a valid one. Also confirm it hasn’t hit its usage limit.
My coupon code is rejected. Confirm the code’s status is Active, it hasn’t passed its own expiry, and it hasn’t reached its per-code or per-customer usage limit. Codes are case-insensitive, so capitalisation isn’t the cause.
My email-targeted promotion doesn’t show in the cart. A guest’s email isn’t known until checkout, so a Customer Email promotion won’t appear in their cart preview — it’s applied once they enter a matching email at checkout. Logged-in customers see it from the cart. Make sure the email you listed exactly matches the one the customer uses.
Two discounts are both being applied and I only wanted one. Automatic promotions stack by design. Tick “Stop other promotions if this one matches” on the one that should be exclusive, and use Priority to control the order they’re checked in.