A customer did not reach my list
Go through these in order:
- Did they tick the box? Open the order. Without a consent record, nobody is synced while Ask at the checkout is on. That is the point.
- Did the order reach the sync status? Free edition: Completed. Full edition: the Sync when an order reaches status (default Processing). An order that skipped straight past it — for example Pending to Completed while you sync at Processing — never passes through it and is not synced.
- Was the order synced before? Each order is synced once (
_gmsy_synced). Testing twice needs a new order. - Is the store set up? If the screen says the key and list are not enough to write anything, nothing was queued at all.
- Is the contact still waiting? Look at Waiting to be written; the provider's reason is printed beside the address.
What do the usual provider errors mean?
- HTTP 401 or 403 — the API key is wrong, revoked or rotated. Paste the new key and press Try these again.
- HTTP 404 — the list or Audience ID does not exist (or belongs to another account).
- HTTP 400 mentioning a merge field or attribute (full edition) — the purchase fields
ORDERS,SPENT,LASTORD(andTAGSon Brevo) do not exist at your provider. Create them, or turn the purchase fields off. - HTTP 429 — the provider is rate-limiting. The queue retries on its own.
- "That is not an address this plugin will write to." — the key has no usable Mailchimp datacentre ending, so no destination can be built.
Contacts sit in the queue for a long time
Writing happens in WP-Cron, which runs when the site gets a visit. On a quiet site, or with DISABLE_WP_CRON set and no server cron, nothing runs. Write these now sends them immediately; a server cron calling wp-cron.php every few minutes fixes it for good.
Does it work with the Checkout block?
Yes. On WooCommerce 8.9 or later the consent box is added to the Checkout block as an order field, through WooCommerce's own additional-checkout-fields API, and recorded the same way as on the classic checkout. On an older WooCommerce the box appears on the classic checkout only.
Does it work with HPOS and caching?
Yes. Both editions declare HPOS compatibility, and every order read and write goes through WooCommerce's order API. The checkout is never cached, and nothing is sent from a shopper's request, so page caching does not affect it.
Will a customer who unsubscribed be put back?
No. On Mailchimp a new member is created as subscribed, but an existing member's status is never changed. Brevo's update keeps an unsubscribed contact unsubscribed from email; adding them to a list does not change that.
Can I sync customers who ordered before I installed the plugin?
No. Only orders that pass through the sync status after the plugin is set up are synced, and only with consent recorded on the order. There is no backfill.
Which customer details are sent?
Free edition: the email address and the billing first and last name. Full edition: those, plus order count, total spent, the order date, and tags. Never the address, phone, products or order number. See what is sent.
What if I switch the consent box off?
Then every customer whose order reaches the sync status is synced without being asked. Only do that if you collect marketing consent somewhere else.
I moved from the free edition to the full edition
Install and activate the full edition. It reads the same gmsy_settings option — provider, key, list and wording — and the same order records, so every order already synced stays synced and nobody is sent twice. The free edition stands down while the full edition is active; a line under it on the Plugins screen says so, and you can deactivate it. Contacts still waiting in the free edition's own queue are not moved; press Write these now before switching to be sure the free queue is empty.
What does uninstalling remove?
- Free edition: its queue (
gmsyf_outbox) and its scheduled events always. The shared settings only if the full edition has never been configured on the site. - Full edition: the settings, its queue, the licence state, the cached update data and its scheduled events.
- Neither removes anything from orders: the consent record (
_gmsy_optin) is your proof of what each customer agreed to, and the claim (_gmsy_synced) stops a reinstall from syncing every past order again. Nothing at Mailchimp or Brevo is deleted either.
Where are the full edition's settings?
WooCommerce → List Sync, and also under the Gatemi admin menu, which gathers every Gatemi plugin installed on the site.
