Help · Marketing & Visibility · Coupons

Vouchers & Coupons

Create discount codes with rules, sell and send gift certificates, manage customer balances, and automatically assign codes. Here’s the most common question: Why won’t the store accept a gift certificate?

At a Glance

  • Coupons (discount codes): under Products → Gift Cards & Coupons → Coupon Admin. Fixed value, percentage, or free shipping, with expiration dates, quantity limits, and restrictions.
  • Voucher Cards and Credit Balances: under Products → Vouchers & Coupons → Voucher Admin. Sell, activate, and send vouchers.
  • Settings: under Settings → Checkout → Gift Certificates & Coupons and Settings → Checkout → Summary (the “Coupon” and “Gift Certificate” modules).
  • Redeeming: In the shopping cart, for logged-in users only; one coupon per order. The store automatically applies credit balances.
  • Net or gross: Coupon value and minimum order value are calculated net as long as the “Gross Amount” toggle is off.

In this guide


What is the difference between coupons and gift cards?

The store uses two separate systems. A coupon is a discount on an order. A gift card is money that is credited to the customer’s account.

Coupons (Discount Codes)

Codes with rules, managed in the coupon admin

Typical uses:
Promotional discounts, newsletter welcome discounts, partner and influencer codes, free shipping
  • The customer enters a code in the shopping cart.
  • Fixed amount, percentage, or free shipping.
  • Can be restricted to products, categories, manufacturers, and customer groups; individual items can be excluded.
  • Total quantity and quantity per customer, validity period, minimum order value.
  • One coupon per order.

Vouchers (customer credit)

Credits in the customer account, managed in the voucher admin

Typical uses:
Gift certificates, welcome credits, goodwill gestures and refunds, cashback
  • Each customer account has a credit account with a balance and a transaction history.
  • Credited via gift certificate codes, purchased gift certificate items (item number begins with GIFT), registration, credit adjustments, or manually.
  • Purchased gift certificates can be set to require approval upon request.
  • The store applies the credit toward the next order, up to the total order amount.
  • Sent via email with a redemption link; using the marketing tool, it can also be sent as a PDF with a custom design (real-world example).
  • Bonus points can be converted into store credit (Guide to Bonus Points & Free Products).

Create & Manage Coupons

Under Products → Gift Cards & Coupons → Coupon Admin, you can create discount codes and keep track of them.

By default, the list shows only active coupons. Use “Status” to switch to “Inactive (Deleted) Coupons” or “All Coupons.” The live search finds the coupon name, description, and code. The “Redeemed” column counts the orders using this coupon. Using the action menu for a row, you can access “Edit,” “Send,” “Report,” “Copy,” and “Delete.” Gift certificates are not listed here but in the Gift Certificate Admin.

Coupon Admin with live search and "All Coupons" status: six coupons showing coupon value (one marked "gross"), minimum order value, quantity, redeemed, partner, validity, coupon code, and status; The action menu for coupon HERBST10 is open with Send, Report, Copy, and Delete

The Coupon Admin with all coupons: The “Redeemed” column counts the number of redemptions; the action menu provides access to Send, Report, Copy, and Delete. Click to enlarge.

Coupon Types

TypeHow to Create ThemExample
Fixed ValueEnter a number in the “Coupon Value” field, e.g., 10. Net or use “Gross Amount” as an exact gross deduction.€10.00 off the order
PercentageNumber with a percent sign, e.g., 15%. The store recognizes the type based on the percent sign.15% off all eligible items
Free shippingToggle the “Free Shipping” switch and enter 0 as the coupon value. A coupon value greater than 0 will additionally deduct this fixed amount.Free Shipping Promotion
Percentage discounts and free shipping cannot be combined in a single coupon. When “Free Shipping” is enabled, the coupon value always counts as a fixed amount; 15% becomes a €15 deduction.

Create a Coupon – Step by Step

In Coupon Admin, click the “Insert” tab.

