Title: RSS Control
Author: Matt Pramschufer
Published: <strong>Gwynngala 24, 2019</strong>
Last modified: Meurth 21, 2026

---

Search plugins

![](https://ps.w.org/rss-control/assets/banner-772x250.png?rev=2859900)

![](https://ps.w.org/rss-control/assets/icon-256x256.png?rev=2859900)

# RSS Control

 By [Matt Pramschufer](https://profiles.wordpress.org/mattpramschufer/)

[Download](https://downloads.wordpress.org/plugin/rss-control.4.0.0.zip)

 * [Details](https://cor.wordpress.org/plugins/rss-control/#description)
 * [Reviews](https://cor.wordpress.org/plugins/rss-control/#reviews)
 *  [Installation](https://cor.wordpress.org/plugins/rss-control/#installation)
 * [Development](https://cor.wordpress.org/plugins/rss-control/#developers)

 [Support](https://wordpress.org/support/plugin/rss-control/)

## Description

RSS Control is a powerful WordPress plugin that allows you to control and customize
your RSS feeds through URL query parameters. These work on all feed types including
the main feed, category feeds, tag feeds, and more.

**Free features** include filtering by category, tag, post type, date range, post
IDs, and offset. You can also control excerpts, display featured images with custom
styling, and include post titles in descriptions.

**Premium features** add support for custom taxonomy filtering, specialized feed
formats (Google Publisher Center, Google News Showcase, NextDoor, Meta Commerce),
call-to-action buttons, primary category output control, custom sort ordering, and
a visual Feed URL Generator in the admin.

### Example

> https://yourdomain.com/feed/?cat=89&days_past=7&show_images=true&image_styles=
> border:4px; border-color:#000; float:left;

The example above will show posts from category 89 from the past 7 days. It will
show featured images with a 4px black border floated to the left.

### Free Options

#### cat

Filter by category ID. Can be a single ID or comma-separated list. Prefix with `-`
to exclude. See https://developer.wordpress.org/reference/classes/wp_query/#category-
parameters

**Example:**

> https://yourdomain.com/feed/?cat=-3,10,22
>  The use of the NEGATIVE in front of
> the category ID says DO NOT INCLUDE posts from category 3.

#### category_name

Filter by category slug. Can be a single slug or comma-separated list. See https://
developer.wordpress.org/reference/classes/wp_query/#category-parameters

**Example:**

> https://yourdomain.com/feed/?category_name=apples,bananas

#### category_not_in

Exclude posts from specified category IDs. See https://developer.wordpress.org/reference/
classes/wp_query/#category-parameters

**Example:**

> https://yourdomain.com/feed/?category_not_in=3,10
>  Display posts that are not 
> in category ids 3 and 10.

#### tag

Filter by tag ID. Can be a single ID or comma-separated list. Prefix with `-` to
exclude. See https://developer.wordpress.org/reference/classes/wp_query/#tag-parameters

**Example:**

> https://yourdomain.com/feed/?tag=-3,10,22
>  The use of the NEGATIVE in front of
> the tag ID says DO NOT INCLUDE posts from tag 3.

#### tag_not_in

Exclude posts with specified tag IDs. See https://developer.wordpress.org/reference/
classes/wp_query/#tag-parameters

**Example:**

> https://yourdomain.com/feed/?tag_not_in=3,10
>  Display posts that do not have any
> of the two tag ids 3 and 10.

#### post_in

Display specific posts by ID in the order specified. See https://developer.wordpress.
org/reference/classes/wp_query/#post-page-parameters

**Example:**

> https://yourdomain.com/feed/?post_in=3,10,22
>  The order in which you add posts
> is the order in which they will appear in the feed.

#### post_type

Filter by post type. Can be a single post type or comma-separated list. Common types
include post, page, attachment, or any custom post type slug. See https://developer.
wordpress.org/reference/classes/wp_query/#post-type-parameters

**Example:**

> https://yourdomain.com/feed/?post_type=page
>  https://yourdomain.com/feed/?post_type
> =post,page Default is “post”.

#### offset

Skip a number of posts from the beginning of the feed. See https://developer.wordpress.
org/reference/classes/wp_query/#pagination-parameters

**Example:**

> https://yourdomain.com/feed/?offset=3
>  This will skip the 3 latest posts and start
> the feed with post 4.

#### days_past

Show posts from the past X number of days only.

**Example:**

> https://yourdomain.com/feed/?days_past=7
>  This will display the posts from the
> last 7 days in a feed.

#### show_images

Display the featured image in the content of the RSS feed.

**Example:**

> https://yourdomain.com/feed/?show_images=true
>  This will display featured image
> in the content of the RSS feed. The default image size is 696×385.

#### image_width

Set the width for the featured image. Requires `show_images=true`.

**Example:**

> https://yourdomain.com/feed/?show_images=true&image_width=300
>  This will set the
> inline style of the image to have width: 300px.

#### image_height

Set the height for the featured image. Requires `show_images=true`.

**Example:**

> https://yourdomain.com/feed/?show_images=true&image_height=300
>  This will set 
> the inline style of the image to have height: 300px.

#### image_size_unit

Set the image size unit for the featured image (px, em, %, fr, etc). Requires `show_images
=true`.

**Example:**

> https://yourdomain.com/feed/?show_images=true&image_width=100&image_size_unit=%
> 
> This will set the inline style of the image to have a width of 100%.

#### image_styles

Set additional inline CSS styles on the featured image. These come before the width&
height. Requires `show_images=true`.

**Example:**

> https://yourdomain.com/feed/?show_images=true&image_styles=border:4px; border-
> color:#000; float:left;
>  This will set the inline style of the image to have a
> black border of 4px and float the image to the left.

#### excerpt_length

Control the length of the excerpt in number of WORDS.

**Example:**

> https://yourdomain.com/feed/?excerpt_length=20
>  This will return all feed items
> with the content of only 20 words.

#### excerpt_more_text

Set the text that appears when content is truncated. Normally it is either […] or…

**Example:**

> https://yourdomain.com/feed/?excerpt_length=20&excerpt_more_text=%5B…Read%20More%
> 5D
>  This will return all feed items with the content of only 20 words ending with[…
> Read More].

#### include_title_in_description

Include the post title in the feed description/content, wrapped in an HTML tag.

**Example:**

> https://yourdomain.com/feed/?include_title_in_description=true
>  This will return
> all feed items with the title present in the description.

#### title_tag

Change the HTML tag that wraps the title. Requires `include_title_in_description
=true`. DO NOT include the < or >, just the tag name.

**Example:**

> https://yourdomain.com/feed/?include_title_in_description=true&title_tag=div
>  
> This will wrap the title in a div tag instead of the default h1.

#### title_styles

Apply inline CSS styles to the title tag. Requires `include_title_in_description
=true`.

**Example:**

> https://yourdomain.com/feed/?include_title_in_description=true&title_tag=div&title_styles
> =float:left;%20margin-right:30px;%20border:1px%20solid%20red;
>  This will apply
> the styles inline to the title tag.

### Premium Options

#### orderby

**INCLUDED IN PREMIUM VERSION**

Sort feed posts by a specified field. Common values: title, date, menu_order, ID,
author. See https://developer.wordpress.org/reference/classes/wp_query/#order-orderby-
parameters

**Example:**

> https://yourdomain.com/feed/?orderby=title
>  Default is “date” (by publish date).

#### order

**INCLUDED IN PREMIUM VERSION**

Set the sort order to ascending or descending. See https://developer.wordpress.org/
reference/classes/wp_query/#order-orderby-parameters

**Example:**

> https://yourdomain.com/feed/?order=ASC
>  Default is “DESC”.

#### current_month

**INCLUDED IN PREMIUM VERSION**

Show only posts from the current month.

**Example:**

> https://yourdomain.com/feed/?current_month=true
>  This will display only posts 
> from the current month in the feed.

#### disable_excerpt

**INCLUDED IN PREMIUM VERSION**

Remove all content/excerpt from feed items entirely.

**Example:**

> https://yourdomain.com/feed/?disable_excerpt=true
>  This will remove the excerpt/
> content from all feed items.

#### td_primary_cat

**INCLUDED IN PREMIUM VERSION**

Filter posts by TagDiv Primary Category. This queries posts where the primary category(
set by TagDiv themes/plugins) matches the specified category ID.

**Example:**

> https://yourdomain.com/feed/?td_primary_cat=53
>  Only works with posts that have
> the TagDiv primary category meta data set. Accepts a single category ID.

#### only_primary_category

**INCLUDED IN PREMIUM VERSION**

Show only the primary category in the feed’s category nodes instead of all categories.
Supports TagDiv, Yoast SEO, and RankMath primary category plugins. If no primary
category is set, falls back to the first category.

**Example:**

> https://yourdomain.com/feed/?only_primary_category=tagdiv
>  https://yourdomain.
> com/feed/?only_primary_category=yoast https://yourdomain.com/feed/?only_primary_category
> =rankmath This modifies the category output in the feed, not the post query.

#### taxonomy

**INCLUDED IN PREMIUM VERSION**

Filter by custom taxonomy slug. Must be used with `taxonomy_term` or `taxonomy_term_not_in`.
You can NOT use negative IDs in taxonomy filtering.

**Example:**

> https://yourdomain.com/feed/?taxonomy=genres&taxonomy_term=2

For filtering by multiple taxonomies simultaneously, use indexed parameters (1 through
10):

> https://yourdomain.com/feed/?taxonomy_1=position&taxonomy_term_1=3350&taxonomy_2
> =region&taxonomy_term_2=2702

#### taxonomy_term

**INCLUDED IN PREMIUM VERSION**

Specify term IDs to include. Can be a single ID or comma-separated list. Must be
used with the `taxonomy` parameter. For multiple taxonomies, use indexed parameters(
taxonomy_term_1, taxonomy_term_2, etc.).

**Example:**

> https://yourdomain.com/feed/?taxonomy=genres&taxonomy_term=2

#### taxonomy_term_not_in

**INCLUDED IN PREMIUM VERSION**

Exclude posts with specified taxonomy terms. Can be a single ID or comma-separated
list. Must be used with the `taxonomy` parameter. For multiple taxonomies, use indexed
parameters (taxonomy_term_not_in_1, taxonomy_term_not_in_2, etc.).

**Example:**

> https://yourdomain.com/feed/?taxonomy=genres&taxonomy_term=2&taxonomy_term_not_in
> =1
>  https://yourdomain.com/feed/?taxonomy_1=position&taxonomy_term_not_in_1=3350,3347&
> taxonomy_2=region&taxonomy_term_not_in_2=2702

#### image_thumbnail_size

**INCLUDED IN PREMIUM VERSION**

Use a specific WordPress image size instead of manually setting width and height.
Adds the image as a `media:content` element in the feed.

**Example:**

> https://yourdomain.com/feed/?show_images=true&image_thumbnail_size=medium
>  This
> will use the medium size image for all featured images. Only valid WordPress thumbnail
> sizes are supported (thumbnail, medium, large, or custom registered sizes). If
> the size is not found, the full size image will be used.

#### include_button

**INCLUDED IN PREMIUM VERSION**

Add a call-to-action button below the excerpt that links to the post.

**Example:**

> https://yourdomain.com/feed/?include_button=true
>  This will output a button that
> says “Read More”.

#### button_text

**INCLUDED IN PREMIUM VERSION**

Change the button text from “Read More” to whatever you would like. Requires `include_button
=true`.

**Example:**

> https://yourdomain.com/feed/?include_button=true&button_text=Click%20Me

#### button_styles

**INCLUDED IN PREMIUM VERSION**

Apply inline CSS styles to the button container. Requires `include_button=true`.

**Example:**

> https://yourdomain.com/feed/?include_button=true&button_styles=border-radius:200px;%
> 20background-color:%23e1005f;%20margin-top:20px;
>  Please note that if you are 
> using colors like #000 then you will need to encode the # symbol as %23.

#### button_text_styles

**INCLUDED IN PREMIUM VERSION**

Apply inline CSS styles to the button text. Requires `include_button=true`.

**Example:**

> https://yourdomain.com/feed/?include_button=true&button_text_styles=font-size:%
> 2018px;
>  Please note that if you are using colors like #000 then you will need
> to encode the # symbol as %23.

#### type

**INCLUDED IN PREMIUM VERSION**

Specify a specialized RSS feed format for different platforms. Supported types: 
gpc, gns, nextdoor, meta-commerce.

**Google Publisher Center (gpc):**

> https://yourdomain.com/feed/?type=gpc
>  Adds the Media RSS namespace, creates full
> content in the content:encoded section, and adds featured image as a media:content
> element.

**Google News Showcase (gns):**

> https://yourdomain.com/feed/?type=gns
>  Adds the required Google News Showcase 
> namespace and elements.

**NextDoor Newsroom (nextdoor):**

> https://yourdomain.com/feed/?type=nextdoor
>  Formats the feed for NextDoor News
> with media elements and featured image support.

**Meta Commerce (meta-commerce):**

> https://yourdomain.com/feed/?type=meta-commerce
>  Uses Google Shopping feed format
> for Meta Shopping campaigns. Articles are formatted as “products” with static 
> values (availability=”in stock”, condition=”new”). Use `meta_price` and `meta_currency`
> to set the price (defaults to “0.00 USD”). Works with all other RSS Control parameters.

#### meta_price

**INCLUDED IN PREMIUM VERSION**

Set the price value for Meta Commerce feed items. Used in the `g:price` element.
Must be used with `type=meta-commerce`.

**Example:**

> https://yourdomain.com/feed/?type=meta-commerce&meta_price=9.99
>  Default is “0.00”.

#### meta_currency

**INCLUDED IN PREMIUM VERSION**

Set the currency code for Meta Commerce feed items (e.g. USD, CAD, EUR, GBP). Used
in the `g:price` element. Must be used with `type=meta-commerce`.

**Example:**

> https://yourdomain.com/feed/?type=meta-commerce&meta_price=9.99&meta_currency=
> CAD
>  Default is “USD”.

All feed types can also be accessed via direct URL:

> https://yourdomain.com/feed/gpc/
>  https://yourdomain.com/feed/gns/ https://yourdomain.
> com/feed/nextdoor/ https://yourdomain.com/feed/meta-commerce/

### Premium Admin Features

The premium version includes the following admin tools, found under **Tools > RSS
Control**:

 * **Feed URL Generator** – Visual form to build feed URLs by selecting parameters
   from dropdowns and inputs. Features AJAX-powered search for posts, categories,
   tags, and post types. Generates a ready-to-use URL with copy and open buttons.
 * **Feed Preview** – Live preview of any feed URL showing the title, first 5 items,
   detected namespaces, media elements, and images.
 * **Parameter Documentation** – Filterable reference for all query parameters with
   examples, grouped by category.

## Screenshots

 * [[
 * [[

## Installation

Upload plugin through Admin > Plugins > Add New or upload directly to /wp-content/
plugins via FTP and activate.

Once activated, you can find the plugin settings under **Tools > RSS Control**.

## FAQ

### I wish this plugin had XYZ feature

While I try to do my best to incorporate new features all the time, I just implemented
a new Feature Request board located at [https://emoxie.com/contact](https://emoxie.com/contact)

### Do you offer support?

Yes, I do the absolute best I can to support the free version of the plugin. If 
you upgrade to the premium version you will have priority support, Google Publisher
Center feed, feed URL generator, more feed options and much more.

### Do I need to URL-encode my parameter values?

Yes, special characters in parameter values should be URL-encoded. For example, #
becomes %23, spaces become %20, and [ becomes %5B. We recommend using https://www.
urlencoder.org/ to encode style values.

### Can I combine multiple parameters?

Yes! All parameters can be combined. For example:

> https://yourdomain.com/feed/?cat=5&days_past=30&show_images=true&excerpt_length
> =50&type=gpc

## Reviews

![](https://secure.gravatar.com/avatar/38dc5cb45bc55da6406da5fb037c403b41aab0e75359ca5c589794547b030eeb?
s=60&d=retro&r=g)

### 󠀁[Add completely flexibility to RSS feeds](https://wordpress.org/support/topic/add-completely-flexibility-to-rss-feeds/)󠁿

 [Eric Shanfelt](https://profiles.wordpress.org/eshanfelt1/) Gwynngala 6, 2022

This is my go-to plugin for media companies wanting to use their RSS feeds for various
purposes … especially for integrating RSS with email newsletters to better automate
email sending. Excellent support, no compatibility issues, and the developer is 
willing to make updates and accept new feature requests as well.

 [ Read all 1 review ](https://wordpress.org/support/plugin/rss-control/reviews/)

## Contributors & Developers

“RSS Control” is open source software. The following people have contributed to 
this plugin.

Contributors

 *   [ Matt Pramschufer ](https://profiles.wordpress.org/mattpramschufer/)
 *   [ emoxie ](https://profiles.wordpress.org/emoxie/)
 *   [ Freemius ](https://profiles.wordpress.org/freemius/)

[Translate “RSS Control” into your language.](https://translate.wordpress.org/projects/wp-plugins/rss-control)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/rss-control/), check
out the [SVN repository](https://plugins.svn.wordpress.org/rss-control/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/rss-control/) by
[RSS](https://plugins.trac.wordpress.org/log/rss-control/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 4.0.0

 * FEATURE – Added post_type parameter for filtering by custom post types
 * FEATURE – Added indexed taxonomy parameters (taxonomy_1 through taxonomy_10) 
   for multiple simultaneous taxonomy filtering
 * PREMIUM FEATURE – Added Meta Commerce feed type for Meta Shopping campaigns
 * PREMIUM FEATURE – Added meta_price and meta_currency parameters for Meta Commerce
   feeds
 * PREMIUM FEATURE – Added TagDiv Primary Category Filter (td_primary_cat parameter)
 * PREMIUM FEATURE – Added Primary Category Output Control (only_primary_category
   parameter) with support for TagDiv, Yoast SEO, and RankMath
 * BUG FIX – Fixed tag parameter not working with tag IDs (now uses tax_query approach)
 * BUG FIX – Fixed category_name parameter causing 404 errors
 * BUG FIX – Fixed category_name dropdown to use slugs instead of IDs
 * BUG FIX – Fixed empty channel link in custom feed templates (GPC, Nextdoor, Meta
   Commerce) caused by Yoast SEO filter conflict
 * UPDATE – Moved admin interface from Settings menu to Tools menu
 * UPDATE – AJAX-powered dropdowns with search capability in feed builder
 * UPDATE – Indexed taxonomy filter support
 * UPDATE – Major architecture overhaul and code optimization
 * UPDATE – Upgraded all composer dependencies
 * UPDATE – Improved excerpt_length test reliability

#### 3.0.16

 * PREMIUM FEATURE – Fixed bug where if using post_image_size it would duplicate
   the images in the content.

#### 3.0.15

 * PREMIUM FEATURE – Added a specific feed for NextDoor News
 * PREMIUM FEATURE – Added in new filter rss_control_include_media_namespaces which
   returns true by default, but if there are other plugins like RankMath that include
   the media namespaces you can disable this.
 * UPDATE – Added additional fallback logic for posts that did not have a featured
   image.

#### 3.0.14

 * UPDATE – Updated all third-party vendor packages

#### 3.0.13

 * FEATURE – Added in the option to generate a rss feed based on specific posts

#### 3.0.12

 * FEATURE – Added option to pass category slugs into query string in addition to
   category IDs.
 * UPDATE – Updated all third-party libraries.

#### 3.0.11

 * UPDATE – Updated all third-party libraries.

#### 3.0.10

 * UPDATE – Updated all third-party libraries.

#### 3.0.9

 * FEATURE – Added in Google News Showcase support for Premium users.

#### 3.0.8

 * UPDATE – Updated third-party vendor libraries to latest versions.

#### 3.0.7

 * FEATURE – Added ability to filter posts just for current month.
 * FEATURE – Added images as media elements

#### 3.0.6

 * UPDATE – Removed the source=news.google.com parameter from GPC feeds as Google
   now no longer allows this.

#### 3.0.5

 * FEATURE – Added ability to change the order and order by values
 * FEATURE – Added the ability to remove the excerpt
 * UPDATE – Updated to latest version of vendor packages

#### 3.0.4

 * UPDATE – Google Analytics will not track encoded UTM variables, and without encoding
   the variables the RSS feeds will be invalid, so we are forced to remove the UTM
   tracking from feed URL and replace with a single ?source=news.google.com instead.

#### 3.0.3

 * BUG FIX – Updated UTM parameters in feed URLs to not be encoded. Previously urls
   with UTM variables were being encoded which didn’t allow for them to be picked
   up properly.

#### 3.0.2

 * BUG FIX – Fixed issue with image_thumbnail_size on edge case setups.

#### 3.0.1

 * BUG FIX – Fixed issue when using tag__not_in and category__not_in.

#### 3.0.0

 * UPDATE – Major Overhaul includes updated how-to section and optimized code.
 * FEATURE – Implemented RSS Feed URL Generator for Premium Users
 * UPDATE – Updated all vendor libraries to their latest versions

#### 2.0.12

 * UPDATE – Automatically append UTM variables to permalinks when using the GPC 
   feed type.
 * UPDATE – Updated third-party vendor libraries.

#### 2.0.11

 * UPDATE – Updated admin help docs to include link to urlencoder.org
 * UPDATE – Added a default 10px margin top to email buttons.

#### 2.0.10

 * FEATURE – Added the ability to filter feed by custom taxonomies
 * FEATURE – Added the ability to include a button to rss excerpts
 * UPDATE – Updated to latest Freemius SDK

#### 2.0.9

 * FEATURE – Added the ability to specify type of feed for Google Publisher Console.
 * FEATURE – Added in extra options for GPC feeds, namespaces, media elements, and
   full content

#### 2.0.8

 * UPDATE – Updated to the latest Freemius SDK

#### 2.0.7

 * UPDATE – Updated to the latest Freemius SDK

#### 2.0.6

 * UPDATE – Updated to the latest Freemius SDK
 * BUG FIX – Fixed php warnings messages

#### 2.0.5

 * UPDATE – When displaying title in description include the permalink to link back
   to post
 * BUG FIX – Adjusted priority on filter to account for when excerpt length and 
   title in description are both active.

#### 2.0.4

 * FEATURE – Added in ability to include title in description
 * FEATURE – Added in ability to change tag wrapping title
 * FEATURE – Added in ability to apply inline styles to title tag
 * UPDATE – Updated to latest Freemius SDK

#### 2.0.3

 * FEATURE – Added in ability to set the excerpt length
 * FEATURE – Added in ability to set the more text when excerpts get truncated

#### 2.0.2

 * Implemented Freemius

#### 2.0.1

 * Initial WP.org version created and pushed to public

## Meta

 *  Version **4.0.0**
 *  Last updated **2 weeks ago**
 *  Active installations **300+**
 *  WordPress version ** 4.0 or higher **
 *  Tested up to **6.7.5**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/rss-control/)
 * Tags
 * [filter rss](https://cor.wordpress.org/plugins/tags/filter-rss/)[google news](https://cor.wordpress.org/plugins/tags/google-news/)
   [rss](https://cor.wordpress.org/plugins/tags/rss/)
 *  [Advanced View](https://cor.wordpress.org/plugins/rss-control/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/rss-control/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/rss-control/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/rss-control/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/rss-control/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/rss-control/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/rss-control/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/rss-control/reviews/)

## Contributors

 *   [ Matt Pramschufer ](https://profiles.wordpress.org/mattpramschufer/)
 *   [ emoxie ](https://profiles.wordpress.org/emoxie/)
 *   [ Freemius ](https://profiles.wordpress.org/freemius/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/rss-control/)