Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages

Help for owners

Mailchimp is not syncing customers or orders from my store

Short answer

Mailchimp connects store customers to audience contacts by email address. A customer who is not already in the audience is added as subscribed or as transactional depending on their opt-in status, so people can appear in the store but not as marketable contacts. Check the store's audience link and sync flag first.

  • Written for business owners
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Does this sound like your situation?

  • Customers from my store are missing from the audience.
  • Orders do not show on contact activity.
  • People who bought show as non-subscribed.
  • Abandoned cart or order emails stopped sending.
  • The numbers differ between my store and Mailchimp.

Why does this happen?

  1. Customers are matched by email address

    Mailchimp's developer documentation says store customers map to contacts by email address. If the email is not in the audience, the contact is added as subscribed when opt_in_status is true, or as transactional when it is false. Changing true to false does not change an existing subscription status.

  2. A store is tied to one audience

    The same page says each store is tied to one audience and cannot be connected to a different one once set. A store connected to the wrong audience, or reconnected, shows up as missing contacts.

  3. Products must exist before orders

    Mailchimp says a variant must exist in a store before a cart line or an order line can reference it, so an order for a product that never synced cannot be recorded.

  4. Order fields affect what shows

    Without processed_at_foreign, orders may not appear on a contact's activity feed, and campaign revenue tracking needs campaign_id, processed_at_foreign and financial_status.

  5. A sync flag paused automations

    Setting is_syncing to true on a store pauses order notifications, abandoned carts and several customer automations for that store, until it is set back to false. A sync that never finishes can leave it on.

What can I do about it today?

  1. Compare two numbersCount customers in the store and contacts in the audience for the same week. The gap shows the size of the problem.
  2. Pick three missing customersSearch each email in the audience. Is the person there as subscribed, transactional or not at all?
  3. Check which audience the store is connected toIf it points to an old or duplicate audience, do not reconnect yet. Note it down for whoever fixes it.
  4. Do not re-import the whole listImporting people who never agreed to marketing is a legal and reputation risk. Keep consent status as it is.
  5. Do not reinstall the integration yetReinstalling can re-send old customers into automations. Ask the person who built the sync first.

When should I bring someone in?

  • Orders and customers are missing and automations depend on them.
  • Consent status looks wrong and you are unsure which contacts may be emailed.
  • The store was moved to a new platform or a new audience.

How do I handle it?

  1. Trace one customer throughI follow one purchase from the store, to the sync, to the contact and its activity, to see where it stops.
  2. Check store, audience and sync stateI confirm which audience the store points to, whether the sync flag is stuck and whether products exist first.
  3. Protect consent firstI never change a person's status to subscribed without a record that they agreed.
  4. Backfill in a controlled batchMissing contacts and orders are added in a small test batch first, checking duplicates and automations before the full run.
  5. Add a daily count checkA simple comparison of store and audience counts warns a named person when they drift.

The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.

What do owners ask about this?

Why are buyers not subscribed?

Mailchimp says a customer with opt_in_status false is added as transactional. That means a purchase record, not permission to send marketing.

Can I switch the store to another audience?

Mailchimp states a store cannot be connected to a different audience once set. A new store connection is needed, and it should be planned.

Do I lose data if I reconnect?

Possibly, or you may create duplicates and re-trigger automations. Ask the person who built the integration to plan it before any reconnect.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.

For your developer: the technical fixes

Next step

Want this off your desk?

Send me a few lines on where things stand. I reply within 24 hours.