Article RSS Feeds

Last modified March 25, 2020


As of Summer 2019, we’ve deprecated the old way of handling article RSS feeds.

Many publishers are integrating RSS syndication as a part of their distribution strategy. With Turnstyle, we’ve tried to make RSS more flexible so that it can work for different use cases. There are several URL parameters that publishers can use to customize and filter their article feeds.

Enabling RSS for Your Title

For security purposes, RSS feeds are disabled by default. We will enable them upon request for any publisher that wishes to use them. Just contact digitalhelp@gtxcel.com and ask to enable RSS.

Feed Formats

We offer RSS feeds in two formats: RSS and ATOM. For more information on the difference between the two formats, read this article.

Linking to Your Feed

Once RSS is enabled, the URL for a title’s feed will be determined by the format you choose (RSS vs ATOM).

RSS example: www.example.com/title/feed/rss

ATOM example: www.example.com/title/feed/atom

Customizing Your Feed

If you don’t add any parameters to your feed URL, all published articles for all issues will be included. However, publishers have the ability to customize the feed in a few different ways:

Change the number of articles per feed

The URL parameter ‘pageSize’ controls how many articles appear in the feed at one time (the default is 30). So, for example, if you wish to show 50 articles in the feed you’d format it as follows: www.example.com/title/feed/rss?pageSize=50

Sort how the articles appear in the feed

The URL parameter ‘sortBy’ controls how the articles appear in the feed (the default is by publish date/descending). The sort parameter is comprised of two sub-elements: sort value and direction. Combined, these two sub-elements will tell the RSS feed what to sort by, and which direction to sort them.

Example of sortBy using both sub-elements:  sortBy=[sort value]-[sort-direction]

Sort Values

  • issueName
  • publishedDate

Sort Direction

  • desc
  • asc

For example, we know the default sort filer is publishedDate-desc. Let’s say you want to show the oldest articles first. You’d add the parameter publishedDate-asc: www.example.com/title/feed/rss?pageSize=50&sortBy=publishedDate-asc

Specify Categories

By default, articles from all categories will be pulled into the feed. If a publisher wishes to only show articles from a specific category or categories, they should use the ‘categories’ parameter. It can be a single category name or a comma-separated list of categories.

For example, say a publisher wants 50 articles from a category titled ‘Featured’. The URL would be formatted as follows: www.example.com/title/feed/rss?pageSize=50&categories=Featured

Or, if they wanted all articles from two categories: Featured and Groups – they’d format the URL as follows: www.example.com/title/feed/rss/?categories=Featured,Groups

Specify an Issue

Publishers can get an article feed from specific issues by using the ‘issue’ parameter.

Example: Get all articles from the October 2019 issue: www.example.com/title/feed/rss/?issue=october_2019

The issue name can be obtained from your publisher dashboard, or by looking at the live issues URL.

Recent Issues Only

The ‘recentIssues’ parameter should be used when a publisher wishes to pull all articles from only the most recent issues. The default number of issues for this parameter is 5. So for example, if a publisher wishes to pull all articles from the 3 latest issues, they’d format their URL as follows: www.example.com/title/feed/rss/?recentIssues=3

Filtering Covers and Advertisements

Publishers may not want the cover or advertisements to appear in the feed, as they don’t contain any relevant content. These can be filtered using the ‘excludeContentTypes’ parameter as follows: www.example.com/title/feed/rss?excludeContentTypes=cover,advertisement

Need Help?
The Digital Help Desk is the process for communicating with GTxcel regarding new title setups, questions, and technical issues for the Web Reader and/or Apps.

You can submit a request to us through the Request Help button located in the Publisher Dashboard or call the support number: 800-609-8994, option 3.
Contact Us GraphicContact Support
8AM - 5PM EST
Monday to Friday
800-609-8994, option 3
Response Times
General Question/Requests – A Customer Success team Member will begin working on your request within one to two hours of receipt. We will complete the request as soon as possible; we aim to have all requests completed within 24 hours.