WooCommerce PDF Product Vouchers

Overview ↑ Back to top

WooCommerce PDF Product Vouchers allows you to create and configure customizable vouchers which can be attached to simple or variable products and purchased by your customers. You can give your customers the ability to set a recipient name, email, and message to purchase these vouchers as a gift or for themselves, and allow them to choose from among a set of voucher images.

Once the purchase is made, the customer will have access to a custom-generated PDF voucher that’s attached to order emails, emailed to recipients (if set), and downloadable in the “My Account” section. These vouchers can be used in your physical location, and you can mark them as fully or partially “redeemed” in WooCommerce.

You can even couple the vouchers with the Name Your Price extension to create “set-your-own-price” certificates! Create and sell customizable product PDF vouchers for products such as tours, events, classes, lessons, or any goods or services which are purchased online and redeemed at a physical store or in person.

Working on customizations? Developers, you can find developer documentation here.

Requirements ↑ Back to top

PDF Product Vouchers has a few requirements for the plugin to function properly on your site. Please note that, if your site does not meet these requirements, you may have to contact your hosting company to have your server environment upgraded.

  • WooCommerce Version – WooCommerce versions 2.6.14 or newer are fully supported with this plugin.
  • PHP Version – PHP 5.3 to PHP 7.1 are fully supported. PHP 5.2 is not supported even though this is supported by WordPress. You can check your PHP version under WooCommerce > System Status.
  • PHP Extensions – The mbstring extension is required, and the plugin will inform you upon activation if your hosting environment does not include this.
  • Server requirements – Loopback connects (requests from your site to itself) are required to generate voucher PDFs, as the plugin must retrieve the HTML for each voucher. Your host must support this ability — see our troubleshooting section for more details.
  • SSL certificate – We highly recommend all eCommerce sites already have an SSL certificate. If your site does not have one, then you may run into issues if you try to scan QR codes with a device, as often scanning is not allowed for non-https sites by your browser.

Installation ↑ Back to top

  1. Download the extension from your WooCommerce dashboard
  2. Go to Plugins > Add New > Upload and select the ZIP file you just downloaded
  3. Click Install Now, and then Activate
  4. Click the Configure link and read the next section to learn how to setup and configure the plugin.

Setup and configuration ↑ Back to top

The basic steps involved in creating a new voucher for purchase are:

  1. Create and configure a new voucher template
  2. Mark a simple or variable product as “Has Voucher”
  3. Attach the voucher template to the product

These steps are described in detail in the following sections, and we have a video overview of creating a template you can watch as well.

Creating a voucher template ↑ Back to top

You can create a new voucher under WooCommerce > Vouchers > Voucher Templates by clicking “Add Voucher Template”.

Note that a background image is required to generate a voucher, so a default one will be set to start.
WooCommerce PDF Product Vouchers: Voucher Template List
Voucher Template List

You can upload your own background image for the voucher (png / jpg format) under the “Images” section, or use one of the plugins 6 default backgrounds, but a background must be set; the plugin will not allow you to delete an image without adding a new one first.

When you’ve got a new voucher template ready to go, you’ll be able to start customizing the basic voucher information, along with the fields that get printed on the voucher itself during the purchase process.

WooCommerce PDF Product Vouchers: Add a New Template
Add a Template

You can work through each section to drag and drop where voucher fields should go, change the font or color used, and adjust settings for certain fields.

General settings

Under the general vouchers settings section, you’ll configure some global options for the voucher.

  • Template Name – Set the name to use for this voucher template. This is only used internally for your reference.
  • Voucher Type – Choose the voucher type (for hinting at taxability and how redemptions are processed). Vouchers can be “single purpose” — redeemable on specific product(s) or service(s) — or “multi-purpose” — redeemable on any good or service (like a store gift certificate). Read more about voucher types here.
  • Allow online redemptions – Enable this if the voucher can be redeemed in your online store. For a single-purpose voucher, you’ll also need to mark some products as redeemable.
  • Font – Set the default font for the voucher fields. You can override this on a per-field basis.
  • Font Size – Set the default font size for the voucher fields. You can override this on a per-field basis.
  • Font Style – Set the default font style for the voucher fields. You can override this on a per-field basis.
  • Font Color – Set the default font color for the voucher fields. You can override this on a per-field basis.

Images

There are a few settings to help you create your voucher images. The only mandatory setting is the Primary Image, as a background is required for a voucher template.

  • Primary Image – Set the background image from the voucher. You can upload alternative images by clicking “Add New Image”.*
  • All Voucher Images – If you’ve uploaded multiple images for a voucher, use this to choose which one should be the primary or default image.
  • Image DPI – Set the DPI at which voucher fields should be printed. This should match the DPI of your background image. When you create your background images, we recommend using high resolution / 300 DPI (instead of the default 72 DPI), and setting the voucher to a corresponding level.
  • Additional Image – You can add one additional image to the voucher, which will be added as a second page to the generated PDF. This is helpful if you want to attach terms and conditions or redemption instructions. This additional image must have the same dimensions as the main voucher image(s).

*Alternative images let your customer select the background for a voucher. It’s important to note that the field placement between a primary and voucher image should be exactly the same. Alternative images only swap out the background, they do not allow you to completely adjust field placement.

Logo

This section will let you upload a print-resolution version of your logo, and place it on your voucher if desired. This is helpful to customize one of the default voucher images a bit for your store 🙂

Voucher fields

The remaining settings sections are for voucher fields, such as product name, price, or recipient. These fields can be printed on the voucher, or shown on the product page, depending on the field type.

WooCommerce PDF Product Vouchers: Edit voucher template
Edit Voucher Template
To add a field to the voucher, click the Set Position button. This will allow you to drag and drop the field, setting its size and location on the voucher template.

Once a field’s position has been set, you can click “Done” for the field, and move onto configuring field settings.

All fields will have these basic settings, and some may have additional settings.

  • Font – Set the font family for the voucher field if you want to override the general setting for the voucher.
  • Font Size – Set the font size for the voucher field if you want to override the general setting for the voucher.
  • Font Style – Set the font style for the voucher field if you want to override the general setting for the voucher.
  • Font Color – Set the font color for the voucher field if you want to override the general setting for the voucher.

Expiration date

This field has one extra setting:

  • Days to Expiration – Optional number of days after purchase until the voucher expires. Leave blank to never expire.

Purchaser Name, Recipient Name, Message, Recipient Email

These fields have additional settings after the font settings that can be configured.

  • Label – The field label to show on the product pages and customer emails
  • Max Length – The maximum number of characters the customer can enter for the field (not applicable to “recipient email”)
  • Enabled – Displays this field on the product page as part of the purchasing process to buy a voucher.
  • Required – Requires this field in order to add a voucher to the cart.

Barcode settings

Adding a barcode field to your voucher template will generate a barcode in the PDF voucher, which can then be scanned. The plugin supports scanning QR codes for quick redemption, though other barcode types can be printed on the voucher if required.

WooCommerce PDF Product Vouchers barcode settings

  • Barcode type – The type of barcode to generate and print on the voucher.
  • Background color – The background color for the barcode section.
  • Foreground color – The generated barcode color. Black is recommended for most scanners.

When generated, the barcode will be available on the voucher PDF:

WooCommerce PDF Product Vouchers QR code example
QR code example

Template video example ↑ Back to top

Here’s a video example of creating a new voucher template:

Email settings ↑ Back to top

You can also customize voucher recipient emails if desired. You can find these settings under WooCommerce > Settings > Emails where all store emails are listed. Click on “Voucher Recipient” to edit this email.

WooCommerce PDF Product Vouchers: recipient email

The Voucher Recipient email is sent to the recipient of a voucher once the voucher has been generated (when the order is paid for). You can enable or disable this email, and tweak certain settings, such as the subject line.

Vouchers will be attached to this email when sent to recipients.

Attaching to products ↑ Back to top

Once you have a voucher template fully configured, you’ll need to attach it to a product to sell it. When editing a product, you can mark it as “Has Voucher” to be able to attach a voucher template to the product.

WooCommerce PDF Product Vouchers: Attach voucher (simple)
Attach Voucher: Simple Product

After that configure your product as you would any other, save it, and your first Voucher Product is complete!

Variable products

Vouchers can be attached for variable products as well. Set product attributes and variations as you would normally would, then you can attach a voucher to each variation in the same way as a simple product.

WooCommerce PDF Product Vouchers: Attach voucher (variable)
Attach Voucher: Product Variation

You can use a different voucher template for each variation if desired.

When a variation is purchased, the selected attributes will be shown as part of the “Product Name” on the voucher if this field is printed. If you do not use the Product Name field, we recommend using unique SKUs for your variations and printing these on the voucher instead.

Name Your Price products

Vouchers will, by default, use the price you’ve set for your product as the voucher value. You can offer a set value, or use product variations to offer values of different amounts, ie $25, $50, or $100.

If you’d like customers to be able to enter a value for the voucher purchase instead, you can pair PDF Product Vouchers with the Name Your Price extension. Vouchers will work with a Name Your Price product:

WooCommerce PDF Product Vouchers: Name your price

The voucher value will use whatever the customer has entered for the product price instead of a pre-determined price. We recommend that you use multi-purpose voucher templates for Name Your Price products.

Mark products as redeemable ↑ Back to top

Redeeming products online requires WooCommerce 3.2 or newer!

If you have single-purpose vouchers that are also redeemable online, you need to mark these products as redeemable by this voucher when editing the product:

WooCommerce PDF Product Vouchers: mark redeemable products

This will allow customers to use the designated SPV vouchers for 100% off this product’s price. We recommend that you ensure your SPV voucher uses the same tax class and configuration as products for which it’s redeemable, as redeeming an SPV will use 100% off the product price, including tax.

Voucher types & taxes ↑ Back to top

Voucher types were introduced in version 3.1, and deserve special mention, as they can influence voucher taxability as well as the way vouchers are redeemed.

Most countries define two basic types of vouchers: single-purpose and multi-purpose vouchers. These are generally taxed differently when sold to customers in a store, along with whether they assess tax on items when they’re redeemed. Based on the type of voucher, the plugin will hint at taxable status, but ultimately you are responsible for knowing tax regulations by which you should abide. If you’re not sure whether a voucher should be taxed at purchase or not, please consult your tax attorney or accountant.

For example, the EU has good resources on taxable status of different vouchers, and International Tax Review has an overview of voucher types; US laws are similar in scope, but ultimately tax compliance is your responsibility as a merchant.

Single-purpose vouchers ↑ Back to top

Single-purpose vouchers are defined as vouchers that are redeemed for a single purpose, such as a specific good or service. This is a true “voucher” in that it’s “traded in” for the desired product, such as a free gift, or service, such as a booking (like a massage appointment).

SPV taxability

Since the tax class of the purchase (what the voucher is being redeemed on) is known at the time of purchase, single-purpose vouchers are typically taxed at purchase. This also means that, since tax is assessed on purchase, no tax is assessed when redeeming the voucher.

If you attach an SPV template to a product and this product is marked as “Tax Status: None”, PDF Product Vouchers will alert you that you may want to review your tax settings, as many countries require these vouchers to be taxable.

WooCommerce PDF product vouchers; SPV tax hint
SPV Taxable Status Suggestions

SPV voucher value

Because SPVs assess tax at purchase, they may have a different “display” value depending on your store’s tax display settings. If you show product prices as exclusive of tax, the voucher value displayed is the product price only, excluding tax.

WooCommerce PDF Product Vouchers Tax Exclusive Display
Tax Exclusive Values

If you display prices as tax-inclusive, then the voucher value for an SPV will include this tax, and will also show the voucher value using the tax inclusive price (this is typically required by countries that show price including tax, such as EU countries where the voucher value should be shown inc VAT).

WooCommerce PDF Product Vouchers Tax inclusive values
Tax inclusive values

SPV redemptions

If an SPV is redeemed online for your store, tax will not be assessed on the product for which the voucher is being redeemed.

Since SPVs are purchased with a particular product in mind for redemption, and they’ve already assessed tax at a particular rate, they can only be redeemed as full “units” for whatever products they can be “traded in” for. If you look to redeem only part of an SPV, you’ll see an alert to use a multiple of the product price instead.

WooCommerce PDF Product Vouchers - Redeem SPV

If you use tax-inclusive pricing, you’ll be asked to enter the redemption amount including tax instead.

WooCommerce PDF Product Vouchers - Redeem SPV tax-inclusive

In either case, tax is automatically calculated for the redemption.

WooCommerce PDF Product Vouchers - Redeemed SPV

Multi-purpose vouchers ↑ Back to top

Multi-purpose vouchers are defined as vouchers that can be redeemed on any product or service. This is a more like a gift card, store cash, or gift certificate, as this type of voucher can be used on any item in the store.

MPV taxability

Since the voucher can be redeemed on any product, the tax status of the goods ultimately being purchased is unknown when the voucher / certificate is purchased. As such, MPVs are typically non-taxable in many countries. Instead, tax is assessed on the items being purchased at the time the voucher is redeemed.

If the product that sells the voucher has “Tax Status: Taxable”, you’ll be alerted to potentially change this to Tax Status: None.

WooCommerce PDF product vouchers; MPV tax hint
MPV Taxable Status Suggestions

MPV voucher value

As MPVs should be un-taxed, the value of an MPV displayed to the customer will not change with your tax display settings.

MPV redemptions

If an MPV is redeemed online for your store, tax will be assessed on the product for which the voucher is being redeemed; the voucher is applied to the order total, not subtotal.

As MPVs have no restrictions on what they can be redeemed for, the redemption amount entered is not restricted, and can be any value. However, as the MPV is not taxed, and the plugin has no way to know what the tax assessed is on a redemption, it will only accept the total value for the redemption.

Customer views ↑ Back to top

Purchasing vouchers ↑ Back to top

When a customer is in the process of purchasing a voucher product, they’ll see any fields you’ve enabled for the voucher on the product page. These fields can be marked as required when you set up your template if you want to ensure the field is present on the voucher.

WooCommerce PDF Product vouchers purchasing voucher

If you have alternative images available for a voucher, the customer will be able to choose which background image to use, and can click on a background to view it in a lightbox for more detail.

After purchasing, the purchaser will receive generated PDFs as attachments to processing and completed order emails. (Vouchers are only generated when the order has been paid for unless you manually force generation.)

WooCommerce PDF Product Vouchers: Sample Voucher
Sample Generated Voucher

The voucher recipient will receive an email once the voucher has been paid for with the voucher as an attachment, assuming a recipient email has been entered.

Redeeming vouchers ↑ Back to top

Redeeming products online requires WooCommerce 3.2 or newer!

When redeeming vouchers, customers can use the “Coupon code” fields on your site to enter an applicable voucher code.

Single-purpose vouchers

When a customer seeks to redeem an SPV, the products in the cart will first be checked to see if they’re redeemable for that voucher. If not, an error is shown:

WooCommerce PDF Product Vouchers: SPV not redeemable for cart
SPV not redeemable for cart

If the cart contains at least one redeemable item for the voucher, then the voucher is applied to the highest-priced item for which it’s redeemable. This discounts 100% of the cart item’s price, regardless of the SPV value, so be sure that your voucher prices match the products on which they can be redeemed.

WooCommerce PDF Product Vouchers: SPV redemption

The voucher value is also applied before taxes are calculated, so taxes are assessed on the subtotal after vouchers are already deducted.

Multi-purpose vouchers

Since MPVs can be redeemed on any item, they will be treated as a gift card or store gift certificate, and are applied similar to a cash payment. Up to 100% of the voucher’s value can be used. If only part of the voucher’s value is used, then it is partially redeemed, and the rest can be used at a later date.

WooCommerce PDF Product Vouchers: MPV redemption

The voucher value is applied after taxes are calculated, so taxes are assessed on the total before the voucher is considered.

Downloading the voucher ↑ Back to top

Customers can download vouchers as attachments to order emails, and recipients can also get an email with vouchers attached if their email address has been entered by the purchaser.

If a purchaser is a registered customer on your site, they can also view any vouchers they’ve purchased (or that you’ve manually added for them) and re-download them from the account area under the “Vouchers” section.

WooCommerce PDF Product Vouchers: My Vouchers
Account Area

Voucher orders ↑ Back to top

When a voucher is purchased, it will create a “pending” voucher under the Vouchers list, and when the order is paid for, the voucher will become active, being generated and sent to purchasers and recipients if needed.

Orders containing vouchers ↑ Back to top

When an order contains a product with a voucher attached, you’ll see the details for this voucher in the “Edit order” page. The product line item will have data from the voucher fields, such as the recipient details. The order will also link to the generated voucher under the “Vouchers” list.

For a purchased voucher, the voucher number is slightly modified. The voucher number always has a random, 8-character alphanumeric string, but when purchased, will also append the order number as a suffix, making it easy to correlate a voucher to an order.

Manually-created voucher number: EK4YN87D
Purchased voucher number: EK4YN87D-4481

This also supports plugins like Sequential Order Numbers Pro, as a custom order number will be used as the suffix (including the order number prefix or suffix).

Refunding an order will automatically void any purchased vouchers, so they will no longer be redeemable.

Admin order email ↑ Back to top

When an order is placed for a PDF Voucher product, the admin “New Order” email will show the voucher number in the item details.

WooCommerce PDF Product Vouchers: Admin email

Voucher administration ↑ Back to top

You can view a list of customer vouchers under WooCommerce > Vouchers. This list of generated vouchers lets you view any vouchers, voucher status, quickly add redemptions or voids, and search for vouchers in one place, helping you when managing vouchers in-store or at an event.

WooCommerce PDF Product Vouchers Generated Voucher List
Generated Voucher List

You can click on a voucher to view more details or to edit existing details. You can also manually add vouchers for a customer.

View or edit vouchers ↑ Back to top

The screen to view or edit vouchers will provide a familiar, “order-like” interface for you to manage voucher details. From this view, you can see purchaser details, recipient details, the purchased product and value, download the generated voucher PDF, or add notes or redemptions to the voucher.

WooCommerce PDF Product Vouchers: Edit Voucher
Generated Voucher

You can also use the voucher actions to re-generate the voucher PDF if you make changes (regeneration does not happen automatically), or re-send a voucher to a recipient.

WooCommerce PDF Product Vouchers: Voucher actions
Voucher Actions

Manually redeeming vouchers ↑ Back to top

There are two ways you can manually redeem a voucher: from the “Vouchers” list using a quick action (helpful if managing several vouchers at once), or while viewing a voucher itself. There are two components to any redemption: the amount and an optional note or reason if you’d like details on the redemption (e.g., what it was used on).

You can add partial or full redemptions of the remaining voucher value. Multiple redemptions can be added for a voucher until the entire value is used up.

To add a quick redemption, use the “Redeem” action (the checkmark) on the vouchers list. This will open a window for you to add the redemption amount and any notes.

WooCommerce PDF Product Vouchers: Quick Redemption
Quick Redemption

If you’re already editing or viewing a voucher, you can click the “Redeem” button to add a redemption, similar to adding a refund to an order. This will also allow you to enter a redemption and notes.

WooCommerce PDF Product Vouchers: Add redemption
Add Redemption

Once the redemption has been added, it will be shown as a line item for the voucher, similar to an order refund.

WooCommerce PDF Product Vouchers: Redemption added

Once a voucher has been fully redeemed (no remaining value), the status will change from “active” to “redeemed”.

Barcode scanning ↑ Back to top

QR code scanning is offered as an alternative to manual redemption. Be sure your voucher template has a barcode configured in order to display codes on a voucher.

Note that a QR code must be used for the voucher template; scanning other types of codes for automated redemption is not supported within the plugin at this time. However, other barcode types are included in case your store or device offers support for alternative barcode types.

You can redeem vouchers via scanning by going to WooCommerce > Vouchers, and clicking the “Redeem voucher” action:

WooCommerce PDF Product Vouchers scan voucher

From here, you can click “Scan QR code” on a device capable of reading QR codes (such an iPhone) to redeem a code via scanning.

An SPV voucher is redeemed based on quantity. Therefore, one scan = one quantity redeemed. If a voucher has more than one quantity available, you can scan it multiple times to redeem as many quantities as desired.

Redeeming an SPV voucher looks like this:

An MPV voucher is redeemed based on amount. Therefore, when scanning an MPV, you’ll need to enter the amount to redeem after scanning, then click “Redeem”. You can scan an MPV multiple times until the remaining voucher amount is used.

Redeeming an MPV voucher looks like this:

Voiding vouchers ↑ Back to top

Voiding vouchers follows a similar process to redeeming vouchers manually. A void can be used to revoke a voucher so the customer is unable to use the remaining value. A void will always nullify the entire remaining amount, changing the voucher status from “active” to “voided”.

Refunding an order will not automatically update any purchased vouchers, so we recommend manually adding a void for your voucher if refunding an order.

To quickly process a void from the “Vouchers” list, click the void (“x”) icon. You can optionally enter a note or reason for the void if desired.

WooCommerce PDF Product Vouchers: Quick Void
Quick Void

To void a voucher while viewing or editing it, click the “Void Remaining Value” button, which will let you optionally enter your reason as well. Click “Void” to process the void.

WooCommerce PDF Product Vouchers: Add void
Void Voucher

The voucher status will change to “voided” and redemptions can no longer be added to the voucher.

WooCommerce PDF Product Vouchers: Voided voucher

Downloading vouchers ↑ Back to top

Admins can download vouchers manually by clicking the “View Voucher PDF” link in the voucher preview.

WooCommerce PDF Product Vouchers: Change alternative image

Changing voucher details ↑ Back to top

If you want to change the value of a voucher, or the product / voucher template used for the voucher, you can do so only if there are no redemptions or voids added already for the voucher.

If you’d like to change the product used for the voucher or the value, hover over the product and click the “pencil” / edit icon for the voucher.

WooCommerce PDF Product Vouchers: Change voucher product
Change product or value

This will allow you to choose a new voucher product, and / or update the initial voucher value.

WooCommerce PDF Product Vouchers: new value or product

Changing the product will likely change the voucher template used, so we recommend regenerating the voucher PDF after making these changes.

You can also change the voucher background image if there are alternative images available for the voucher template. If alternative images are available, you’ll see a “Change voucher image” link in the voucher preview.

WooCommerce PDF Product Vouchers: Change alternative image

Clicking this will show you the alternative images, letting you choose a different background for the voucher.

WooCommerce PDF Product Vouchers: choose new image

If you change the voucher image, you should save and regenerate the voucher PDF, potentially re-emailing it to recipients as well.

WooCommerce PDF Product Vouchers: image updated

Manually adding vouchers ↑ Back to top

You can manually add a voucher for a customer if desired. If you add a voucher for a registered customer, this will even show up in the “Vouchers” section of the account page.

First, go to the Vouchers list, and click “Add New Voucher”. You must choose a product that has a voucher template attached to it.

WooCommerce PDF Product Vouchers: Add voucher, step 1

Once you’ve chosen a product to use for the voucher and template, click “Add Voucher”. This will create a new, blank voucher, letting you add purchaser details (and recipient details if needed).

WooCommerce PDF Product Vouchers: Add voucher, step 2

You can manually adjust the expiration date (optional), purchase details, recipient details, and when you’re done, make the voucher “active” for use.

WooCommerce PDF Product Vouchers: manual voucher addition

Note that a manually-added voucher will have a voucher number without an appended order number since there’s no order to which this was tied.

How voucher purchases work ↑ Back to top

When a customer views a voucher product, they’ll be prompted to enter voucher details for any fields you’ve enabled on the voucher. This will allow the customer to purchase the voucher.

Note that increasing the quantity of the voucher will not re-prompt the customer to enter voucher details for each unit purchased, or generate multiple-vouchers!

If you sell items like tickets, where quantity increases are expected, but voucher details shouldn’t vary, you may want to leave quantity enabled. However, if your vouchers should have different details for each item, you may want to enable “Sold individually” for this product under Product Data > Inventory.

Once the product is added to the cart and the order is placed, a pending voucher is created. The PDF voucher file is generated when an order is paid for (typically “processing” or “completed” status, depending on your Grant access to downloadable products after payment setting), so it’s not always generated immediately at purchase. Once generated, the voucher moves to “active” status.

Once a voucher is generated, it will be attached to the standard customer order receipt emails, and available for download from the customer’s My Account area in the “Vouchers” section.

If the optional “Recipient Email” field is enabled, a separate email will also be sent to the email address supplied by the customer, and is perfect for vouchers that can be sent as gifts. This will be sent at the same time as the customer email, so vouchers are only sent to recipients for processing or completed (paid) orders.

Frequently asked questions ↑ Back to top

Q: Is the voucher number secure?
A: Every voucher uses a random, 8-character alphanumeric string as the voucher number. Our plugin also ensures that the voucher number is unique, so a customer cannot guess at a voucher number to generate their own PDF.

A voucher will also append the order number as a suffix to the voucher number, so this provides an additional “check” on your voucher numbers, as any purchased voucher will have these two components.


Q: Why are my vouchers only generated when orders are “completed”? I want them to be generated on “processing”.
A: The timing for voucher generation is dictated by a WooCommerce download setting. If you go to WooCommerce > Settings > Products > Downloadable products, you can enable “Grant access to downloadable products after payment”. This will ensure that downloadable items, including vouchers are sent and accessible with the “Processing” status.


Q: Does this work with WooCommerce Coupons?
A: Vouchers can be redeemed online via the “Coupon” input in your cart and checkout (if your voucher is marked as redeemable online). However, they’re “hidden” as a coupon type, so all voucher management is done from the “Vouchers” list, rather than the “Coupons” list (vouchers will not appear here).

Note that redeeming vouchers online requires WooCommerce 3.2 or newer.


Q: How can I prevent the same voucher from being used twice?
A: Ensure that your voucher contains the voucher number field, which is the key to preventing this. The voucher number is unique, so each voucher will be redeemed using this voucher number.

You’ll be able to mark the voucher as “redeemed” with the date in the Voucher page so that customers can’t use the same voucher twice or forge vouchers, as they won’t have a valid voucher number.


Q: Why is a single voucher generated when a product is ordered with a quantity > 1? My customers are ordering 2 vouchers and being charged for two, but they only get one voucher to download.

How do I generate multiple quantities of a voucher?

A: Since voucher recipient details must be entered for each voucher, customers cannot order quantities of 2 or more of identical vouchers. There is no way to apply identical voucher details to quantities > 1. We’ve also found that some customers try to order a quantity>1 and want to enter details for multiple recipients, and expect a way to enter “Voucher 1 Recipient”, “Voucher 2 Recipient”, etc. after selecting more than one voucher, but increasing quantity has no way to force generation of multiple recipient fields. However, you can make a minor adjustment if this occurs.