Basic Information

  • Coupon name and description for each language. The name in the default language is required; the store automatically fills in empty language fields with the default language.
  • Status: active or inactive.
  • Coupon Value: 10 for a fixed value, 15% for a percentage.
  • Gross Amount: Only for fixed values. When enabled, every customer receives exactly the entered amount as a discount, regardless of their tax jurisdiction (€10.00 at 19% in Germany as well as at 20% in Austria). When disabled (default), the net value applies, and the customer’s sales tax is added. For percentage coupons, the form hides the toggle.
  • Free Shipping: Waives shipping costs in addition to the coupon value.
  • Minimum Order Value for Coupon: The merchandise value at which the coupon takes effect—net, or gross if “Gross Amount” is selected. See “Net or Gross?” for details.
  • Coupon code: Enter your own code or leave it blank. If left blank, the store generates a random code with a length based on “Coupon/Voucher Code Length” (default 8 characters). A code may appear only once among the active coupons.

Validity Period & Quantities

  • Coupon (Valid From): Redeemable starting at 12:00 a.m. on this day. New coupons are pre-filled with today’s date; if left blank, the coupon is valid immediately.
  • Coupon (Valid until): Redeemable through and including this day. If left blank, the coupon is valid indefinitely but will automatically become inactive after three years (see “Deactivate and Extend”).
  • Coupon Quantity (Total): The total number of times the coupon may be redeemed. If left blank or set to 0, it is unlimited.
  • Coupon Limit (Customer): How many times per customer account. New coupons are set to 1; 0 means unlimited.
  • A completed order in which the coupon resulted in a discount counts as a redemption. A code that is only in the shopping cart does not count.

Select dates using the calendar or enter them in full (DD.MM.YYYY). If the form cannot read a date, it will save it as empty—in which case the coupon will have no limit.

"Insert" tab with the upper part of the coupon form: Coupon name "Fall Promotion 10 €," description, status: active, coupon value: 10, gross amount: yes, Free Shipping: No, Minimum Order Value for Coupon: 50, Coupon Code: HERBST10, Coupon Quantity (Total): 500, Coupon Quantity (Customer): 1, and Customer Groups: “All”

A new coupon for 10 € (gross amount) on orders of 50 € or more, redeemable once per customer. Click to enlarge.

Restrictions

For whom and for which items

  • Customer groups: “All” or “Selection” with a toggle switch for each customer group.
  • Product coupons: The coupon applies only to these items. Select them via “Add Products” or enter product IDs separated by commas. The product list takes precedence: If it is filled out, manufacturers and categories do not apply, and the form hides them. For variants, only the selected variant applies.
  • Excluded products: These items never receive a discount from the coupon, in addition to all other restrictions. An excluded master item includes all its variants. from 4.9.59
  • Manufacturer coupons: Only items from the selected manufacturers.
  • Category coupons: Selected categories, with subcategories if desired. The “List Type” determines how the selection works (see table below). Only active categories count.
  • If both categories and manufacturers are specified, an item must meet both criteria.
  • Gift items (item numbers starting with GIFT) never receive a coupon discount.
List TypeEffect on the selected categories
WhitelistDiscount applies only to items in one of the selected categories.
BlacklistNo discount for items in the selected categories—unless the item is also in another, unselected category. from 4.9.59
Blacklist (strict)No discount if the item is in any of the selected categories.
Lower section of the ERIKA15 partner coupon form: Product coupons empty, Excluded products with a count of 2, Manufacturer selection, Category coupons with the “Advertising Technology” category, List type “Blacklist (strict),” Affiliate partner Erika Musterfrau, valid from September 1, 2026, through December 31, 2026

The restrictions of a partner coupon: two excluded items, one category set to “Blacklist (strict),” and the assigned affiliate partner. Click to enlarge.

Link Affiliate Partners

Coupons can be linked to one or more affiliate partners. If a customer redeems such a coupon, the store assigns the order to the partner. The partner receives their commission without needing their own affiliate link.

Assign in the Coupon

In the coupon form, select as many partners as you like under “Affiliate Partners.” You can view and manage this assignment under Customers → Customers at the Partner in the “Affiliate Program” tab → “Assigned Coupons.” When copying a coupon, the partners are not carried over.

Behavior in Case of Conflict

If a customer arrives via a partner link (?ref=) and redeems another partner’s coupon, the setting under Settings → SEO / SEA → Affiliate Program → “Coupon: Affiliate Behavior in Case of Conflict” determines the outcome :

  • replace (default): The coupon partner replaces the previous one; exactly one partner receives a commission.
  • add: Both partners receive a commission.
  • keep: The coupon affiliate only counts if no affiliate has been assigned yet.

