You open your StockOracle AI dashboard expecting to see updated inventory health scores, reorder alerts, and demand forecasts. Instead, you see stale data from three days ago. Or worse — nothing at all.

If your StockOracle AI plugin has stopped syncing orders, products, or inventory levels, you’re not alone. Sync issues are the most common support ticket we see, and 90% of the time they’re caused by one of seven things you can fix in under 10 minutes.

Let me walk you through each one, starting with the most likely culprit.

1. WooCommerce HPOS Compatibility Mode

StockOracle AI is fully compatible with WooCommerce High-Performance Order Storage (HPOS). But here’s the catch: if you recently enabled HPOS on an existing store, or if you’re running a custom setup that toggles between legacy and HPOS tables, the plugin might be reading from the wrong data source.

The fix: Go to WooCommerce → Settings → Advanced → Features. Make sure HPOS is enabled and that “Use the high-performance order storage” is checked. Then go to StockOracle AI → Settings and click “Force Resync.”

If you’re still on legacy order tables, StockOracle AI falls back automatically — but the sync might be slower. For best performance, stick with HPOS.

2. WordPress Cron Not Running

StockOracle AI relies on WordPress cron to process background sync jobs. If your cron system is broken — which happens on many shared hosts — the plugin never gets the signal to pull new order data.

How to test: Install a free plugin like WP Crontrol and check if the hook stockoracle_process_sync is scheduled. If it’s stuck in the past, your cron is broken.

The fix: Set up a real server-side cron by adding this line to your wp-config.php:

define('DISABLE_WP_CRON', true);

Then set a real cron job on your server (cPanel, cron job, or via your host) to hit https://yoursite.com/wp-cron.php every 5 minutes. This solves 80% of sync delays.

3. Plugin or Theme Conflict

Another plugin — especially caching plugins, security plugins, or other inventory tools — can block StockOracle AI from reading order data. We’ve seen conflicts with WP Rocket, Wordfence, and ATUM Inventory in particular.

The fix: Temporarily deactivate all plugins except WooCommerce and StockOracle AI. If sync starts working, reactivate plugins one by one to find the conflict. Add the conflicting plugin’s URL or query string to its exclusion list.

For caching plugins, exclude the /wp-json/stockoracle/ endpoint from cache.

4. Missing or Corrupted Order Data

StockOracle AI reads from wc_order_product_lookup (HPOS) or the legacy order meta tables. If those tables are missing data — due to a failed WooCommerce update, a migration, or a plugin that deleted order meta — the sync returns zero results.

The fix: Run a quick SQL query via phpMyAdmin or WP Admin — go to WooCommerce → Status → Tools and click “Re-sync order data.” This rebuilds the lookup tables. Then trigger a manual sync in StockOracle AI.

5. License Key Expired or Invalid

StockOracle AI Pro requires a valid license key to enable sync features. If your subscription expired or the key was entered incorrectly, the plugin falls back to free mode — which still syncs, but with limited frequency.

The fix: Go to StockOracle AI → License. Check if the status says “Active.” If it shows “Expired” or “Invalid,” re-enter your license key from your Themefreex account. If you need to renew, head to StockOracle AI Pro and grab a new license.

6. Server Memory or Execution Time Limits

If you have a large catalog (5,000+ products) or high order volume, the sync process can exceed PHP memory limits or max execution time. This silently fails — no error message on the dashboard.

The fix: Increase PHP memory to at least 256MB and max execution time to 300 seconds. Add these lines to wp-config.php:

define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_EXECUTION_TIME', 300);

If you’re on a shared host, contact support to increase these limits. For larger stores, consider upgrading to a VPS.

7. Webhook or API Rate Limiting

StockOracle AI uses internal WordPress REST API endpoints to sync data. If you have a security plugin that rate-limits API calls (like Wordfence or iThemes Security), or if your host throttles API requests, the sync gets blocked.

The fix: Whitelist the /wp-json/stockoracle/ namespace in your security plugin. If you use Cloudflare, make sure API requests aren’t being cached or blocked. Test by temporarily disabling the security plugin — if sync works, you’ve found the issue.

When All Else Fails: Manual Reset

If none of the above works, do a full reset:

1. Deactivate and delete StockOracle AI from Plugins.
2. Reinstall from your Themefreex account.
3. Reactivate and re-enter your license key.
4. Go to StockOracle AI → Settings and click “Force Full Resync.”

This clears any corrupted data and starts fresh. Your historical order data remains safe in WooCommerce.

Preventing Future Sync Issues

Once your sync is working, take these steps to keep it running:

• Monitor cron: Check WP Crontool weekly to ensure stockoracle_process_sync runs on schedule.
• Keep plugins updated: StockOracle AI updates regularly to stay compatible with WooCommerce and WordPress core.
• Use a staging site: Test plugin updates and WooCommerce version changes on a staging site before pushing live.
• Enable error logging: Add define('WP_DEBUG_LOG', true); to wp-config.php and check /wp-content/debug.log if sync stops again.

Get Back to Accurate Inventory Management

Sync issues are frustrating, but they’re almost always fixable with one of these steps. Once your data is flowing again, StockOracle AI will automatically calculate reorder points, detect dead stock, and forecast demand — saving you hours of manual spreadsheet work.

If you’re still stuck after trying all seven fixes, contact our support team. We respond within 24 hours and can dig into your server logs to find the root cause.

In the meantime, explore StockOracle AI Pro to unlock AI-powered demand forecasting, purchase order automation, and multi-warehouse support — all built to prevent stockouts and overstocking.