Feedzy Troubleshooting Guide

This guide covers the basic checks that we perform when the Feedzy plugin doesn't work as expected.

In case you want more information about the Feedzy RSS Feeds plugin, please refer to the main documentation.

General requirements

1. The feed has to be in an XML format, like this one
2. The feed has to be valid on this website
3. Even if your feed passes standard validators like W3C, it may still cause errors in Feedzy due to the different parsing rules in the SimplePie library. Feedzy uses the Simple Pie library. The feed(s) you want to use need to be compatible with the library.

Displaying feeds

First, please make sure that the general requirements are met.

• In case images are not displayed, you can check if the feed provides them, by searching for: image, PNG, JPG, GIF and other popular image extensions.
• If you are using an editor like Gutenberg or Elementor, and some of the parameters you configured doesn't work as expected, we recommend trying the shortcode approach. Try to use the same options configured in the editor, in a shortcode. How to use Feedzy with a shortcode

Importing feeds

• First please make sure that the general requirements are met.
• Make sure that cron enabled on your website
  1. Install & activate WP-Cron Status Checker plugin
  2. Check the plugin widget in the Dashboard
     
  3. If cron is disabled on your site, we recommend contacting your hosting provider

Nothing was imported

Make sure that you have completed the import wizard, especially the third step. We recommend completing all the fields before saving the import and click run now.

Images weren't imported

The images might not be available in the feed. You can search for popular image extensions. Also, make sure to set the proper magic tags for them.

SVG or unsupported file type errors

If your logs or error-report emails show "Cannot upload the image to Media Library" together with "Sorry, you are not allowed to upload this file type", Feedzy is usually trying to import an SVG image (for example feedzy.svg) as a featured image or fallback image.

WordPress blocks SVG uploads by default, so Feedzy cannot save those files unless SVG uploads are explicitly enabled on your site. Feedzy cannot bypass WordPress Media Library upload rules.

This warning can appear even when the import job still creates posts successfully.

Workarounds

1. If you need SVG featured images, enable SVG uploads with a trusted WordPress plugin that sanitizes SVG files.
2. Replace the fallback/default image with a non-SVG format such as JPG, PNG, or WebP whenever possible.
3. If posts import correctly and featured images are optional for that feed, you can keep your current setup and ignore this warning.

How to verify

1. Run the import job again.
2. Confirm whether new posts were imported successfully.
3. Check whether featured images are required for those items, then verify if your chosen workaround matches that requirement.
4. If the warning remains but imports and front-end output are correct, no further action is required unless you specifically need SVG featured images.

Full post content wasn't imported

This feature is available only in the Developer and Agency subscriptions. The magic tag for importing the full post content is #item_full_content.

To configure the full content import correctly, follow these steps:

1. Confirm your active subscription is Developer or Agency.
2. In Feedzy, go to Feed to Post and open your import job.
3. In the import wizard, navigate to Step 3 – Map Content.
4. In the Content field, set the value to #item_full_content.
5. Save the import job and click Run Now, or wait for the next scheduled run. To test with fresh results, delete previously imported posts before running the job again.

If you have the correct subscription but are still experiencing issues retrieving the full post content, please refer to this guide: How to Import Full Content with Images

Full post content is partial or shorter than expected

If the import runs successfully but the imported content is shorter than the original article, the source feed or source page may be limiting what Feedzy can retrieve.

When you use #item_full_content, Feedzy visits each item's URL and attempts to extract the article content directly from the page. The amount of content available depends entirely on the source:

• Some feeds provide only excerpts, even when mapped to the full-content tag. Feedzy cannot add content that the source does not include.
• Some source pages block or restrict content extraction, for example through paywalls, JavaScript rendering, or bot-blocking. Feedzy can only parse content that is present in the page's HTML source at the time of the request.
• Some pages structure content in ways that prevent full extraction, such as content loaded dynamically via JavaScript or spread across multiple paginated pages.

To check whether the source is limiting the available content:

1. Open the source article URL directly in your browser.
2. Compare the visible content on the page with the imported post in WordPress.
3. If the content matches, Feedzy is working correctly and the limitation is on the source side.
4. If the page shows substantially more content than was imported, contact support with the source URL for further investigation.

