Troubleshooting Gift Cards

Use this guide to troubleshoot problems with gift card codes, delivery, and the delivery date field.

Gift card code not generated

↑ Back to top

Gift Cards creates a code when the order is paid or marked Completed. Check the order status and look for the code under Marketing > Gift Cards.

If the order is paid or completed but the code is missing, check Tools > Site Health for a Gift Cards database table warning. If tables are missing, ask your host to check whether the database user can create tables. Contact Woo support if you need help investigating the warning.

Gift card code cannot be used

↑ Back to top

Under Marketing > Gift Cards, check whether the code is active and has an available balance. Funds used for a pending order may be held until the order is paid or canceled. See Gift Cards and Pending Orders for more information.

Gift card email not delivered

↑ Back to top

First check that the order is paid or completed and that a code was generated. Immediate deliveries are normally processed within a few minutes; scheduled deliveries are processed on the selected date. Confirm the recipient email and delivery date on the gift card.

Gift Cards uses Action Scheduler to process deliveries. Under Tools > Scheduled Actions, check whether pending actions are overdue. Under Tools > Site Health, check for loopback request errors. If background processing or loopback requests are not working, ask your host to investigate.

Check a scheduled delivery

↑ Back to top

For a future delivery, a scheduled action is created when the order is paid or completed. In Tools > Scheduled Actions, check its Scheduled Date and Log to see when delivery is due and when the action was created. By default, the selected delivery date is interpreted using the customer’s time zone.

Delivery date does not display correctly

↑ Back to top

If the delivery date calendar does not display correctly, test for a theme or plugin conflict on a staging site. If the problem persists, contact Woo support with a screenshot and the steps to reproduce it.

If delivery dates show unexpected characters, check the date format under Settings > General and test a different format on a staging site. Current versions of Gift Cards remove the ordinal suffix from the delivery calendar format.

Gift card products missing from a Meta shop

↑ Back to top

Gift Cards products are virtual. If a gift card product doesn’t appear in your Facebook or Instagram shop, check your catalog and current Meta requirements. For product sync troubleshooting, see Products are not displaying in Facebook shop.