A subsequent affiliate link no longer overrides the coupon affiliate under “replace ” and “keep.” A coupon without a discount does not count toward the assignment. from 4.9.128

Tip: The commission amount is based on your settings in the affiliate program. A customer can never credit themselves as an affiliate using a coupon.

Send Coupons via Email

In the coupon’s actions menu, “Send” opens the email form. As recipients, you can select a single customer (search), “all customers,” “to all newsletter subscribers,” or a “recipient list” with email addresses separated by commas. You’ll also need to enter the sender, subject, and message. All recipients receive the same coupon code.

Email marketing is generally permitted only with consent (§ 7 UWG). The “All Customers” option does not verify consent. For promotions, use “To All Newsletter Subscribers.”

Generate Many One-Time Codes

For flyers, partners, or contests, you often need many codes, each of which is valid only once. To do this, copy a coupon:

  1. Create a coupon as a template: set the coupon value, validity period, restrictions, and “Coupon Quantity (Total)” to 1.
  2. Click “Copy” in the promotion menu of the template.
  3. Enter “Coupon Count: From (Start)” and “To (End),” e.g., 1 to 100 for 100 copies. Each copy receives its own random code; the store appends the sequential number to the coupon name.
  4. After copying, click “Download File” in the success message. The CSV file contains all the new codes. It can only be downloaded once—save it immediately.

Each copy inherits all settings and the status of the template, but not any affiliate partners. The template itself remains as a redeemable coupon; deactivate it if necessary.

"Copy Coupon" dialog box for coupon FLYER5, featuring a tooltip and the fields "Coupon Count: From (Start)" 1 and "To (End)" 50; below that, the messages displayed after copying, along with the "Download File" link

The FLYER5 template generates 50 copies, each with its own code; the CSV file containing the codes can be downloaded via the “Download File” link. Click to enlarge.

Analyze Redemptions

The “Report” menu item in the Promotions menu lists every redemption of the coupon:

  • Customer name, customer number, and order number, with links to the order and customer account
  • Order status, total value, net value of the products, and net value minus the coupon
  • Redemption date
  • Filter by order status and “Export (CSV)”

Coupons that you post retroactively in the order editor do not appear in the report. To keep a running log of all redemptions, enter a filename under Settings → Checkout → Gift Certificates & Coupons → “Coupon Log Filename”; the store will save the file to the “files” folder.

Report for the “Fall Promotion 10 €” coupon, including an order status filter, an “Export (CSV)” button, and three redemptions showing customer name, customer number, order number, order status, total value, net values, and redemption date

The report shows each redemption along with the order, order status, values, and redemption date. Click to enlarge.

Deactivating, Deleting, and Extending Coupons

Manually

  • Deactivate: Use the status toggle in the list or in the form.
  • Delete: This only sets the coupon to inactive. It remains under “Inactive (Deleted) Coupons” along with the report and can be reactivated.
  • Extend: Set “Status” to “All Coupons,” edit the coupon, enter the new date in “Coupon (Valid Until),” enable the status, and save.

Automatically

  • When logging into the backend, the store deactivates coupons and promo codes whose “Valid until” date has passed.
  • The same applies to codes without an expiration date that are more than three years old.
  • Voucher cards become inactive upon redemption because their value is then credited to the account balance.
  • A marketing event can enable or disable a coupon using the “Set Coupon Status” action.
If the coupon is inactive for newsletters or new registrations, the store will no longer send out a code—without an error message. Check these coupons regularly.

Gift Certificates (Customer Credit)

Under Products → Gift Certificates & Coupons → Gift Certificate Admin, you can activate purchased gift certificates, send value-based gift certificates, and view all codes that have been sent.

Selling Gift Certificates in the Store

01

Create a gift certificate item

Create an item whose item number begins with GIFT in uppercase letters, e.g., GIFT-50. This is how the store recognizes the gift certificate. To offer multiple values, create multiple items. The customer receives the item’s price, including tax, as store credit (setting: “Gift Certificate/Store Credit Includes Tax at Purchase”).

02

Customer purchases the gift certificate

Like any other item, the gift certificate is placed in the shopping cart. Coupons do not apply a discount to gift certificate items, and they do not count toward a coupon’s minimum order value.

