The RSS guidelines below are designed to deliver a high-quality, honest reading experience to our readers. Following the guidelines outlined in this document ensures that your content is delivered via Flipboard in a timely and accurate manner. These recommendations are based on open Internet standards and best-practices. Content that works well on Flipboard works well on the web in general.
Follow the guidelines below to optimize the presentation of your content on Flipboard. For other publishing related questions, see our Publisher Q&A.
RSS Guidelines
Flipboard will use your website’s RSS feed to discover articles, and to generate article summaries. In general, any reasonable RSS feed will work well within Flipboard. However there are some best practices to ensure that your article summaries look good, and that the content you create is easily processed and analyzed by our content recommendation systems.
Optimizing your RSS feed for Flipboard:
Your RSS feed should include the following fields before being submitted:
At the channel level, include:
- <title> the name of your feed
- <link> the feed’s URL
- <description> a short sentence describing the content of the feed
- <language> the language the feed is written in, using ISO-639 language codes and optionally ISO-3166 country codes – examples include “en”, “fr”, “en-CA”, and “fr-FR”
For each item in the feed, you need to include the following so your content displays correctly in layout view:
- <title> title of the item, where any special HTML characters should be encoded.
- <link> url of the item. It is preferred that the domain name of the host in the url should match the domain for the rss feed itself.
- <description> the excerpt for the article. It should generally contain 300 or more characters to provide an attractive, informative summary. Note that the amount of excerpt text that displays in the app may differ for each article depending on visual layout considerations.
- <pubDate> the publication date of the article, compliant with the combined ISO 8601 format or the RFC822 standard, including a time zone.
- <guid>a unique id for this entry in the feed (can be the item URL).
- <dc:creator> the author(s) of the article.
- <enclosure> use this tag to add a media element that will be used in layout view to illustrate your article. It can be an image or a video. For videos, mobile-friendly mp4 format is strongly preferred. For images, prefer a high-resolution image; the smallest dimension should not be under 500px.
- Optional: <category> you can specify a topic that describes the article.
In addition, your feed should generally contain at least the 20 most recent items from your website.
Best Practices
- Make sure your RSS feed adheres to the W3C specifications
- Feed must not require a password to view.
- Use clean and consistent URLs. Use the same URLs used when posting on Twitter, Facebook, or social networks.
- Whenever possible, avoid redirects on your feed and article URLs.
- Feed should be organized by date, with the most recent content at the top. Content that is more than 90 days old will not display on Flipboard.
- Do not reuse the same image for each of your articles, as we will only display that image for one article. The other articles will display no image.
Google Accelerated Mobile Pages (AMP)
If Flipboard detects an AMP version of an article from your web html (via <link rel=”amphtml”>), we will display your AMP article on Flipboard as it generally results in a better user experience. Please make sure that all AMP pages referenced in your HTML are usable and complete. Some blogging platforms automatically generate AMP pages, so keep this in mind when reviewing your web Flipboard traffic statistics.
Content Accessibility
Flipboard uses Amazon Web Services (AWS) servers, so please make sure that your web servers are not blocking the AWS IP range (more information here).
Outdated Feeds
If we detect that a feed has not updated with new content in 6 months, we may remove the feed from your magazine and our system. You will then need to resubmit an updated feed.
RSS Feed Troubleshooting
If you are getting an error message when adding a feed to a magazine:
- Ensure you have the correct feed URL. Make sure there are no extra spaces before or after the url. Open the feed in a browser window first, then copy the URL. This will remove any strange spaces or characters as well as any redirects.
- Make sure that your feed and the URLs it contains all work well in a web browser, with no missing or broken links.
- Your website or feed domain might be blocking Flipboard in your robots.txt file. Make sure that your website and feed domain’s robots.txt allows the user-agents “Flipboard” or “FlipboardProxy” to crawl your content. More information can be found here.
If you aren’t seeing the latest article in your RSS feed in your Flipboard Magazine:
- After you post content to your RSS feed, please wait at least 12 hours to see if an article appears in your Flipboard profile.
- Ensure that the RSS feeds in your magazines contain new content. If there is no new content in your RSS feed, there will be no new content in your Flipboard magazines.
- Flipboard magazines powered by RSS feeds are organized chronologically, with the most recent articles at the top. If you add older content to your RSS feed, it will be placed in your magazine in chronological order, so it may not appear on top.
- Flipboard will generally not accept articles with a publication date more than 90 days in the past. Make sure your feed content is up to date.
Example of RSS Feed:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 |
<rss version="2.0"> <channel> <title>The Perfect Feed</title> <link>http://example.com/feed</link> <description> A great feed with great examples. </description> <language>en-us</language> <item> <title>Squirrel Resembling Abraham Lincoln Found</title> <link>http://example.com/2017/10/02/squirrel-resembling-abraham-lincoln-found</link> <guid>2fd4e1c67a2d28fced849ee1bb76e7391b93eb12</guid> <pubDate>Mon, 02 Oct 2017 04:00:00 GMT</pubDate> <dc:creator>Ralph Wiggum</dc:creator> <description><![CDATA[ A local Springfield man has restored pride to Springfield by finding a squirrel that resembles Abraham Lincoln. Authorities are on the lookout for any rodents bearing resemblance to John Wilkes Booth. ]]></description> <enclosure url="http://media.example.com/2017/10/02/squirrel.jpg" length="1000" type="image/jpeg" /> <category>Squirrels</category> </item> <item> <title>Burns Pays City 3 Mil!</title> <link>http://example.com/2017/10/01/burns-pays-city-3-mil</link> <guid>de9f2c7fd25e1b3afad3e85a0bd17d9b100db4b3</guid> <pubDate>Sun, 01 Oct 2017 04:00:00 GMT</pubDate> <dc:creator>Todd Flanders</dc:creator> <description><![CDATA[ Wealthy resident Montgomery Burns was fined three million dollars after being caught dumping nuclear waste in the Springfield city park. ]]></description> <enclosure url="http://media.example.com/2017/10/01/burns-pays-city.mp4" length="10000" type="video/mp4" /> <category>Springfield</category> </item> </channel> </rss> |