Themeisle Docs

Appearance

Feedzy RSS Feeds - Settings Reference ​

Feedzy RSS Feeds is a WordPress RSS feed aggregator plugin that lets you display, filter, and import RSS feed content into your site as posts, pages, or custom post types. You can find the plugin settings under Feedzy > Settings and Feedzy > Integrations in the WordPress admin menu, with additional per-job settings inside the Feedzy > Import Posts editor.

Settings > General ​

Choose a default image to display when RSS feeds do not include images. Click Choose image to open the WordPress media library and select an image. Once set, the button changes to Replace image and a Remove button appears. This image is used as the fallback across all shortcodes, blocks, and widgets unless overridden at the individual feed level. If you do not set a fallback image and a feed item has no image, the feed item will display without one (or use the per-shortcode default image if set).

Disable default style ​

When you enable this toggle, the plugin stops loading its built-in CSS and instead inherits your theme's styles for feed output. This is useful if you want full control over the look of feed displays through your theme's stylesheet. When this global toggle is off, the individual widget, block, or shortcode-level "disable default style" setting is respected instead.

Auto Categories Mapping ​

Define keyword-to-category mappings that automatically assign categories to imported posts based on their titles. Each row has a Keywords text field (comma-separated values) and a Category dropdown. When an imported post title contains one of the listed keywords, the plugin assigns the corresponding category. Use the plus sign (+) between keywords to require all of them to match. Click Add New to create additional mapping rows, or Delete to remove a row. You must add the [#auto_categories] tag to the category field of your import job for this feature to take effect.

Default Importing Schedule ​

This setting only appears when the Pro add-on is active.

Select the default cron schedule used for new import jobs. The dropdown lists all registered WordPress schedules (hourly, daily, twice daily, weekly, and so on). Schedules created by other plugins or manually are marked "(externally created)." Individual import jobs can override this default with their own schedule setting.

Logging Level ​

Control how much detail the plugin records in its log file. Options range from None (no logging) through Error, Warning, and Info up to Debug (the most verbose). Set a higher level when troubleshooting feed import issues, and lower it again afterward to avoid large log files. When a log file exists, its size is shown next to the dropdown along with a Delete button to clear it.

Report errors via email ​

Enable this toggle to receive email alerts when feed errors occur. When enabled, two additional fields appear below.

Email address ​

This field only appears when "Report errors via email" is enabled.

Enter the email address that should receive error reports. If left blank, the WordPress admin email address is used as the default.

Email Reporting Frequency ​

This field only appears when "Report errors via email" is enabled.

Choose how often error report emails are sent. Options are Daily and Weekly. Pick weekly if you prefer fewer notifications, or daily if you need to catch problems quickly.

Enable Telemetry ​

When enabled, the plugin sends anonymous data about your plugin settings to Themeisle to help measure feature usage. No sensitive information is collected, and data is not shared with third parties. Disable this if you prefer not to share any usage data.

Settings > Proxy ​

This tab lets you configure a proxy server for all outgoing feed requests. Use it to bypass firewalls, geographic restrictions, or IP blocks imposed by feed sources. A link to the proxy setup guide is shown at the top of the page.

Username ​

Enter the username required to authenticate with your proxy server. Leave blank if your proxy does not require authentication.

Password ​

Enter the password for the authorized proxy user. This field is masked for security.

Host ​

Enter the IP address or domain name of the proxy server (for example, 127.0.0.1). All feed fetch requests will be routed through this host when a value is provided.

Port ​

Enter the port number your proxy server listens on (for example, 8080). Accepts values from 0 to 65535.

Settings > Logs ​

This tab displays a read-only log viewer showing up to 50 recent log entries. You can filter entries by log type using the dropdown at the top. No settings are saved on this tab — logging level and email reporting are configured on the General tab.

Settings > Schedules ​

This tab is labeled "PRO" and its content requires the Pro add-on to be active.

This tab displays and manages the cron schedules used by the plugin's import jobs. Here you can set up a custom cron job by entering these settings:

  • Interval (seconds)
  • Display Name
  • Internal Name

All custom cron jobs will be diplayed in a table on this page. You can delete any job by clicking on the 'Delete' button next to it's name.

Settings > Miscellaneous ​

Add canonical URL to imported posts from RSS feeds ​

When enabled, the plugin adds a <link rel="canonical"> tag pointing to the original source URL on each imported post. This tells search engines that the original article is the authoritative version, which helps avoid duplicate content penalties in search rankings. Enable this if you are importing full content and want to credit the original source for SEO purposes.

When enabled, the plugin removes featured images from your own site's RSS feed output. This controls whether images appear in the XML feed that other services (or other Feedzy installations) consume from your site. Enable this if you want a text-only RSS feed or if the images are causing issues for downstream consumers.

User Agent ​

Specify a custom User-Agent string that the plugin sends when fetching RSS feeds. Some feed providers block automated requests that use the default WordPress user agent. If you are having trouble accessing a particular feed, try setting this to a common browser string like Mozilla/5.0. In most cases, you can leave this field empty.

Delete the posts created from all feeds, after a number of days ​

This setting only appears when the Pro add-on is active.

Enter the number of days after which imported posts should be automatically deleted. Set to 0 to disable automatic deletion globally (individual import jobs may still have their own deletion settings). This is helpful for keeping your site free of stale content when you import time-sensitive items like news or deals.

This setting only appears when the Pro add-on is active and the delete-days setting above is greater than 0.

When enabled, the plugin also removes the featured image from the media library when an imported post is automatically deleted. Enable this to prevent orphaned images from accumulating in your media library over time.

Integrations > OpenAI ​

This tab only appears on the Feedzy > Integrations page when you have a Developer or Agency Pro license activated. Without a Pro license, the tab appears but the Validate & Save button is disabled.

The OpenAI account API key ​

Paste your OpenAI API key here to enable AI-powered content features in your import jobs, such as title rewriting, content summarization, and image generation via DALL-E. You can generate a key from the OpenAI platform under API keys. The plugin validates the key when you click Validate & Save and displays the API status (Valid or Invalid) along with the date of the last check. If the key is invalid or expired, import jobs that rely on OpenAI magic tags will fail silently and return unprocessed content.

The OpenAI model ​

Choose which OpenAI model the plugin uses for text generation tasks. Models are split into two groups: Latest models (currently gpt-5-nano, gpt-5-mini, gpt-5, gpt-4.1-nano, gpt-4.1-mini, gpt-4.1, gpt-4o-mini, gpt-4o, o4-mini, o3-mini, o1-pro, o1) and Deprecated models (gpt-4, gpt-3.5-turbo-instruct, babbage-002, davinci-002). More capable models produce higher-quality output but cost more per API call. If you select a deprecated model, it may stop working when OpenAI retires it. A link to OpenAI's pricing page is provided below the dropdown for reference. The status line beneath the dropdown shows whether the currently selected model validated successfully and when the last check occurred.

Integrations > OpenRouter ​

This tab only appears on the Feedzy > Integrations page when you have a Developer or Agency Pro license activated.

The OpenRouter account API key ​

Enter your OpenRouter API key to use OpenRouter as an alternative AI provider for content processing in import jobs. You can obtain a key from the OpenRouter dashboard. The plugin validates the key when you click Validate & Save and displays the connection status below. OpenRouter can be selected as the AI provider on individual import jobs to use models not available through OpenAI directly.

The OpenRouter model ​

Type the full model identifier you want to use from OpenRouter's catalog (for example, anthropic/claude-3-opus). Unlike the OpenAI setting, this is a free-text field because OpenRouter offers a large and frequently changing set of models. A link to OpenRouter's models page is provided so you can browse available options and their pricing. The status line beneath the field confirms whether the model name and API key validated successfully.

Integrations > Amazon Product Advertising ​

This tab only appears on the Feedzy > Integrations page when you have a Developer or Agency Pro license activated.

This tab configures the Amazon Product Advertising API, which lets you use Amazon product URLs as feed sources in Feedzy. A usage note at the top explains the two supported URL formats: amazon.[extension]?keyword=Laptop for keyword searches, and amazon.com?asin=ASIN_1|ASIN_2 for specific product lookups.

Access Key ​

Enter the Access Key from your Amazon Product Advertising API credentials. You can obtain this from the Amazon Associates or AWS console. Without a valid access key, Amazon product feed sources will not return any results.

Secret key ​

Enter the Secret Key that pairs with your Access Key. This is used to sign API requests to Amazon. Keep this value confidential; it is stored as a masked password field in the admin.

Host ​

Select the Amazon marketplace domain that matches your Associates account. The dropdown lists all available Amazon locale hosts (amazon.com, amazon.co.uk, amazon.de, amazon.co.jp, and so on). You must choose the host that corresponds to the marketplace where your partner tag is registered; using the wrong host will cause API requests to fail.

Region ​

Select the AWS region that corresponds to your chosen host. Each Amazon marketplace maps to a specific AWS region (for example, amazon.com uses us-east-1). If you change the host, you should also update the region to match.

Partner Tag (store/tracking id) ​

Enter your Amazon Associates partner tag (also called a store or tracking ID). This tag is appended to product links so that you earn affiliate commissions on qualifying purchases. The API status and last-check timestamp appear beneath this field, along with any error messages returned by Amazon during validation. Click Validate & Save to test all five Amazon settings together.

Integrations > SpinnerChief ​

This tab only appears on the Feedzy > Integrations page when you have an Agency Pro license activated.

SpinnerChief API key ​

Enter your SpinnerChief API key to enable text-spinning capabilities in import jobs. When configured, you can use SpinnerChief-specific magic tags in your import job content templates to automatically spin imported text into unique variations. The API status (Valid or Invalid) and the date of the last validation check appear beneath the field. Click Validate & Save to test the connection. This integration is available exclusively on the Agency plan.

Integrations > WordAI ​

This tab only appears on the Feedzy > Integrations page when you have an Agency Pro license activated.

The WordAi account email ​

Enter the email address associated with your WordAI account. This is used together with the API key below to authenticate requests to the WordAI service.

The WordAi account API key ​

Enter your WordAI API key to enable AI-powered text rewriting in import jobs. Once configured, you can use WordAI-specific magic tags in your import content templates. The API status and last-check date appear beneath the field. Click Validate & Save to verify both your email and API key. This integration is available exclusively on the Agency plan.

Import Job Editor ​

These settings appear when you create or edit an import job at Feedzy > Import Posts. The editor is organized into collapsible steps.

Step 0: Import Name ​

A text filed where you can enter the name for your import.

Step 1: Sources configuration ​

RSS Feed Sources ​

Enter one or more RSS feed URLs, separated by commas, or check "Use Feed Group" to select a previously created feed group from a dropdown. Click Validate to test whether the URLs return valid feed data. Invalid feeds will not display items. If you have not created any feed groups yet, a link to the Feed Groups screen is shown.

Step 2: Filters ​

This step contains keyword and date filters for controlling which feed items are imported. The controls are loaded dynamically within the accordion.

You can select how filters apply in the 'Include If' dropdown. It has two options:

  • All conditions are met
  • Any condition is met

Each filter has three fields:

  • Field
  • Compare operator
  • Value

Available filter fields are:

  • Title
  • Description
  • Full Content
  • Author
  • Date
  • Featured Image
  • Link

Step 3: Map Content ​

This step controls how feed data maps to WordPress post fields. It has two sub-tabs: General and Advanced.

General ​

Post Type ​

Select the WordPress post type to create when the import runs. Options include post, page, and any registered custom post types. Choose the type that best matches how you want imported content to appear on your site.

Post Taxonomy ​

Select one or more taxonomies (categories, tags, or custom taxonomies) to assign to imported posts. If you do not select at least one taxonomy, posts are assigned to "Uncategorized" by default. Two special options appear at the bottom of the list: "Item Categories" (which creates categories matching the feed's category data) and "Auto Categories by keyword" (which uses the keyword mappings you configured under Settings > General > Auto Categories Mapping).

Post Status ​

Choose whether imported posts are published immediately (Published) or saved as Draft for manual review before publishing.

Post Title ​

Define the title for imported posts using one or more magic tags. You can drag and drop multiple tag fields and reorder them. Click the settings icon on a tag to attach actions (such as AI rewriting). This field is mandatory — without a title, no post is created.

Post Date ​

Set the publication date for imported posts using magic tags or leave blank to use the current date and time when the import runs.

Content ​

Define the body content of imported posts using magic tags. You can combine multiple tags with static text. This field is mandatory. Some magic tags (like [#item_full_content]) require a Developer or Agency Pro license. Click the settings icon on a tag to attach actions.

Set the featured image for imported posts using a magic tag, a direct URL, or leave it blank to fall back on the default image settings. The available magic tags for images are shown in a dropdown. Click the settings icon on a tag to attach actions.

Advanced Options ​

External image ​

When enabled, the plugin uses the external URL of the feed item's image directly instead of downloading it to your WordPress media library. This saves disk space and speeds up imports but means the image is served from the original source, which may go offline or change.

Post Author ​

Select which WordPress user is assigned as the author of imported posts. By default, this is set to your current account. Below the dropdown, two checkboxes control how the original feed author's name is handled: Save it in Backend stores the source author for display in the Dashboard, and Save it in Frontend displays the source author on archive pages. This setting requires the Pro add-on.

Post Excerpt ​

Define the excerpt for imported posts using magic tags. This works only for single feeds, not feed groups. Leave blank if you do not need a custom excerpt.

Custom Fields ​

This section requires the Pro add-on. Magic tag parsing in custom field values requires a Developer or Agency license.

Add custom field mappings to each import job. Each row has a Key Name text input (the post meta key) and a Value text input (which can contain plain text or Feedzy magic tags like [#item_custom_price]). Click the add button to create additional rows and the remove button to delete one. You can also attach an action to each custom field to further process the value (for example, running it through an AI service).

Item Full Content Language ​

This field only appears when you have a Developer or Agency Pro license activated.

When you use the [#item_full_content] magic tag to import full article content (rather than just the RSS summary), you can specify the language of the source website here. The plugin uses this hint when fetching and parsing the full page content. The default is English. Change this if you are importing from non-English sources and the full-content extraction is returning garbled or incomplete text.

Step 4: General Feed Settings ​

This step has two sub-tabs: General and Advanced.

General ​

Number of items to import ​

Set how many feed items to import each time the job runs. Increase this if you want to pull more items per run, or decrease it to limit the volume of imported content.

Import schedule ​

Select how often this import job runs. The dropdown lists all registered WordPress cron schedules. Schedules created by other plugins are marked "(externally created)." This overrides the global default importing schedule for this specific job.

Fallback Image ​

Choose which fallback featured image to use when a feed item has no image. You can either use the global fallback set under Settings > General (which updates automatically if you change the global setting) or upload a custom fallback image specific to this import job.

Advanced ​

Remove Duplicate Items ​

When enabled, the plugin checks whether an item has already been imported (based on its title and URL by default) and skips it if so. This prevents the same content from being imported multiple times across runs.

Set a custom duplication key ​

This setting requires the Pro add-on.

Define a custom key for identifying unique feed items, overriding the default title-plus-URL check. Enter one or more magic tags to specify which feed fields should be compared. This is useful when feeds contain items with identical titles but different content, or when URLs change between runs.

Strip HTML Tags ​

When enabled, the plugin removes all HTML tags from imported feed content, producing clean plain-text output. This is useful for feeds that contain unexpected or unsafe markup that could break your post layout.

Feed Order ​

Control the order in which feed items are processed during import. Options are: the original feed order (default), latest items first, or oldest items first.

Assign Language ​

This setting requires the Pro add-on.

Select a language to assign to imported posts. This is used for auto-translation features when configured.

Shortcode / Block Settings ​

These settings appear when you insert a Feedzy RSS Feeds shortcode via the TinyMCE button, as a Gutenberg block, or as a classic widget. They control how feed items are displayed on the front end of your site.

Feed Source ​

The feed(s) URL ​

Enter one or more RSS feed URLs separated by commas. You can also enter a Feedzy Feed Groups slug. Click the validation link to check whether the feed is valid before inserting.

Number of items to display ​

Set how many feed items to show. The default is 5. Adjust this based on how much space you want the feed to occupy.

Ignore the first N items of the feed ​

Skip a number of items from the start of the feed. Set to 0 (the default) to begin from the first item. Set to 5, for example, if you want to start displaying from the sixth item. Useful for showing different slices of the same feed in multiple shortcodes on one page.

Should we display the RSS title? ​

Choose whether to show the feed's title above the list of items. Select "Yes" to display it or "No" to hide it.

For how long we will cache the feed results ​

Choose how long the plugin caches the fetched feed data before making a new request. Options range from 1 hour to 15 days, with a default of 12 hours. Shorter intervals keep content fresher but increase server load.

Sorting order ​

Control the display order of feed items. Options are Default (the feed's natural order), Date Descending, Date Ascending, Title Descending, and Title Ascending.

Message to show when feed is empty ​

Enter a custom message to display when the feed returns no items. If left blank, the default message "Feed has no items." is shown.

Lazy load the feed ​

When set to "Yes," the feed content loads asynchronously after the page has rendered, which prevents the feed fetch from slowing down page load time. Useful for pages with multiple feeds or slow feed sources.

Disable default style ​

When set to "Yes," the plugin does not apply its built-in CSS to this particular feed display. Use this if you want to style the output entirely with your own CSS. This per-instance setting is independent of the global disable-default-style toggle under Settings > General.

Wrap custom class ​

Add a custom CSS class to the outer wrapper of the feed output. Use this to target the feed with specific styles in your theme's stylesheet.

Item Options ​

Choose where feed item links open. Options include the same window, a new tab (_blank), or a named frame. The default is "Auto," which lets the browser decide.

When set to "Yes," all feed item links include the rel="nofollow" attribute. Enable this if you do not want to pass SEO link equity to the linked sites.

Trim the title ​

Limit the displayed title to a set number of characters. A value of 0 removes the title entirely. Leave blank to show the full title.

Meta fields ​

Enter a comma-separated list of meta fields to display beneath each item, in the order they should appear. Available fields include author, date, time, and tz=local (to show the date in the visitor's local timezone). Leave blank to hide all meta information.

Multiple meta ​

When displaying items from multiple feed sources, enter source here to show the feed title as an additional meta field for each item. This helps visitors identify which feed each item came from.

Should we display a description? ​

Choose whether to show a summary or excerpt of each feed item beneath its title.

Crop description ​

Limit the displayed description to a set number of characters. Leave blank to show the full description as provided by the feed.

Only display item if selected field contains keyword(s) ​

Enter keywords to filter items for inclusion. Separate multiple keywords with commas (matching any), or use the plus sign (+) to require all connected keywords to appear together.

Select a specific item for include keyword filter ​

Choose whether the include keyword filter above checks the item's Title, Description, or Author field.

Exclude items if selected field contains keyword(s) ​

Enter keywords that cause matching items to be hidden. Uses the same comma and plus-sign syntax as the include filter. This field is disabled in the free version and requires the Pro add-on.

Select a specific item for exclude keyword filter ​

Choose whether the exclude keyword filter checks the item's Title, Description, or Author field.

Image Options ​

Should we display the first image of the content? ​

Control whether feed item images are shown. "Yes (without a fallback image)" shows images only when the feed provides them. "Yes (with a fallback image)" uses a fallback when no feed image is available. "No" hides all images.

Fallback image ​

Select or enter the URL of a fallback image to use when a feed item has no image. Click Select from Gallery to choose from your media library.

Thumbnails dimension ​

Set the display size of feed item thumbnails in pixels (for example, 150). Do not include "px" — enter the number only.

How should we treat HTTP images? ​

Choose how the plugin handles images served over plain HTTP (not HTTPS). "Show with HTTP link" displays them as-is, "Force HTTPS" rewrites the URL to HTTPS (which may break if the image server does not support it), and "Ignore and show default image" replaces them with the fallback image. This is relevant if your site uses HTTPS and you want to avoid mixed-content warnings.

Pro Options ​

These fields are disabled in the free version and require the Feedzy RSS Feeds Pro add-on.

Price ​

Controls whether product prices are displayed for each feed item. When set to "yes," the plugin extracts price data from standard product feed formats (Google Shopping, eBay, or a plain <price> element). Set to "no" to hide prices, or "auto" to show them only when price data is detected. This setting is most useful with e-commerce or product comparison feeds.

Referral URL ​

Appends referral or affiliate tracking parameters to each feed item link. You can enter query string parameters (for example, utm_source=feedzy&utm_medium=rss) which will be appended to item URLs, or use the #url# placeholder to wrap the entire item URL inside a redirect structure (for example, https://yoursite.com/go?url=#url#). Leave blank to use the original item URLs unmodified.

Columns ​

Sets the number of columns for a grid layout when displaying feed items. The default is 1 (a single-column list). Increase this to display items in a multi-column grid, which is useful for card-style or magazine layouts.

Mapping ​

Map custom XML tags from the feed to Feedzy display components. Use the format component=tagName where component is the display element (for example, price) and tagName is the XML element name in the feed. Separate multiple mappings with commas (for example, price=g:price,brand=g:brand). For feed-level tags, prefix the tag with feed| (for example, price=feed|channel_price). This requires a Developer or Agency license.

Template ​

Select a custom display template for the feed output. Built-in options include "default," "style1," and "style2." You can also create your own template by placing a PHP file in your theme's feedzy_templates directory. Leave blank to use the default template.

Date Range Filter (Pro) ​

This section is added by the Pro plugin and is disabled in the free version.

From ​

Set the start date and time. Only feed items published on or after this date and time will be displayed. Leave blank to impose no lower bound.

To ​

Set the end date and time. Only feed items published on or before this date and time will be displayed. Leave blank to impose no upper bound. Combining this with the From field lets you show items from a specific time window.

Elementor Widget: Feedzy Loop ​

This widget only appears in the Elementor editor when both Feedzy RSS Feeds Pro and Elementor Pro are active.

Config Feedzy RSS Feeds ​

Feed Source ​

Enter one or more RSS feed URLs separated by commas, or enter a Feedzy Feed Groups slug. This determines which feeds the widget pulls items from.

Number of items to display ​

Set how many feed items to show. The default is 5.

Ignore the first N items of the feed ​

Skip a number of items from the beginning of the feed. Set to 0 (the default) to start from the first item. This is useful when you use multiple Feedzy widgets on the same page and want each to show a different slice of the same feed.

Summary Length ​

Crop each item's description after a specified number of characters. Leave blank to show the full summary as provided by the feed.

For how long we will cache the feed results ​

Choose how long the plugin caches the feed data before fetching it again. The default is 12 hours. Shorter intervals keep content fresher but increase load on the feed source.

Filter items ​

Display items if ​

Choose whether to filter items for inclusion based on their Title, Description, or Author field.

Contains (include) ​

Enter keywords that must appear in the selected field for an item to be displayed. Separate multiple keywords with commas to match any of them, or use the plus sign (+) to require all connected keywords to appear together.

Exclude items if ​

Choose whether to filter items for exclusion based on their Title, Description, or Author field.

Contains (exclude) ​

Enter keywords that, when found in the selected field, cause the item to be hidden. The same comma and plus-sign syntax applies as in the include filter.

Filter items by time range, from ​

Set the earliest publication date and time for items to display. Items published before this date are hidden.

To ​

Set the latest publication date and time for items to display. Items published after this date are hidden.

Template ​

Choose Template ​

Select an Elementor template of the "feedzy-loop" type to control how each feed item is rendered. You must first create a Feedzy Loop template in the Elementor template library. If no template is selected, the widget displays nothing.