03

Redeem the gift card

If the “Gift Certificate Queue” is enabled (default), every purchased gift certificate appears in the “Purchased Gift Certificates” tab. In the promotions menu , “Apply Credit” credits the value to the buyer’s credit account and notifies them via email; this is only possible for orders placed with a customer account. “Create Gift Certificate” generates a code and sends it to the buyer along with a redemption link; for orders without a customer account, it is sent to the email address associated with the order (email template “Release Gift Certificate”), with a personalized free-text message if desired. Do not approve the order until payment has been received.

04

Redeeming a Gift Certificate

The recipient opens the link in the email (logging in to do so) or enters the code in the shopping cart. The full value is credited to their account balance, and the code is then invalidated. The store applies the credit toward the next order.

Voucher Admin, “Purchase Vouchers” tab with the “Unredeemed Vouchers” filter and two purchased vouchers; the action menu displays “View Customer Account,” “Apply Credit,” and “Create Voucher”; below that, the “Create Gift Certificate” dialog box with the “Personal Free Text (optional)” field

You can release purchased gift cards in the “Purchased Gift Cards” tab, either as store credit or as a gift card code with a custom message. Click to enlarge.

Automate Redemption

A marketing event with the action “Order: Redeem/Create/Send Gift Certificate” automatically redeems purchased gift certificates, optionally with a PDF attachment featuring your own design. The practical example in the Marketing & Automation Guide shows how this works.

Without a Queue

If you disable “Voucher Queue” under Settings → Checkout → Summary → Voucher, the store will credit the voucher value to the buyer’s account balance as soon as the order is completed—even if payment is still pending, such as with prepayment. No email is sent in this case.

Whether sales tax is charged on a voucher at the time of sale depends on whether it is a single-purpose or multi-purpose voucher (Section 3, Paragraphs 13–15 of the German Value-Added Tax Act (UStG)). Consult your tax advisor to determine the tax classification of the voucher item.

Sending Gift Certificates Manually

In the “Send Gift Certificate” tab, you can send gift certificates without an order, for example as a gesture of goodwill or as a prize:

  • Recipient: individual customer (search), “All Customers,” “To All Newsletter Subscribers,” “Customers from Customer Groups,” or “Recipient List” with email addresses.
  • Amount, sender, subject, and message.
  • Transferable amount: “Yes”—the recipient may give the credit to others. “No”—the credit remains with the recipient.

Each recipient receives their own code with a redemption link.

Tip: For a paper gift certificate or one issued at the store register, send the gift certificate along with the “Recipient List” to your own email address. The code from the email can be redeemed immediately.

Gift Card Overview

The “Gift Certificate Overview” tab displays all sent gift certificates, including the sender, recipient, value, gift certificate code, and date sent. Use “Show” to filter by “Unredeemed Gift Certificates” or “Redeemed Gift Certificates”; for redeemed certificates, the recipient field shows the customer who redeemed the code. “Delete” permanently removes the code here, including any record of its redemption.

Customers Give Away Their Credit

Customers with credit can find the “Send Gift Certificate” link in the store, including on the order confirmation. There, they can send a portion of their credit as a code to an email address (using the “Customer Gives Gift Certificate” email template). Only transferable credit can be gifted; the portion marked “cannot be sent” remains with the customer.


Credit Account: Balance and Origin

Every transaction on a customer’s credit balance is recorded with the date, amount, and source—for you in the backend and for the customer in the store.

In the backend

  • Customers → Customers → Edit Customer → “Credit Account” tab : current balance and all transactions, e.g., “Code Redemption,” “Order,” “Cancellation Credit,” “Bonus Credit,” or “Queue Release.” The tab appears as soon as there is a balance or any transactions.
  • You can change the credit balance in the “Customer Data” tab in the “Customer Credit” and “Of which non-shippable” fields . The change appears as an “Admin Correction” and, to the customer, as a “Correction by Customer Service.”

In the Store

  • The customer can view their balance and all transactions under My Account → Credit Account.
  • In the shopping cart, the message “Your credit of … will be applied as much as possible” appears. By selecting “Do not apply credit,” the customer can save it for later.
The customer can view comments on transactions in their credit account. Do not include any internal notes there.

