esc
Monitoring & health

Re-syncing and command-line tools

When and how to use Re-sync, plus the CLI commands available to developers and support.

Most of the time you will never open this page. The extension keeps itself in step: it retries, it heals, and it never loses queued work. The tools here exist for two moments: when you deliberately change what should be synced, such as a wider order window, and when support walks you through a recovery. If you find yourself reaching for Re-sync regularly, that is worth a message to support; something upstream deserves a look, and finding it is exactly what we are here for.

Widen your window and it re-queues itself

To reach further back in time, run Re-sync and pick a wider window; the same choices you saw in the Setup Wizard (3, 12, 24, 36, 48 months or everything) are offered there. The extension re-populates the queue in the background as soon as you confirm. Your admin never freezes, and Backfill works through the new records at its usual pace.

It's working: watch the Cron Monitor

After widening the range, open the Cron Monitor tab (Marketing → Intuit Mailchimp → Dashboard). You’ll see the sync jobs running through the new records. Give it time to work through them rather than changing the setting again.

Re-sync: the deliberate do-over

Re-sync re-queues every record for a store so the engine pushes everything again. It is a good tool with a narrow purpose: after you have fixed a data problem in bulk, or when support asks for it. A healthy store never needs it on a schedule; day-to-day correctness is the engine’s job, not yours. And it is always safe on the audience side: a re-sync never changes anyone’s subscription status. Subscribed stays subscribed, unsubscribed stays unsubscribed, always.

To run it, open Marketing → Intuit Mailchimp → Configuration, click Manage Connection, and choose Resync All Data on the Manage tab. Pick your window and confirm.

Command-line tools

These are for developers and ebizmarts support. Run them from your Magento root with php bin/magento.

Command What it does
mailchimp:sync:start Populates the queue for the initial sync, or re-populates it after a reset.
mailchimp:sync:status Shows pending, synced, and error counts per store, so you can see where things stand without opening the admin.
mailchimp:sync:reset Marks records as unsent so they re-queue on the next cron run.
mailchimp:resync --force CLI equivalent of the Resync button. Add --dry-run to preview what would be queued without actually doing it.
mailchimp:queue:drain Clears every pending record from the queue.
mailchimp:migrate:from-mc-magento2 Part of moving over from the previous extension. See Move over from the previous extension.
A support-only command

mailchimp:queue:drain removes every item waiting to sync; they will not reach Mailchimp until they re-queue. Run it only when ebizmarts support asks you to.

Questions along the way? Troubleshooting has the answers, and ebizmarts support is one email away.

Next: Why your numbers differ from MailchimpRevenue and order counts often look different depending on where you look. Here's why each number is correct, and what each one is telling you.