Technical feed requirements

The information in your feed powers your Google News publication.

Improve your feed

For readers to fully engage with your content, provide full articles and media assets. Set up your feed properly to prevent errors, failed approvals, or removals.

To improve your feed:

  • Review the feed content guidelines.
  • Verify your RSS or Atom feeds to avoid common errors.
    • Before you create your publication, you can validate your feed, follow recommendations, and fix any issues using a feed validation tool.
  • Confirm “News” can crawl your feed.

Technical feed specification

We accept both standard RSS and Atom feeds. The Google News feed follows these parameters:

  • Update frequency: Each feed is fetched about every 30 minutes, unless WebSub is used to notify Google News of changes. Learn more about update frequency of feed content.
  • Size limit: 1 MB per article and 2 MB per feed.
  • Readability: Up to 60 new articles per fetch, without including previously read articles.

Tip: To make sure all content is retrieved, do not exceed fetch or file limits.

Article updates

The <guid> tag in RSS, and <id> tag in Atom are required to identify unique articles. We suggest using the article title as the <guid> / <id> tag, since it’s likely to change.

Important: We use the <pubDate> tag to determine whether the article was modified.

When & how to use isPermaLink

If you provide the full URL of your original article in the <guid> / <id> tags, the isPermaLink is optional. If you don't provide the full URL, isPermaLink must be set to false.

Full URL is used
  • Doesn't use isPermaLink
  • Sets isPermaLink to true
  • <guid>https://yoursite.com/url-to-article.html</guid>
  • <guid isPermaLink=”true”>https://yoursite.com/url-to-article.html</guid>
Full URL isn't used
  • Sets isPermaLink to false
  • <guid isPermaLink=”false”>sample-id-1234567890</guid>

Article contents & markup

Although Google News no longer displays the article contents from the feed to users, other Google products like Google Assistant might still use it.

Important: Google News removes:

  • <script> tags
  • inline styles (<style> tags or style="") attributes

Follow these guidelines:

  • To contain the full contents of every article, use <content:encoded>. If you don’t use a <content:encoded> tag, Google News defaults to content in the <description> tag.
  • If both <content:encoded> and <description> tags are present in the feed, Google News drops the tag with the least number of characters.
  • For <content:encoded>, use the namespace xmlns:content="http://purl.org/rss/1.0/modules/content/". HTML must be escaped or preferably wrapped in a CDATA section. For example: <content:encoded><![CDATA[<b>This is some HTML text.</b>]]></content:encoded>

Best practices

  • Mark up your content with semantically meaningful HTML tags, such as <p>, <h1>, <ul>.
  • If possible, avoid <br>.
  • Use block-level elements to avoid zero-pixel border issues.
  • Avoid smart quotes.
  • If a character encoding must be specified, use UTF-8.

Media assets

We recommend that you use Media RSS tags to identify multimedia content in Atom and RSS feeds. Learn more about Media RSS tags.

Important: To use Media RSS, include the namespace. For example: xmlns:media="http://search.yahoo.com/mrss/".

Video

Use these guidelines to enhance your video.
Important: Video content resolution must be at least 640x480 (width x height) and use HTTPS.
RSS tags

RSS tags help enhance video performance, and provide smoother user interface (UI) elements and muted auto-play. We accept several formats for publisher-hosted video, including: MP4, WebM, DASH, SmoothStreaming, and HLS. To include video directly in your feed, use Media RSS tags.

Example:

<media:content url="https://ia600806.us.archive.org/17/items/VintageCartoonsSet2MP4/052750AnEggScrambleMmBr.mp4" medium="video" height="768" width="1024">

  <media:title>Sample MP4 Video</media:title>

  <media:description>

    <![CDATA[This is a sample MP4 video]]>

  </media:description>

  <media:credit role="author" scheme="urn:ebu">

    <![CDATA[Warner Brothers]]>

  </media:credit>

</media:content>

Multiple bit rates

To provide multiple bit rates of a video, specify multiple <media:content> objects within a <media:group>.

Example:

<media:group>

  <media:content url="https://ia600806.us.archive.org/17/items/VintageCartoonsSet2MP4/052750AnEggScrambleMmBr_1280.mp4" medium="video" height="768" width="1024" bitrate=”1280”>

    <media:title>Sample MP4 Video</media:title>

    <media:description>

      <![CDATA[This is a sample MP4 video]]>

    </media:description>

    <media:credit role="author" scheme="urn:ebu">

      <![CDATA[Warner Brothers]]>

    </media:credit>

  </media:content>

  <media:content url="https://ia600806.us.archive.org/17/items/VintageCartoonsSet2MP4/052750AnEggScrambleMmBr_4080.mp4" medium="video" height="768" width="1024" bitrate=”4080”>

    <media:title>Sample MP4 Video</media:title>

    <media:description>

      <![CDATA[This is a sample MP4 video]]>

    </media:description>

    <media:credit role="author" scheme="urn:ebu">

      <![CDATA[Warner Brothers]]>

    </media:credit>

  </media:content>

</media:group>

YouTube association

To improve our understanding of your video content, associate your publisher-hosted video with its YouTube counterpart. You can add the YouTube video into the <media:group> element.

Example:

<media:group>

  <media:content      url="https://archive.org/download/Fleischer_The_Tantalizing_Fly_1919/Tantalizing_Fly_1919_512kb.mp4"  medium="video" type="video/mp4" height="240" width="360">

    <media:title>The Tantalizing Fly</media:title>

    <media:thumbnail url="https://archive.org/download/Fly_1/RIMG0019.JPG"/>

  </media:content>

  <media:content url="https://youtube.com/watch?v=_dlP0nXMKXA" medium="video" type="video/3gpp">

    <media:title>The Tantalizing Fly</media:title>

  </media:content>

</media:group>

true
New Publisher Center

Google launched a new Publisher Center interface to help publishers easily manage how their content appears across Google News surfaces. Read more on this FAQ page and our blog post.

Search
Clear search
Close search
Google apps
Main menu
1771310704132710422
true
Search Help Center
true
true
true
true
true
100499
false
false