How do I automatically issue coupons and credit?

Coupons and credit can be issued during marketing events, upon newsletter sign-up, during registration, and after every order.

Marketing Automation (xoMarketing)

A marketing event under CMS → Emails & Marketing / Automations can generate a unique coupon for each affected customer.

Here’s how to set it up:

  1. Create a marketing event, e.g., “First Purchase,” “Birthday,” or “30 Days Without an Order.”
  2. Select “Create Coupon” as the action and fill in the details:
    • Coupon type: fixed amount, percentage, or free shipping
    • Coupon value and amount type: Net amount (default) or Gross amount
    • Minimum order value
    • Coupon (Valid Until): fixed date or “Coupon (Valid Until: Automatic)” relative to the day the coupon is created
  3. As a follow-up action, send an email with the placeholders below.
PlaceholdersContent
{marketing_created_coupon_code}The generated coupon code
{marketing_created_coupon_amount}Coupon value as a number
{marketing_created_coupon_minimum_order}Minimum order value
{marketing_created_coupon_expire_date}Coupon expiration date

Each customer receives their own code. Each code can be redeemed exactly once, but is not tied to the customer. The condition “Marketing: Unredeemed coupon from event is about to expire” sends reminders about codes shortly before they expire. Learn more in the Marketing & Automation Guide.

Newsletter sign-up

  1. Create a coupon in Coupon Admin, e.g., NEWSLETTER10, with “Coupon Quantity (Customer)” set to 1.
  2. Under Settings → Checkout → Vouchers & Coupons → select “Newsletter Coupon.”

The store sends the code using the email template “Newsletter Sign-up Coupon” (placeholder {coupon_code}). With double opt-in, the code is sent only after confirmation. All subscribers receive the same code. The coupon must be active; otherwise, no email will be sent.

New Registration

Under Settings → Checkout → Gift Certificates & Coupons, only for customers who create an account:

  • “Voucher for New Customer Registration”: Amount without currency symbol. The customer receives a personal voucher code in the welcome email.
  • “Coupon upon New Customer Registration”: a coupon from the coupon admin; its code is included in the welcome email (placeholder {coupon_text} in the “Confirmation upon Customer Registration” template).
  • “Apply New Customer Coupon/Voucher Immediately”: Selecting “Yes” posts the voucher amount directly as non-transferable credit and activates the coupon immediately in the shopping cart.

Use only one of these two options; otherwise, the customer will receive both a gift certificate and a coupon.

Credit (Credit After Each Order)

With “Credit” under Settings → Checkout → Gift Cards & Coupons, customers receive credit for their next purchase with every order:

  • “Credit Amount”: a fixed amount (e.g., 5) or a percentage (e.g., 5%) per customer group.
  • “Minimum Order Value for Credit”: per customer group.
  • “Credit Order Statuses”: If left blank, the credit is applied immediately upon ordering; otherwise, it is applied when the order status changes to one of the selected statuses.
  • “Credit: Calculation Basis”: without_shipping (default, product value excluding shipping) or with_shipping.
  • “Credit: Notify Customer”: Email to the customer with the amount and new credit balance (default: off).

Redemption in the Shopping Cart

This is how the customer redeems codes and how the store applies coupons and credit.

From the customer’s perspective

  1. Enter the code in the “Redeem Coupon” box in the shopping cart and click “Redeem.” The same field is available in the off-canvas shopping cart. There is no input field during the checkout steps.
  2. If the customer is not logged in, the store prompts them to log in or create a guest account. Afterward, the code is automatically redeemed. from 4.9.8
  3. Coupon: The deduction appears as a line item labeled “Coupon (CODE)” in the total. Gift card: The amount is credited to the customer’s account balance.

Good to know

  • One coupon per order: If the customer enters a second code, it replaces the first one.
  • Coupons and credit can be combined in a single order.
  • Credit balance: Applied by default (shown in the shopping cart as the “Gift Certificate” line item); can be disabled using “Do not apply credit balance.” The customer does not select a partial amount; the store applies as much as possible, and the remainder remains as credit.
  • For templates with a sidebar, there is also a “Gift Cards & Coupons” box, which is disabled by default.
A logged-in customer’s shopping cart displaying the message “Your coupon has been accepted …,” the total line “Coupon (HERBST10): -10.00 €”, the credit line -20.00 €, and the “Redeem Voucher” box with a credit note, a “Do not apply credit” button, and a code field

In the shopping cart, the coupon appears as a separate total line; the store automatically applies the store credit. Click to enlarge.

Calculation Order

By default, the store calculates the order total in this order:

Subtotal Shipping costs Coupon Taxes Credit Total

The coupon is deducted before taxes are calculated, and the store credit is deducted afterward. The order can be changed for each module under Settings → Checkout → Summary.


Coupon Not Accepted: Check for Causes

Have the message read aloud or displayed in the shopping cart. It almost always points directly to the cause.

Message in the storeCauseWhat to do
“You must log in or create an account/guest account …”The customer is not logged in. Without an account, it’s not possible to check quantities per customer.Have the customer log in or create a guest account. The code will then be redeemed automatically. from 4.9.8
“The code you entered is invalid or has already been used.”Typing error, coupon is inactive (disabled, deleted, expired, or automatically deactivated), or it’s another customer’s personal code.Search for the code in Coupon Admin under “Status” = “All Coupons.” Check the status and validity period; extend if necessary.
“This coupon code has already been redeemed…” or “This gift certificate has already been redeemed…”The code has been used. For a gift certificate, the amount has already been credited to the account of the person who redeemed it. from 4.9.47Check the report or the voucher overview to see who redeemed it.
“This voucher is not yet available.”“Coupon (valid from)” is in the future.Check the start date.
“This gift certificate is no longer valid.”“Coupon (valid until)” has passed.Extend the expiration date.
"This coupon/voucher can be used a maximum of … times."“Coupon quantity (total)” has been reached.Increase the quantity or create a new coupon.
"The gift certificate/coupon may only be redeemed … times per customer."“Coupon limit (customer)” has been reached for this customer account.Increase the quantity if desired.
"Your voucher … has been activated—but the required minimum order value (net) of … has not yet been reached."The merchandise value is below the “minimum order value for the coupon.” If no “gross amount” is specified, the net merchandise value applies.See Net or Gross? The coupon takes effect as soon as the value is reached.

“Accepted,” but no deduction

The customer sees “Your coupon has been accepted and will be applied as soon as the coupon criteria are met,” but the coupon does not appear in the total. The store checks these points only during checkout, without displaying a separate message:

  1. The customer’s customer group is not selected under “Customer Groups.”
  2. No item in the shopping cart matches product coupons, category coupons, or manufacturer coupons.
  3. All matching items are listed under “Excluded Products” or in a restricted category.
  4. The shopping cart contains only coupon items (GIFT…).
  5. A free shipping coupon with a value of 0, but shipping is free anyway.

Deduction different than expected

  • More than entered: Without a “gross amount,” sales tax is added to the coupon value (10 € results in an 11.90 € deduction at 19%).
  • Less than entered: A fixed value is limited to the value of the eligible items. A percentage applies only to eligible items; for shipping costs, it applies only if “Includes Shipping” is selected in the Coupon module.
  • On discounted items: The coupon calculates based on the price in the shopping cart, including special and tiered prices.

No input field

  • Under Settings → Checkout → Summary, both the “Coupon” and “Gift Certificate” modules are disabled.
  • Off-Canvas Shopping Cart: Settings → Design → Off-Canvas → “Off-Canvas Right: Voucher Code Input On/Off.”

Net or gross? Discount and minimum order value

The store calculates coupons internally on a net basis. The “Gross Amount” toggle determines whether the customer saves exactly the advertised amount.

Coupon over 10Customer deduction in Germany (19%)Customer deduction in Austria (20%)Minimum order value checked against
Fixed value, “Gross Amount” (default)11.90 €€12.00Net merchandise value
Fixed value, “gross amount” to10.0010.00 €Gross merchandise value
Percentage, e.g., 10%10% of the price10% of the priceNet merchandise value

What Counts Toward the Minimum Order Value

  • The value of all items in the shopping cart at their listed prices, including non-discounted and excluded items.
  • Gift items (GIFT…) do not count.
  • Shipping costs are included only if “Include Shipping Costs” is enabled in the coupon module (default is off).
  • Example: “Minimum order value for coupon” set to 50 without a “Gross amount” means 50 € net; with a 19% tax rate, this results in a gross merchandise value of 59.50 €.

