Sitemap for localized pages
Use the Sitemap file in the XML format to inform Yandex robots about the language versions of pages that need to be indexed on your site. Check out the requirements to the Sitemap file.
Use ISO codes to specify the language and region:
Choose the language code from the ISO 639-1 list.
Choose the region code from the ISO 3166-1 Alpha-2 (worldwide) or ISO 3166-2:RU (Russian regions) list.
For example, the site may have an English-language page for English-speaking users from all over the world, with two options for German-speaking users: for visitors from Switzerland and from other countries:
- www.example.com/english/page.html — For English-speaking audience.
- www.example.com/deutsch/page.html — For those who speak German.
- www.example.com/schweiz-deutsch/page.html — For users from Switzerland who speak German.
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
xmlns:xhtml="http://www.w3.org/1999/xhtml">
<url>
<loc>http://www.example.com/english/page.html</loc>
<xhtml:link
rel="alternate"
hreflang="de"
href="http://www.example.com/deutsch/page.html"/>
<xhtml:link
rel="alternate"
hreflang="de-ch"
href="http://www.example.com/schweiz-deutsch/page.html"/>
<xhtml:link
rel="alternate"
hreflang="en"
href="http://www.example.com/english/page.html"/>
</url>
<url>
<loc>http://www.example.com/deutsch/page.html</loc>
<xhtml:link
rel="alternate"
hreflang="de"
href="http://www.example.com/deutsch/page.html"/>
<xhtml:link
rel="alternate"
hreflang="de-ch"
href="http://www.example.com/schweiz-deutsch/page.html"/>
<xhtml:link
rel="alternate"
hreflang="en"
href="http://www.example.com/english/page.html"/>
</url>
<url>
<loc>http://www.example.com/schweiz-deutsch/page.html</loc>
<xhtml:link
rel="alternate"
hreflang="de"
href="http://www.example.com/deutsch/page.html"/>
<xhtml:link
rel="alternate"
hreflang="de-ch"
href="http://www.example.com/schweiz-deutsch/page.html"/>
<xhtml:link
rel="alternate"
hreflang="en"
href="http://www.example.com/english/page.html"/>
</url>
</urlset>
Tag description
Tag | Required | Description |
---|---|---|
url | Yes | Parent tag for each site page |
loc | Yes | Page address. |
xhtml:link | Yes | Links to all language and regional versions of the page, including the main one |
Tag | Required | Description |
---|---|---|
url | Yes | Parent tag for each site page |
loc | Yes | Page address. |
xhtml:link | Yes | Links to all language and regional versions of the page, including the main one |
FAQ
- The robot crawled the Sitemap file recently and didn't process it yet. Wait for two weeks. If you use the Sitemap index file with multiple files, they may take longer to process than a single Sitemap file.
- The site was previously unavailable for the indexing robot. You need to wait for the next site visit by the robot.
- Access to Sitemap is prohibited in the robots.txt file. The server returns an HTTP code other than 200 when the robot tries accessing Sitemap. Check if the file is available to the robot. To do this, use the Server response check tool. Specify the full path to the file.
- The server response to the Sitemap request. If access to Sitemap is prohibited in the robots.txt file or an HTTP code other than 200 is returned when the robot tries accessing it, the file will not be processed by the robot. If the check displays “Forbidden by the noindex meta tag”, this doesn't indicate an error. The noindex meta tag prevents the file from being included in the search database, but doesn't prevent the robot from processing its contents.
- The Sitemap file with the Sitemap file analysis tool. Correct the mistakes if they are found.
The Sitemap file (and other XML files) is displayed as excluded pages. This is, however, only for information purposes and doesn't affect the site indexing or the Sitemap processing.
The Sitemap file can be displayed in a group of excluded pages if the robot tried to index it as a regular page, while the XML files aren't indexed in the Yandex search engine and aren't included in the search results.
The Sitemap file may contain only certain XML elements. If Yandex.Webmaster finds other elements in the file (for example, a reference to the mobile or multilingual version, image URLs), it displays the "Unknown tag" error. The robot ignores unsupported elements when processing Sitemap and takes into account the data from the supported elements. Therefore, you don't need to change the Sitemap file.
If the file content is changed, the information in Yandex.Webmaster is updated within two weeks.
The Sitemap file may be not indexed for several reasons:
If there is an access problem, contact the administrator of the site or the server where it is located. If the file is compiled correctly, it will be re-processed within two weeks from the last request by the robot. You can check the file with the Sitemap file analysis tool.
Usually, the Sitemap file is processed by the robot within two weeks after adding it to Yandex.Webmaster. If this doesn't happen, check: