Gift Vouchers
A gift voucher is a special product type that, when sold, automatically generates a unique coupon code, inserts it into your PDF template and sends it to the customer as a gift that can be redeemed on a future purchase.
Path to create the product: Catalog › Products › All Products › Add Product button
Path to the templates: System › Additional Settings › Gift Card Templates
How it works
- In the administration you design one or more gift voucher PDF templates once.
- You create a product of the Gift Card type and assign it one of your templates and the coupon validity period.
- The customer buys the product in the store like any other item.
- After payment the system:
- generates a unique coupon code,
- fills it into your PDF template together with the value, date and other details,
- generates the finished PDF voucher and sends it to the customer (or the recipient).
- The recipient can redeem the code at checkout as a discount coupon until it expires.
Step 1: Creating a voucher template
Before creating the product itself you need at least one PDF template. The template decides how the printed voucher looks — its background, layout, the position of texts and the places where dynamic data is filled in automatically.
Go to System › Additional Settings › Gift Card Templates and click Create New.
Basic information
- Name (required) — an internal template name only you see (e.g. "Christmas 2026", "Simple A5", "Gold A4"). It is not shown to the customer.
- Paper Size — choose A4 or A5. The size decides the proportions of the canvas you design on.
- Orientation — Portrait or Landscape.
- Active — when on, the template appears in the dropdown for Gift Card products. Inactive templates are hidden, not deleted.
Background image
Upload a PNG or JPG image used as the background of the whole voucher (e.g. a graphic design with your logo, a frame and ornaments). We recommend an image with the same proportions as the chosen paper size (A4 = 210×297 mm, A5 = 148×210 mm), otherwise it may be cropped or stretched.
Template elements (visual designer)
The visual designer has three panels:
- Elements (left panel) — a list of draggable tokens you drag onto the canvas. When the voucher is generated, each token is replaced with the real value from the paid order.
- The drawing area (middle) — a real-size preview of the paper (e.g. "A4 Landscape — 297×210mm"). Drag the individual elements here and place them where they should be printed.
- Element Properties (right panel) — click an element on the canvas and adjust its font, size, colour and position on the right.
Available dynamic tokens
| Token | What it is replaced with |
|---|---|
code | The generated coupon code |
amount | The voucher value |
currency | The currency (e.g. €) |
product_name | The name of the product the voucher came from |
order_number | The number of the order it was bought in |
expiry_date | The voucher's expiry date |
recipient_name | The recipient's name (from the order) |
shop_name | Your store name |
shop_url | Your store URL |
date | The purchase date |
gift_message | The personal message the customer entered when buying |
Static Text | Any fixed text (e.g. "Gift voucher", "Valid until:") |
Drag a token onto the canvas, place it and adjust its style in the Element Properties panel.
When you are happy with the design, click Create Template. From then on the template is available when creating products.
Step 2: Creating a Gift Card product
Go to Catalog › Products › All Products and click Add Product. In the Product Type tab click the Gift Card card (the fourth option next to Physical Product, Digital Product and Subscription).
After choosing it, a new Gift Card Settings section appears with two fields:
- PDF Template — a dropdown with all the active templates you prepared in step 1. Choose the one you want for this product. You can, for example, have one product "Gift voucher €20" with a festive template and another "Gift voucher €50" with a luxury gold template.
- Coupon Expiry (days) — how many days after purchase the coupon code stays valid. The default is 365 days (one year). After this period the code becomes invalid automatically.
Fill in the remaining tabs (Basic, Pricing, Attributes, SEO) as for a regular product — enter the name, description, images, price, and optionally variant values (e.g. €20, €50 and €100 vouchers as variants of the same product).
Tips for the right setup
- Several values — if you want to offer vouchers in several values (€20, €50, €100), do not create three separate products. Create one product with variants and set the price of each variant. The
amountvalue in the PDF is filled in automatically from the variant that was paid. - Price = voucher value — the selling price should equal the value the customer redeems the voucher for. If you sell a voucher at a discount (e.g. a €50 voucher for €45), say so in the description to avoid disputes.
- Availability — if gift vouchers should not be delivered physically (e.g. to keep them away from parcel shipping), use the Special Handling section and shipping/payment will adapt.
Step 3: What happens after the sale
The system automatically:
- Generates a unique code after the payment is confirmed and stores it among the coupons.
- Combines the code with the template, renders the final PDF and stores it with the order.
- Sends the customer an e-mail with a link to download the PDF voucher.
- The coupon code is valid immediately and can be redeemed at checkout on the next purchase.
You can track the state of each coupon (used, unused, expired) in Engage › Marketing › Coupons.
Frequently asked questions
Can I change the voucher design after the customer has received it? No — the PDF is generated at the moment of sale and stored with the order. Changing the template only affects future orders.
Can I have different templates for different seasons? Yes. Create several templates (Christmas, summer, birthday) and switch them on the product depending on the season. Or create several separate products, each with a different template.
What if the customer loses the PDF? The PDF is stored with the order — the customer can download it again any time through the link in the e-mail they received.
Can the coupon be redeemed partially? That depends on your coupon settings in Engage › Marketing › Coupons.
Related topics: