Errors and Solutions

This guide contains the most common errors when using the WPify Woo Product Vouchers plugin and steps to resolve them.

Coupon Generation Errors

Coupon is not generated when order status changes

Cause: The order status is not configured as a trigger for coupon generation, or the product is not set up as a voucher.

Solution:

1. Check Status for generating coupons in the plugin settings — make sure the correct order statuses are selected
2. Open the product and verify the Product Vouchers tab — coupon generation must be enabled
3. Check that the product has at least one coupon entry with Enabled toggled on
4. Review the order notes for any error messages

Voucher image is not generated or is blank

Cause: The template configuration is incorrect, the background image is missing, or there are file permission issues.

Solution:

1. Verify that the template has a background image uploaded in the File field
2. Check that the image file exists and is accessible
3. Verify file permissions on the wp-content/uploads/ directory
4. Try using the template preview in the admin to see if it renders correctly
5. Check the server’s PHP GD or Imagick extension is enabled

Coupon code does not work at checkout

Cause: The coupon may have expired, reached its usage limit, or was deleted.

Solution:

1. Go to WooCommerce → Coupons and find the generated coupon
2. Check the coupon’s expiry date and usage count
3. Verify the coupon has not been deleted (check if the order reached a deletion-trigger status)
4. Make sure the coupon discount type and amount are correct

Email Delivery Errors

Customer does not receive the voucher email

Cause: The voucher email is not configured or the triggering order status is not set.

Solution:

1. Check Order statuses for voucher email in the plugin settings — make sure at least one status is selected
2. Go to WooCommerce → Settings → Emails → Voucher e-mail and verify it is enabled
3. Check your server’s email sending capability
4. Verify the customer’s email address in the order

Voucher PDF is not attached to emails

Cause: The email attachment setting is not configured.

Solution:

1. In the plugin settings, check Attach voucher to emails — select which emails should include the attachment
2. Make sure the voucher was generated before the email was sent (check the order status sequence)
3. Verify that the voucher file exists in the server’s temporary directory

Customer receives both standard and voucher emails

Cause: Standard WooCommerce emails are not disabled for voucher-only orders.

Solution:

1. In the plugin settings, configure Disabled emails for voucher only orders
2. Select the standard emails you want to disable (e.g., Processing order, Completed order)
3. This only affects orders containing exclusively voucher products

Template Selection Errors

Template selection page shows no templates

Cause: No templates are assigned to the product, or template selection is not enabled.

Solution:

1. Open the voucher product and go to the Product Vouchers tab
2. Enable Template selection
3. Select at least one template in Allowed templates
4. Verify the template selection page is correctly configured with the shortcode [wpify_woo_vouchers_select_voucher]

Frequently Asked Questions (FAQ)

Can I create vouchers with different values?

Yes, use a Variable product with variants for each voucher value (e.g., 500 CZK, 1000 CZK, 2000 CZK). Each variant can have its own price, which determines the coupon value.

Can I restrict the coupon to a specific customer?

By default, the generated coupon can be used by anyone. Use the wpify_woo_product_vouchers_generate_coupon_data filter to add email restrictions programmatically.

What image format should I use for templates?

Use JPG, PNG or PDF format for the template background. The generated voucher is output as PDF (recommended) or JPG, depending on the Voucher output type setting. When a PDF template is used, the output is always PDF. Ensure the template has sufficient resolution and blank areas where dynamic text (code, value, dates) will be placed.

How does VAT work with gift vouchers?

Gift voucher taxation depends on your country’s regulations. In the Czech Republic, single-purpose vouchers (where the VAT rate is known at time of sale) are taxed at sale. Multi-purpose vouchers (MPV — where the VAT rate is not known) are taxed at redemption. For MPV, set the voucher product to a 0 % VAT rate and choose “Fixed cart discount” as the coupon discount type, so that VAT is charged only when the coupon is redeemed. Consult your accountant for the correct setup.

Can the customer enter a custom voucher amount?

The plugin does not support customer-defined amounts. Instead, create a Variable product with variants for the most common values (e.g., 500 CZK, 1000 CZK, 2000 CZK). If you need a wider range, add more variants or use an additional “Name Your Price” plugin.

Can I manually generate or regenerate a voucher for an order?

Yes, in the order detail page, you can find a Product Vouchers metabox where you can manually trigger coupon generation for the order.