Back to Community
Home / Community / Plugin → Mailchimp for woocommerce

Understanding and Resolving Mailchimp for WooCommerce Action Scheduler Issues

18 threads Sep 10, 2025 Plugin → Mailchimp for woocommerce

Content

If you're using the Mailchimp for WooCommerce plugin, you've likely encountered the Action Scheduler—the system responsible for syncing your store data. While powerful, this system can sometimes run into problems that cause slow performance, stalled syncs, or a massive backlog of tasks. This guide explains why these issues occur and provides the most common solutions to get your sync back on track.

What is the Action Scheduler and Why Does It Cause Problems?

The Mailchimp for WooCommerce plugin uses a library called Action Scheduler to handle data synchronization in the background. This system creates individual tasks (or "actions") for each product, order, or customer that needs to be sent to Mailchimp. For large stores, this can mean thousands or even tens of thousands of tasks.

Common issues include:

  • Sync Stalling or Taking Days: The initial sync, or a re-sync, appears to run indefinitely without completing.
  • Backlog of Tasks: The number of pending actions grows faster than your server can process them, sometimes reaching tens of thousands.
  • Server Resource Strain: The high volume of database queries and processing can slow down your entire site.
  • Conflicts with Other Plugins: The heavy load can prevent other plugins that use Action Scheduler from functioning properly.

These problems often stem from a few key causes: a large store size, limited server resources (especially WP-CRON not running correctly), or bulk operations that trigger a flood of sync tasks.

Common Solutions for Action Scheduler Issues

1. Check Your Server's WP-CRON Configuration

The Action Scheduler relies on WordPress's WP-CRON to process tasks. If your host disables the default WP-CRON and replaces it with a system cron job, the tasks may not be processed consistently. Contact your hosting provider to confirm that WP-CRON is enabled and configured correctly. For sites with a large number of tasks, the Action Scheduler team recommends using WP-CLI for more reliable processing.

2. Run the Action Scheduler via WP-CLI

If the web-based WP-CRON is unreliable, the most effective solution is to process tasks via WP-CLI on the command line. This is more efficient and avoids web server timeouts.

wp action-scheduler run --group="mc-woocommerce"

For a large backlog, you can increase the batch size to process more tasks at once. However, be cautious, as setting it too high could strain your server.

wp action-scheduler run --group="mc-woocommerce" --batch-size=100 --batches=0

Note: Some users have reported a PHP warning (Undefined array key "SERVER_NAME") when running this command. This is a known issue in the plugin's logging code but does not prevent the sync from working.

3. Clean Up Completed Actions

By default, Action Scheduler should automatically trash completed actions after 30 days. If you have a large number of completed actions that are not being cleared, you can manually remove them to reduce database bloat.

You can do this through the WordPress admin area at:
WooCommerce > Status > Scheduled Actions > Completed

From there, you can use the bulk action tool to delete them. For advanced users, the Action Scheduler library provides functions to programmatically clean up tasks.

4. Initiate a Re-Sync (With Caution)

If a sync appears completely frozen, you can try to force a re-sync by appending &resync=1 to your admin URL. This will clear the current sync status and start over.

Warning: Use this carefully on large stores, as it will create a new massive queue of tasks and could take days to complete. It is not a way to "stop" a sync, but to restart it.

5. For Developers: Handle Bulk Operations

If you are running a script that updates thousands of products (e.g., a currency change), the plugin will try to sync each one, creating a huge action queue. The Mailchimp for WooCommerce team has a wiki article that discusses ways to handle this, such as disabling the sync during bulk operations and then triggering a single update later.

When to Seek Further Help

If you have tried these steps and your sync is still not progressing, check the plugin's log for errors (Mailchimp for WooCommerce > Logs). Fatal errors or database deadlocks (as seen in some threads) indicate more serious problems that may require developer intervention.

For issues specifically related to the Action Scheduler library itself (e.g., database errors, execution time bugs), it is recommended to report them on the Action Scheduler GitHub page, as the Mailchimp for WooCommerce team utilizes this third-party library.

Understanding how the Mailchimp for WooCommerce plugin uses the Action Scheduler is key to troubleshooting sync problems. For most users, configuring a server cron job to process tasks via WP-CLI is the most reliable long-term solution for maintaining a healthy sync.

Related Support Threads Support