Display in the order

  • “Includes Tax” in the Coupon module is set to “auto”: Customers with gross prices see the deduction as a gross amount; merchants with net prices see it as a net amount.
  • For items with different tax rates, “Automatic Tax Splitting” (default: on) splits the coupon into one line per tax rate. The lines together total the coupon value.
  • Tax-exempt customers (e.g., with a VAT ID number in another EU country) will also receive exactly the amount entered under “Gross Amount.”

Discounts Without a Code

Not every discount requires a code. These features apply automatically.

You want to…ToolWhere
Offer individual items at a lower price for a limited timeSpecial Offer: Special price per customer group with start and end datesProducts → Special Offers
A percentage discount for orders above a certain amount, for all or selected payment methods"Discount" module with the fields "Discount," "Minimum Order Value," and "Payment Methods"Settings → Checkout → Summary
Cash discount for specific payment methodsModule with “Enable Cash Discount for Payment Method” and “Payment Method”Settings → Checkout → Summary
Reward Regular Customers Based on Sales"Loyalty Discount" moduleSettings → Checkout → Summary
Grant credit after every orderCredit NoteSettings → Checkout → Gift Cards & Coupons
Earn points or receive free items based on order valueBonus Points & Free ProductsGuide to Bonus Points & Free Products

If any modules are not yet active in the summary, install them there first.


Configuration

The most important settings and where to find them in the backend.

SettingWhereEffect
Coupon upon new customer registrationSettings → Checkout → Vouchers & CouponsAmount for new customer accounts; blank = off
Coupon upon new customer registrationSettings → Checkout → Vouchers & CouponsCoupon whose code is included in the welcome email
Apply new customer coupon/gift certificate immediatelySettings → Checkout → Vouchers & CouponsYes: Credit applied directly to the account, coupon active immediately; No (default): Code sent via email
Newsletter couponSettings → Checkout → Vouchers & CouponsCoupon sent by the store after newsletter sign-up
Coupon/Voucher Code LengthSettings → Checkout → Vouchers & CouponsLength of automatically generated codes (default 8)
Coupon Log File NameSettings → Checkout → Coupons & VouchersLog file of redemptions in the " files" folder; empty = off
Refunds and associated fieldsSettings → Checkout → Gift Cards & CouponsCredit after each order (default: off)
Show couponsSettings → Checkout → Summary → CouponCoupon System On/Off (Default: On)
Includes shipping costsSettings → Checkout → Summary → CouponCoupon also applies to shipping costs; shipping counts toward the minimum order value (default: off)
Includes taxSettings → Checkout → Summary → CouponDisplay the discount as gross or net (default: auto)
Automatic tax breakdownSettings → Checkout → Summary → CouponOne coupon line per tax rate (default: on)
Show couponsSettings → Checkout → Summary → CouponCredit System On/Off (Default: On)
Voucher QueueSettings → Checkout → Summary → CouponPurchased gift certificates only after approval (default: on)
Include tax in gift card/credit balance at purchaseSettings → Checkout → Summary → Gift CertificateFor coupon items with a tax class, the value is credited including tax (default: on)
Off-Canvas (right): Voucher code entry on/offSettings → Design → Off-CanvasCode field in the off-canvas shopping cart (default: on)
Coupon: Affiliate behavior in case of conflictSettings → SEO / SEA → Affiliate Programreplace (default), add, or keep

Tips & Best Practices

Coupon or Voucher?

  • Discount promotion: Coupon with a validity period and rules.
  • Gift or goodwill gesture: Gift certificate; the credit balance remains valid.
  • Refund as store credit: Adjustment to the customer’s store credit account.
  • Partners and Flyers: Coupon with “Copy” function and CSV file; a separate coupon for each partner.

Preventing Abuse

  • “Coupon Quantity (Customer)” = 1 prevents multiple redemptions per account.
  • One-time codes with “Coupon Quantity (Total)” = 1 for publicly distributed codes.
  • A minimum order value prevents small orders placed solely to claim the discount—think in terms of net value.
  • Setan expiration date for each promotion.
  • Do not releasepurchased gift cards until payment is received.

Frequently Asked Questions

Where does the customer enter the coupon code?