If you find that customers are purchasing multiple vouchers at once, you can adjust settings easily to ensure that the correct number of vouchers are included in the order. Configure the product to be “sold individually” under Product Data > Inventory, which will ensure that the correct number of vouchers is generated.

This will not limit customers to one voucher per order; it simply requires each voucher to be added to the cart separately to ensure they all have correct recipient info entered. This will allow the customer to add more than one voucher with the same recipient names/messages (or give them the opportunity to enter different information for multiple recipients) and will generate the correct quantity of vouchers. Each voucher will show up on the order as a separate line item, even if they have the exact same recipient details, so that customers can review the order correctly.

If you want a “true” sold individually (one of a voucher product per order), then this would require a bit of custom code, as WooCommerce core does not behave in this way (product meta, such as voucher details, would automatically make each product unique). Here’s a sample snippet that disables adding more than one of a particular voucher product to the cart, which could be used or modified by your developer if needed.


Q: Can customers set their own value for the voucher so it can be used as a gift certificate?
A: Vouchers can be configured as a gift certificate in conjunction with the Name Your Price extension. When vouchers are created as a “Name Your Price” product, customers can enter a value for the voucher. The voucher can then be redeemed in person for this amount after it’s printed.

Be sure to enable the “Product Price” field so you know the voucher’s worth if using this combination!


Q: Does this plugin support WooCommerce Bookings?
A: Bookings fields are not supported on vouchers. We have this on our roadmap, though! Vote for this idea here so we know what’s important to you 🙂


Q: Why do I get this error: “PDF error: Image file has no extension and no type was specified”?
A: You must upload an actual image file (ex. jpg or png). The extension will convert this image into a PDF for you.


Q: Why does my PDF voucher look blurry on screen?
A: This is most likely an artifact due to a setting with your PDF viewer (ie Acrobat for Windows, Preview for OSX, etc). Basically, most PDF viewers by default will try to display an image the way they think it will appear when printed, however they don’t always get it right.

You should be able change this setting in your PDF viewing application. For instance on OSX using Preview you’d go to Preview > Preferences… > PDF and next to “Define 100% scale as” you’d select “1 point equals 1 screen pixel”:

Preview > Preferences... > PDF
Preview > Preferences… > PDF

Q: Why does my PDF voucher look blurry when printed?
A: As with so many things, the unfortunate answer is “it depends”. If your voucher PDF is smaller than the page size you’re printing to, then it may be being scaled by your print manager up past 100%, which would result in a blurry, unfocused image. Try changing your print settings to scale no higher than 100%.

It’s also important to remember that what looks good on screen doesn’t necessarily look the same when printed, simply due to the physical differences between a pixel on a monitor and a pixel printed to a piece of paper. In general, images will look better on screen and require a higher resolution when printed to look as good as the on-screen version.

One solution is simply to start with a higher resolution (bigger) voucher image, which may look large on screen as a PDF, but should be scaled down and look sharp when printed. Please ensure your voucher background is high-resolution / 300 DPI, and that you’ve set this as the image DPI for your voucher.

It’s important to test your voucher image when initially configuring your voucher. We recommend manually adding and generating a voucher for yourself to quickly get a sense of how your chosen image translates to PDF form, how the text fields are laid out, and print a sample voucher PDF to see how it looks on paper.

Troubleshooting ↑ Back to top

Vouchers do not generate ↑ Back to top

There are a few causes for vouchers not generating or remaining “pending” in your store. Please check these items:

  • Ensure your order is in a paid status — if vouchers only generate upon “completed”, please follow the notes in this FAQ entry.
  • Background processing – Your site must have background processing enabled. The plugin will attempt to inform you of issues on the “vouchers” list:
    WooCommerce PDF Product Vouchers: background test failed
    You can also manually run a test from WooCommerce > Status > Tools:
    WooCommerce PDF Product Vouchers: Test Voucher Generation
    Test Voucher Generation

    If this tool returns an error, this means that your host won’t allow requests from your site’s server (the plugin) to itself for files (sometimes called a “loopback connection”). Your host must enable this for voucher generation to work. While some hosts may note that this is a security issue, there is no security threat to using a loopback connection; if done incorrectly, it could increase server usage, but quality hosts will combat this for you with rate limiting.
  • Security plugins – It’s essential for PDF Product Vouchers to access the HTML generated for each voucher to convert it to a PDF. Some security plugins, such as WordFence or iThemes Security, can block the plugin from retrieving its HTML, and should be disabled or reconfigured to allow the plugin to access this HTML.
  • Hosts files – For developers: hosts files to resolve a site to a different domain cannot be used with this plugin (and many others for WooCommerce). The plugin will use wp_safe_remote_* requests to get data from itself, and these will fail as they require a domain name; so if your site is pointing at a domain from a hosts file, rather than a public site, these requests fail.
  • BasicAuth – Similarly, if your site is behind BasicAuth, background requests to generate vouchers will fail to complete. For example, WP Engine staging sites often use basic authentication to block site access (you see a popup for credentials when you try to access the site):
    Basic Authentication
    Please disable basic authentication to generate vouchers.

