---
title: "Enable or disable language codes in sitemap URLs"
slug: "enable-or-disable-language-codes-in-sitemap-urls"
abstract: "Learn how to configure your sitemap to embed language codes for URLs."
---
# Enable or disable language codes in sitemap URLs

If your pages exist in different languages, consider whether you want the URLs written to the sitemap to contain language codes. Adding language codes helps the search engines determine the language of a page. This means that internet users are more likely to find relevant content in their preferred language.

> [!note]
> You configure language embedding for each site.

You can configure this feature in the following ways:

- *Default* - pages in all languages, except for the default language, get a language code.
- *Always* - pages in all languages get a language code.
- *Never* - regardless of the language, no page gets a language code.

To enable or disable language codes in the sitemap:

1. Decide the desired behavior for this feature: default, always, or never.
2. [Create a patch file](https://doc.sitecore.com/sai/en/developers/sitecoreai/development/use-a-patch-file-to-customize-the-sitecore-configuration.html "Use a patch file to customize the Sitecore configuration") in the SitecoreAI project.
    - Create a new .config file under `authoring/platform/App_Config/Include`. For example:

        ```
        authoring/platform/App_Config/Include/SXA.Sitemap.LanguageEmbedding.config
        ```

3. Add SXA link providers via the patch, as in this example:

    ```
    <?xml version="1.0" encoding="utf-8"?>
    <configuration xmlns:patch="http://www.sitecore.net/xmlconfig/">

    <sitecore>   
    <linkManager>     
    <providers>    

    <!-- Always embed language codes -->       
    <add         
    name="lpCustomAlways"         
    type="Sitecore.XA.Foundation.Multisite.LinkManagers.LocalizableLinkProvider, Sitecore.XA.Foundation.Multisite"         
    languageEmbedding="always" />       

    <!-- Never embed language codes -->       
    <add         
    name="lpCustomNever"         
    type="Sitecore.XA.Foundation.Multisite.LinkManagers.LocalizableLinkProvider, Sitecore.XA.Foundation.Multisite"         
    languageEmbedding="never" />     
     </providers>   
    </linkManager> 
    </sitecore>
    </configuration>
    ```

4. Deploy the configuration.
    - Commit the patch file to the repository.
    - Deploy the SitecoreAI project (for example, via Sitecore Deploy).

    Patch files are applied during deployment and merged into the runtime configuration.

5. In the Content Editor, navigate to *sitecore/Content/[site collection]/[site]/Settings* and click the *Sitemap* item.
6. In the **URL options** section, in the **Link provider name** field, do one of the following:
    - To use the *default* setting, leave the field empty.
    - To enable language embedding for all languages, enter the name of the custom link provider, where *languageEmbedding* equals `always`, for example, `lpCustomAlways`.

        ![Specify the custom link provider in the Content Editor](https://doc.sitecore.com/api/markdown-image/sai/en/developers/sitecoreai/images/ce-sitemap-urloptions.png)

    - To disable language embedding for all languages, enter the name of the custom link provider, where *languageEmbedding* equals `never`, for example, `lpCustomNever`.
7. To test that language embedding has been configured correctly, publish the site and view the sitemap.

> [!note]
> Language embedding set as described here is overruled by the language embedding configuration selected in the [site settings](https://doc.sitecore.com/sai/en/users/sitecoreai/manage-sites.html#UUID-573cc3fc-ab88-ce55-c2c1-73acef232445_section-idm234507300031205).