Documentation

Troubleshooting

Solutions for the most common issues: posts not publishing, auth errors, duplicate posts, missing images, and licensing sync problems.

Posts Are Not Being Published Automatically

Check the following:

  • The provider is set to Active and a schedule interval is selected (scheduling requires Lite+).
  • WordPress cron is running. WordPress cron is only triggered by site visitors, so on low-traffic sites, add a real server cron job: */5 * * * * wget -q -O - https://yoursite.com/wp-cron.php?doing_wp_cron > /dev/null 2>&1
  • Check Ingestics → Logs (Activity Log) for fetch errors.

See Scheduling & Automation for full detail on cron intervals and custom frequency.

The Call Inspector Shows a 401 or 403 Error

Authentication is failing. Verify your API key, token, or OAuth2 credentials. Check that the key has the required permissions on the API side. For Bearer tokens, confirm the token has not expired. See Authentication for setup steps for each auth type.

Duplicate Posts Are Appearing

Check Ingestics → Settings → Deduplication. The Duplicate check fields setting (default: title,url) controls which fields are compared against existing posts. Ensure the field values from your API are stable and unique per item. You can also check which post statuses are included in the duplicate check via Duplicate check statuses.

Images Are Not Being Attached to Posts

Ensure the image URL field is mapped to _thumbnail_id in field mapping. The URL must be publicly accessible — Ingestics downloads the image from your server’s perspective, so local or authenticated URLs will fail. Note the image priority chain: feed image → fallback (Pro+) → stock image (Business, if Stock Image Auto-Attach is configured).

My Paid Plan Is Not Syncing

Ensure your server can make outbound HTTPS requests to api.freemius.com. Some hosts block outbound connections — ask your host to whitelist it, or check with wp_remote_get('https://api.freemius.com') via a test snippet. Your tier is resolved from Freemius plan state, and feature access is enforced by AAPI_Feature_Gate based on the currently resolved tier; if needed, use the License tab status actions to refresh and confirm your current tier.

RSS Full-Text Extraction Items Forced to Draft

If Full-Text Extraction falls back to baseline mode for an item (the article page could not be reliably parsed), that item is automatically forced to Draft for manual review rather than being published automatically. Review such drafts manually in Ingestics → Posts / your WordPress post list.

Diagnosing Skipped or Rejected Items

Use the Activity Log to diagnose why items were skipped (duplicate, filter rejection, no image) or why a fetch failed (auth error, timeout, 429). Each log entry shows timestamp, event type (fetch / publish / error / license check), provider name, status (success / warning / error), and a detail message. See Monitoring & Logs and Content Filters & Duplicate Detection for more.

Debug & Logs

For deeper debugging, enable WP_DEBUG and WP_DEBUG_LOG in wp-config.php. Ingestics writes detailed error traces to the WordPress debug log. Business tier supports audit export in JSON, CSV, and NDJSON formats.