A customer did not get their coupon. What do I check?
Work down this list:
- Is the master switch on? WooCommerce → Birthday Coupons → Email a birthday coupon (free) or Send coupons and On a customer's birthday (full).
- Does the customer have a date? It is stored on their account only. A guest checkout stores nothing. In the full edition, the Birthday column on Users shows it.
- Was today the send day? The free edition sends 7 days before the birthday; the full edition uses Send it this many days early. A customer who added their date after that day gets their first coupon next year.
- Is cron running? The job is the
gmbdf_daily(free) orgmbd_daily(full) cron event. On a quiet site, WP-Cron only runs when someone visits. If the site had no visitors that day, the day was missed — the plugin does not send late birthday coupons. - Was it already sent this year? Look in Marketing → Coupons for a coupon with the description "Birthday coupon." restricted to the customer's email. The record
_gmbd_laston the customer names the last code sent. - Did the email leave the site? The plugin hands the message to
wp_mail(). If your site's mail does not deliver, nothing from WordPress arrives. An SMTP plugin with a mail log will show it.
Can a customer share the code?
They can pass it on, but it will not work for anyone else. Every coupon is restricted to the email address of the account it was minted for, can be used once, and is individual-use.
What if the daily job runs twice?
Nothing happens the second time. The year is claimed with a single database insert before the coupon is created, so only one run can win. See How it works.
The date field is not on my checkout
The field is added through WooCommerce's classic checkout fields, so it appears on the shortcode checkout ([woocommerce_checkout]) and not on the Checkout block. On a block checkout, keep In My Account, where the customer can change or clear it on so customers can add their date under My Account → Account details.
Also check that On the checkout is ticked, and that the plugin is on.
Does the block checkout accept the coupons?
Yes. They are ordinary WooCommerce coupons and work on the classic checkout, the Checkout block and the Store API.
Do guests get a coupon?
No. A date of birth is only ever stored on a customer account, and a guest checkout has nowhere to keep one. In the full edition the same applies to anniversaries: a guest has no account and no join date.
Does a page cache or a cache plugin affect it?
No. Nothing the plugin does happens on a cached page: the date is saved by WooCommerce's own checkout and account forms, and coupons are sent by cron. If your host disables WP-Cron (DISABLE_WP_CRON), make sure a real cron calls wp-cron.php — otherwise no coupons are sent at all.
Is it compatible with HPOS?
Yes. Both editions declare compatibility with High-Performance Order Storage. They never read or write order data: dates live on users and coupons are coupon posts.
Someone was born on 29 February
In a leap year they get their coupon for 29 February; in other years it is sent for 28 February.
Why is the expiry date earlier than I expected?
Expires after counts from the day the email is sent, not from the birthday. With the free edition's 7-day head start and a 30-day expiry, the coupon is valid until 23 days after the birthday.
I have a large customer list. Does it cope?
Yes. The birthday run only reads customers who have given a date, and both editions page through them 2,000 at a time until every one has been read, so nobody past the first 2,000 is skipped. Full edition: the anniversary run pages through every customer account the same way (every account has a join date). The gmbd_batch_size filter changes the page size (1–20,000), not how many customers are reached.
Moving from the free edition to the full edition
Install and activate the full edition. The free edition stands down on its own and says so on the Plugins screen; you can then deactivate and delete it. Your settings (gmbd_settings), every customer's date (_gmbd_dob) and every "already sent this year" claim are shared, so nothing is re-entered and nobody gets a second coupon this year.
What happens when I uninstall?
Free edition: deleting the plugin clears its own gmbdf_daily cron event and removes its settings, every stored date of birth, the _gmbd_last records and every claim — unless the full edition has been set up on this site (a stored gmbd_license), in which case it touches nothing else, because removing the claims would let the full edition send everyone a second coupon.
Full edition: deleting the plugin removes its settings, the licence, its cron events, every date of birth, _gmbd_since, _gmbd_last and every claim.
In both editions, the coupons are kept. A code you have already emailed is a promise.
Does the plugin send data anywhere?
The free edition makes no external requests. The full edition contacts gatemi.com only for licence checks and updates, and only once a key is entered.