In the shopping cart, in the “Redeem Coupon” box, or in the off-canvas shopping cart. There is no input field during the checkout steps. The customer must be logged in or create a guest account.

Can a customer redeem multiple coupons in a single order?

No. Only one coupon is valid per order; a new code replaces the previous one. The store also applies any remaining balance from gift certificates.

How can I find out if a code was redeemed and in which order?

Coupon: In Coupon Admin, set “Status” to “All Coupons,” enter the code in the live search, and open the “Report” row. The customer and order number are listed there. Gift Certificate: Go to Gift Certificate Admin → “Gift Certificate Overview” and select “Applied Gift Certificates”; the application to an order is shown in the customer’s credit balance.

How do I create multiple discount codes, each valid only once?

Create a coupon with “Coupon Quantity (Total)” = 1 and the desired expiration date, then duplicate it using “Copy” (from 1 to, for example, 100). You can then download the new codes as a CSV file. See the instructions under “Generate Many One-Time Codes.”

Why is a coupon suddenly inactive, and how do I extend it?

When you log in to the backend, the store deactivates expired coupons and coupons without an expiration date that are more than three years old. In the coupon admin, set “Status” to “All Coupons,” enter a new date in “Coupon (Valid Until),” and reactivate the status.

Why is a gift certificate link invalid after the first use?

When a gift certificate is redeemed, its full value is credited to the customer’s account balance. The code is then considered used; the funds remain as a credit in the customer’s account and will be applied to the next order. Starting with 4.9.47, the store also notifies the customer of this (“already redeemed”).

When does the customer receive a purchased gift certificate?

If the gift card queue is enabled, as soon as you approve it in the Gift Card Admin under “Purchase Gift Cards”—or automatically via a marketing event. Without a queue, the store credits the amount to the buyer’s account balance as soon as the order is completed.

How do I create a gift certificate without an order, e.g., for printing?

In the Gift Certificate Admin, under the “Send Gift Certificate” tab, enter the amount and select your own email address as the “Recipient List.” Print the code from the email onto the gift certificate. For discount codes, use the Coupon Admin instead, where you can define the code yourself.

Where does a customer’s credit balance come from?

This is shown in the “Credit Account” tab for the customer under Customers → Customers: Each transaction lists its origin, such as “Code Redemption,” “Queue Release” (released gift certificate), “Bonus Credit” (credit note), “Cancellation Credit,” or “Admin Correction.”

Where does the welcome voucher come from, and how do I disable it?

From “Voucher upon New Customer Registration” or “Coupon upon New Customer Registration” under Settings → Checkout → Vouchers & Coupons. Clear the field. If the code still appears, check your marketing events for the “Create Coupon” action.

How do I set up codes for influencers and track them?

Create a separate coupon with a descriptive code for each influencer and assign it under “Affiliate Partners” if you want to pay commissions. You can track success in the “Redeemed” column and the coupon’s “Report.” Copied coupons do not inherit the partner assignment.

Does a coupon also apply to items on special sale?

Yes. The coupon applies to the price in the shopping cart, including the special price. You can exclude discounted items via “Excluded Products” or through a category like “Sale” with the list type “Blacklist (strict).”

Why does the coupon appear twice in the order?

If the shopping cart contains items with different tax rates, the store splits the coupon into one line per tax rate (“Automatic Tax Splitting”). The coupon is applied only once; the lines together equal the coupon value.

The customer forgot to enter their code. What now?

In the Order Editor, you can apply a coupon or store credit retroactively. The store does not check quantities there, and the coupon does not appear in the report. See the “Editing Orders” guide for more information.

How do I set up a limited-time discount promotion for the entire product range or a specific category?

With a code: a coupon with no restrictions or with the category as a “whitelist,” plus “Coupon (valid from)” and “Coupon (valid until).” Without a code: special offers under Products → Special Offers with start and end dates for each item.

How does the loyalty discount calculate the time period?

You select the time period in the “Loyalty Discount” module under “Tiered Pricing by Time Period.” It runs on a rolling basis backward from today’s date, not by calendar months: “year” is 365 days, “quarter” is 92 days, “month” is 31 days, and “alltime” covers the entire period. The total is calculated based on all of the customer’s orders with the status selected under “Calculate Sales for Orders with Order Status….”

Further Guides