The RSS feed markup

The RSS feed structure

<?xml version = "1.0" encoding = "UTF-8"?>
<rss xmlns:yandex="http://news.yandex.ru"
     xmlns:media="http://search.yahoo.com/mrss/"
     xmlns:turbo="http://turbo.yandex.ru"
     version="2.0">
    <channel>
        <!-- Information about the source sitev -->
        <title>Feed name</title>
        <link>http://www.example.com/</link>
        <description>Short feed description</description>
        <language>ru</language>
        <turbo:analytics></turbo:analytics>
        <turbo:adNetwork></turbo:adNetwork>
        <item turbo="true">
            <!-- Information about the page -->
            <link>http://www.example.com/category/sub-category/page1.html</link>
            <turbo:source></turbo:source>
            <turbo:topic></turbo:topic>
            <pubDate>Tue, 21 Apr 2015 14:15:00 +0300</pubDate>
            <author>Ivan Ivanov</author>
            <metrics>
                <yandex schema_identifier="ID">
                    <breadcrumblist>
                        <breadcrumb url="http://example.com/" text="Home"/>
                        <breadcrumb url="http://example.com/category/" text="Category"/>
                        <breadcrumb url="http://example.com/category/sub-category/" text="Subcategory"/>
                        <breadcrumb url="http://example.com/category/sub-category/page1.html" text="Page example"/>
                    </breadcrumblist>
                </yandex>
            </metrics>
            <yandex:related></yandex:related>
            <turbo:content>
                <![CDATA[                    <!-- Содержимое 1 страницы -->
                ]]>
            </turbo:content>
        </item>
        <item turbo="true">
            ...
            <turbo:content>
                <![CDATA[                    <!-- Page 2 content --> 
                ]]>
            </turbo:content>
        </item>
        ...
    </channel>
</rss>
channel *
Source site information.
title
The RSS feed title.

If you export the entire site contents, specify the site name. If you export a site section, enter just the section title.

link
Domain of the site from which the data is passed.
description

Channel description in one sentence. Do not use HTML markup.

language

The article language according to the ISO 639-1 standard.

turbo:analytics

Web analytics tag for tracking Turbo pages traffic.

Learn more.

turbo:adNetwork

Use it to display the Yandex Advertising network blocks and third-party ads connected through ADFOX on Turbo pages. Also use it to track the advertising revenue from Turbo pages.

Learn more.

item *

Page information.

To display Turbo pages, add the turbo="true" attribute. To disable the display of a Turbo page, set the value to false. For details, see Managing Turbo pages display.

One item element describes one page.

link *

The URL of the site page to generate the Turbo page for.

Requirements:
  • The link must contain the HTTP or HTTPS scheme prefix.
  • The link domain must be the same as the source site domain.
  • The maximum length of the URL is 243 ASCII characters.
  • Each URL must contain one article.

When the link is clicked, the header and the beginning of the text should fit the first screen at 1024 × 768 resolution.

turbo:source
The source page URL that can be sent to Yandex.Metrica.
turbo:topic

The page heading that can be sent to Yandex.Metrica.

pubDate

Publication time in the RFC-822 format.

A required element for forming the automatic home page.

author

The author of the article published on the page.

metrics
Attention. Nested metrics elements must be passed if you use the Content reports on the main pages of the site.

Additional information about the page. Used for linking content information on the main and Turbo pages of the site.

yandex
Information for Yandex.Metrica. Allowed attributes:
  • schema_identifier — The ID specified on the main page.
breadcrumblist
Attention. The breadcrumblist elements aren't used for building “breadcrumbs”. They are only used to identify the headings.

Block with headings specified on the main page of the site.

breadcrumb
Page information. Allowed attributes:
  • url — URL of the category/page.
  • text — Name of the category/page.
yandex:related

You can post links to other resources or customize the display of the infinite scroll.

These links will be placed at the bottom of the Turbo page. To add links anywhere on the page, use Block of links to additional materials.

Infinite recommendations feed

View the infinite feed example.

Attention. The infinite feed can be formed only from articles that have Turbo page versions.
To specify the set of pages manually:
  1. In the item element of the page, add the yandex:related element with the type="infinity" attribute.
  2. Inside the yandex:related element add links to the pages the feed is generated from. Links must be specified using the link element with the url attribute.
    Example:
    ...
        <yandex:related type="infinity">
            <link url="http://www.example.com/page.html"></link>
            <link url="http://www.example.com/page2.html"></link>
            ...
        </yandex:related>
    ...
    Copied to clipboard
To display ADFOX ads on the Turbo pages with the infinite feed:
  1. In the ADFOX interface, go to the Parameters tab.
  2. In the Code type list choose <non-duplicated banners>.
Learn more about settings in .
turbo:content *

Required

Sending the page content

