Troubleshooting

Feed URL Returns a 404

1. If the channel is set to Real-time, confirm pretty permalinks are enabled (Settings → Permalinks, anything other than "Plain"), then re-save permalinks to flush rewrite rules.
2. If the channel is set to Static, confirm it has generated at least once - click Generate Static Feeds Now on the Overview tab.
3. Confirm the channel is actually Enabled on the Channels tab.

Static Feed Not Updating on Schedule

1. WP-Cron only fires on site visits by default - on low-traffic stores this can mean long delays.
2. Check the scheduled event exists: wp cron event list | grep shopfeed.
3. Set up a real system cron hitting wp-cron.php, or trigger a channel manually: wp cron event run shopfeed_generate_google_event.

Products Missing from the Feed

1. Check Exclude out-of-stock on Product Defaults - it may be filtering them out intentionally.
2. Check Included categories on Product Defaults - an empty list means all categories, but a non-empty list excludes anything not in it.
3. Check the Rules tab for an Exclude item from feed rule that matches the product. Use Preview Changes to confirm which rule is responsible.
4. Confirm the product is published, not a draft.

Rule Changes Not Appearing in the Live Feed

1. Confirm you clicked Save Settings - Preview Changes never writes anything.
2. For static feeds, the change only appears after the next regeneration - use Generate Static Feeds Now to apply it immediately.
3. Real-time feeds reflect saved rules on the next request, but responses are cached for 15 minutes.

Compatibility Toggle Is Greyed Out

The corresponding plugin (Yoast/Rank Math, WooCommerce Subscriptions, WPML/Polylang, or Aelia/WOOCS) isn't detected as active. Install and activate it first - the toggle enables automatically once detected.