Themeisle Docs

Appearance

feedzy-rss-feeds

Manually cleaning feeds? Still? Go Pro to filter by keyword, auto-clean old posts, and set fallback images automatically.

See Pro Plans →

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.

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].

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

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.

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.