Turbo page content is passed in the turbo:content element. Content must be wrapped in the ![CDATA[]]> section
...<turbo:content>    <![CDATA[        <!-- Page content -->
        ]]> 
    </turbo:content>
...
Copied to clipboard
The page content must contain the page header and the content part:
...    <!-- Header -->
    <header>
        <h1>Page heading</h1>
        <figure>
            <img src="http://example.com/img.jpg"/>
        </figure>
        <h2>Second level heading</h2>
        <menu>
            <a href="http://example.com/page1.html">Link text</a>
            <a href="http://example.com/page2.html">Link text</a>
        </menu>
    </header>
    <!-- Content part -->
...
Copied to clipboard
header *
h1 *

Page heading.

figure
The element used for generating a preview in the header. Can be used for generating a picture with caption.
img
The src attribute must contain the image URL. JPEG, PNG, GIF formats are supported.
h2

Level two heading.

menu
Navigation menu.
a

Menu item. The href attribute must contain the site page link.

Required

Characters and encodings

In the export file, specify the encoding used by your server. The most commonly used encodings are: UTF-8, Windows-1251, KOI8-R.

In all elements of the RSS file, except for the <![CDATA[]]> tag content, encode the following characters:
Character Name Replacement code
& Ampersand &
> Right pointed bracket >
< Left pointed bracket <
" Inverted commas "
' Apostrophe '

For example, the link http://example.com/?id=1&page=10 should look like http://example.com/?id=1&page=10.

Example of an RSS feed

<rss xmlns:yandex="http://news.yandex.ru" xmlns:media="http://search.yahoo.com/mrss/" xmlns:turbo="http://turbo.yandex.ru" version="2.0">
    <channel>
        <title>The RSSfeed title</title>
        <link>http://www.example.com/</link>
        <description>Shortdescription of the RSS feed</description>
        <turbo:analytics type="Yandex" id="123456"></turbo:analytics>
        <turbo:adNetwork type="Yandex" id="block ID" turbo-ad-id="first_ad_place"></turbo:adNetwork>
        <turbo:adNetwork type="AdFox" turbo-ad-id="second_ad_place">
            <![CDATA[                <div id=container ID"/div                script                    window.Ya.adfoxCode.create({                        ownerId: 123456,                        containerId: 'container ID',                        params: {                            pp: 'g',                            ps: 'cmic',                            p2: 'fqem'                        }                    });                /script            ]]        /turbo:adNetwork        yandex:related type="infinity"            link url="http://www.example.com/other-page1.html"Link text/link            link url="http://www.example.com/other-page2.html"Link text/link        /yandex:related        item turbo="true"            linkhttp://www.example.com/page1.html/link            authorIvan Ivanov/author            categoryTechnologies/category            pubDateSun, 29 Sep 2002 19:59:01 +0300/pubDate            turbo:content                ![CDATA[
                    <header>
                        <h1>The Healthybreakfast restaurant</h1>
                        <h2>Healthy and delicious	</h2>
                        <figure>
                            <img src="https://avatars.mds.yandex.net/get-sbs-sd/403988/e6f459c3-8ada-44bf-a6c9-dbceb60f3757/orig">
                        </figure>
                        <menu>
                            <a href="http://example.com/page1.html">Menu entry
 1</a>
                            <a href="http://example.com/page2.html">Menu entry
 2</a>
                        </menu>
                    </header>
                    <p>What is a good way to startthe day? Have a delicious and healthy breakfast!</p>
                    <p>Come to us for breakfast. Find the photos of our dishes <a href="#">on our site</a>.</p>
                    <h2>Menu</h2>
                    <figure>
                        <img src="https://avatars.mds.yandex.net/get-sbs-sd/369181/49e3683c-ef58-4067-91f9-786222aa0e65/orig">
                        <figcaption>Omelette with herbs</figcaption>
                    </figure> 
                    <p>Our menu always containsfresh, tasty and healthy dishes.
</p>
                    <p>Find it out yourself.</p>
                    <button formaction="tel:+7(123)456-78-90" data-background-color="#5B97B0" data-color="white" data-primary="true">Reserve a table
</button>
                    <div data-block="widget-feedback" data-stick="false">
                        <div data-block="chat" data-type="whatsapp" data-url="https://whatsapp.com"></div>
                        <div data-block="chat" data-type="telegram" data-url="http://telegram.com/"></div>
                        <div data-block="chat" data-type="vkontakte" data-url="https://vk.com/"></div>
                        <div data-block="chat" data-type="facebook" data-url="https://facebook.com"></div>
                        <div data-block="chat" data-type="viber" data-url="https://viber.com"></div>
                    </div>
                    <p>Our address: <a href="#">Nullam dolor massa, porta a nulla in, ultricies vehicula arcu.</a></p>
                    <p>Photos — http://unsplash.com</p>
                ]]>
            </turbo:content>
        </item>
    </channel>
</rss>
Copied to clipboard