📝 Note: Feedzy cannot generate content that is not provided by the source feed or source page. If the source limits the content, no configuration change in Feedzy will produce more content.

For more detail on how #item_content and #item_full_content differ, see What's the difference between Feedzy content and full post content?

AI rewrite or translation adds extra text

When using the Rewrite with AI action in Feedzy with OpenAI or OpenRouter, the AI provider may return more than just the translated or rewritten content. Without explicit instructions, AI models often include explanations, commentary, introductory phrases, notes, or fragments in a different language alongside the actual result.

To prevent unwanted output, your prompt must instruct the AI to return only the modified content. Include a closing constraint such as:

• Translate {content} into English. Return only the translated article text. Do not add explanations, notes, headings, or comments.
• Rewrite {content} in a neutral news style. You must only respond with the modified content.
• Paraphrase {content}. Do not include any preamble, explanation, or commentary. Respond only with the rewritten text.

💡 Tip: Always end your AI prompt with a clear constraint such as "You must only respond with the modified content" or "Return only the translated text". Without this, most AI models will include introductory or explanatory text alongside the actual result.

For more details on setting up AI-powered rewriting and translation in Feedzy, see How to Paraphrase using AI in Feed to Post.

After X hours, no more content was imported

The feeds are automatically checked by the plugin every 60 minutes or according to the schedule you set in the import settings. New content might not be available so soon; therefore, we recommend waiting between 12 and 24 hours to see if new posts are imported, as the plugin checks them for duplicates and pulls only unique posts.

Troubleshooting import jobs with multiple sources

If your import job uses multiple sources — added manually or via a feed group — and results are not as expected, validate each source individually to identify which one is causing the issue. Follow these steps for each source:

1. Open the source URL directly in your browser and confirm the page loads without errors.
2. Confirm the URL points to an XML feed (for example https://wpshout.com/feed/) and not a blog or category page (for example https://wpshout.com/category/news/). A feed URL typically ends with /feed/ or returns raw XML content in the browser.
3. Create a separate import job that uses only that one source. Running a single-source job makes it easier to confirm whether Feedzy can process it correctly.
4. When setting up the test import job, apply these two practices to make troubleshooting easier:
   • Assign imported posts to a dedicated category so they are easy to find once the job runs.
   • In step 3 of the import job, after the Item Content or Item Full Content magic tag, add the Item URL magic tag. This appends a "Read more" link to each imported post so you can compare the imported content against the original source. If elements like the featured image or parts of the content are missing, check the original source post — Feedzy can only import what is provided by the feed.

📝 Note: If all the above steps have been verified and the import still does not work as expected, please contact support at store.themeisle.com/contact.

Some posts are missing or import counts do not match posts created

If the import job runs and reports a count of items processed, but fewer posts appear in WordPress than you expected, there are several possible causes to check.

1. Confirm the feed and cron are healthy

Before investigating individual items, rule out feed-level and schedule-level problems:

1. Validate the source feed URL on https://validator.w3.org/feed/? and confirm it still contains the items you are expecting.
2. Verify that WP-Cron is running correctly — install the WP-Cron Status Checker plugin and check the dashboard widget.
3. Confirm that Feedzy's import filters (keyword filters, date filters, or duplicate-detection settings) are not excluding the items in question.

2. Check the Feedzy logs for item-level errors

If the feed and cron are healthy, item-level errors are the most common reason specific posts are silently skipped. Check the logs:

1. Go to Feedzy > Settings > Logs.
2. Look for error entries that reference the affected feed or time period. Image processing, image download, or upload errors on individual items will appear here.
3. If the log shows no entries, temporarily increase the Logging Level to Error or higher under Feedzy > Settings > General, then run the import job again.

If the log shows image-related errors, see the next section for the recommended workaround.

Image processing errors can block individual imports

When Feedzy tries to download and save a featured image from a remote feed source and that operation fails — for example because the source image URL is broken, the file format is unsupported, or the remote server rejects the download request — Feedzy may skip that individual feed item entirely. This means the import job can appear to run successfully, but specific posts are never created.

This is the most common reason for import counts not matching actual posts when the feed itself is valid and cron is working.

Workaround: use external images or skip the featured image

If your logs show image processing, image download, or image upload errors, try one of these approaches:

1. In your WordPress admin, go to Feedzy > Import Posts.
2. Click Edit on the affected import job.
3. In the import wizard, go to Step 3: Map Content / Content & Image and click the Advanced tab.
4. Enable the Use external images / Use external image URL option to tell Feedzy to reference images at their original source URL instead of downloading them into the Media Library. Alternatively, if featured images are not required for this feed, clear or leave blank the featured image field.
5. Click Save, then click Run Now to re-run the import.

After the job runs, check whether the previously missing posts now appear in WordPress.

⚠️ Important: When you use external images, the images are served directly from the source URL and are not saved to your WordPress Media Library. If the source website later removes or changes those image URLs, the images will stop displaying on your imported posts. Keep this trade-off in mind and use this option when reliable local image storage is not a priority. For more detail on the external image setting, see How to Prevent Duplicate Images in the Media Library with Feedzy.

Enable import error notifications

To catch import failures as soon as they happen — rather than noticing missing posts after the fact — enable logging and error-report emails in Feedzy.

Enable logging

1. Go to Feedzy > Settings > General.
2. Find the Logging Level dropdown.
3. Set it to Error (or higher if you need more detail during active troubleshooting). The Debug level captures the most information but produces larger log files.
4. Click Save.
5. After the next import run, go to Feedzy > Settings > Logs to review the recorded entries. Filter by type to focus on errors.

📝 Note: Set the logging level back to None or Error once your investigation is complete to avoid accumulating large log files.

Enable error-report emails

1. Go to Feedzy > Settings > General.
2. Enable the Report errors via email toggle.
3. Enter an email address in the Email address field, or leave it blank to use the WordPress admin email.
4. Choose a frequency in the Email Reporting Frequency dropdown (Daily or Weekly).
5. Click Save.

Feedzy will now send an email summary of any import errors on the schedule you selected. This makes it easier to spot image or feed failures before they accumulate into a large backlog of missing posts.

Admin UI and JavaScript Issues

If Feedzy settings pages are unresponsive, pop-ups fail to open, or clicks on options like magic tags have no effect, the cause is usually a JavaScript conflict between Feedzy and another plugin on your site. Optimization plugins, security plugins, and scripts that minify or combine JavaScript are the most common sources of this type of conflict.

Check the browser console for JavaScript errors

Before isolating plugins, confirm that a JavaScript error is responsible:

1. Open the Feedzy settings page or the page where the issue occurs.
2. Press F12 (or Cmd + Option + I on Mac) to open your browser's developer tools.
3. Click the Console tab.
4. Look for red error messages. These errors identify the script or plugin causing the conflict.

If you see JavaScript errors in the console, proceed with the plugin isolation steps below.

Isolate the conflicting plugin using Health Check & Troubleshooting

The Health Check & Troubleshooting plugin lets you deactivate all other plugins temporarily without affecting your live site. This makes it easy to confirm whether a plugin conflict is causing the issue.

1. Install and activate the Health Check & Troubleshooting plugin from Plugins > Add New.
2. Go to Tools > Site Health and click the Troubleshooting tab.
3. Click Enable Troubleshooting Mode. This deactivates all plugins except the ones you allow, but only in your browser session — your visitors are not affected.
4. In troubleshooting mode, make sure only Feedzy RSS Feeds (and Feedzy Pro, if you use it) are active.
5. Open the Feedzy settings page and test whether the issue is resolved.

📝 Note: Troubleshooting mode only affects your browser session. Your site continues to run normally for all other visitors while you test.

Identify the conflicting plugin

If the settings work correctly with only Feedzy active, another plugin is causing the conflict. Reactivate your other plugins one at a time to identify which one triggers the issue:

1. In the Health Check & Troubleshooting panel, reactivate one plugin at a time.
2. After each reactivation, reload the Feedzy settings page and test whether the issue reappears.
3. When the issue returns, the plugin you just reactivated is the source of the conflict.

Once you have identified the conflicting plugin, check whether it has settings to exclude Feedzy admin pages from JavaScript minification, combination, or other optimizations. Excluding Feedzy from those rules typically resolves the conflict.