Blank vouchers ↑ Back to top

The first thing to check for is a maintenance mode plugin. Is your site publicly available? This is required for the voucher generation to work, so please disable maintenance mode plugins. The voucher gets generated from an HTML file on your site, so the plugin needs to be able to request and read this HTML file to generate the voucher, which maintenance mode plugins prevent.

Similarly, some hosts will block the voucher from getting this HTML file to read it as well. You can test this using the voucher system status tool under WooCommerce > System Status > Tools, which will simulate reading a voucher file:

WooCommerce PDF Product Vouchers: Test Voucher Generation
Test Voucher Generation

If this tool returns an error, this means that your host won’t allow requests from your site’s server (the plugin) to itself for files (sometimes called a “loopback connection”). Your host must enable this for voucher generation to work. While some hosts may note that this is a security issue, there is no security threat to using a loopback connection; if done incorrectly, it could increase server usage, but quality hosts will combat this for you with rate limiting.

More importantly, many features in WooCommerce or upcoming features need loopback connections to function: the database updater and eventually, background email sending can be re-added, which uses the same type of background processing (and requires loopback connections). It’s essential that a host for an eCommerce site support this.

Slow voucher generation ↑ Back to top

Please note that voucher generation times will increase as your background image size increases. At checkout, this means that an order that’s immediately paid for can take longer to generate a voucher and display the “Order Received” page.

If you use high-resolution vouchers, we recommend keeping these to a size smaller than a printed page (less than 2000px) so that the generate in a reasonable time during purchase or when regenerating vouchers in the admin.

While using PHP 7.0+ will help with voucher generation quickness, background image size is the largest factor in how long a voucher takes to generate.

Special character support ↑ Back to top

The plugin does support using non-ASCII characters, such as Cyrillic or Mandarin, on a generated voucher. As system fonts are used, your server / hosting environment should support this. However, if you find that special characters are not being recognized properly (or are replaced with ? symbols), you can use an external font instead with broader character support.

While we plan to add Google Font support in a future version, here’s a sample plugin that will add Noto Sans support for now to vouchers, which supports characters in any language. To use this on your site, visit this URL, click “Download ZIP” in the top-right, then install this zip file onto your site as a plugin via Plugins > Add New > Upload. You can then activate this and use Noto Sans for your voucher fonts.

Developers can also use this as a guide to add other fonts if you’d like to add a different font for your language’s characters.

Scanning barcodes ↑ Back to top

If you see issues when scanning a voucher to redeem it, please take the following steps.

  • Be sure your voucher is using a QR code for the barcode type. While other barcodes may be used for external scanners, this plugin only supports reading QR codes at this time for scanned redemption.
  • Seeing an issue when you click “Scan QR code”, like “Only secure origins allowed”? This is because your browser will not allow camera access without an SSL certificate. Your site must install an SSL certificate for your to scan voucher codes.
    WooCommerce PDF Product Vouchers scanning QR codes error

Other issues ↑ Back to top

Having other trouble with voucher generation or management? Please try the following steps for the fastest resolution:

  1. Are orders only generating one voucher when multiple vouchers are purchased? Please see this FAQ entry on selling multiple quantities.
  2. Are you seeing this error: PDF error: Image file has no extension and no type was specified? Please ensure you’re uploading an image file (ie PNG or JPG) instead of a PDF or other file type; PDF are generated from an image file automatically.
  3. Vouchers looking blurry? Please see this FAQ entry if they look blurry on-screen or this FAQ entry if they look blurry when printed.
  4. Is the voucher text blown up or not looking correct in general? Please note that you cannot use image-compression plugins like WP SmushIt or other image compressors when trying to add retina-dpi or high-resolution vouchers, as they’ll lose this resolution when compressed. Ensure resolution is at 300 DPI and your voucher is configured with this setting as well.
  5. Having another issue you need assistance with? Please submit a request to our help desk and we’d be happy to assist.

Questions & support ↑ Back to top

Have a question before you buy? Please fill out this pre-sales form.

Already purchased and need some assistance? Please view our troubleshooting tips, or get in touch with support via the help desk if these didn’t resolve your issue or question.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top