We've launched a new support center at help.smartling.com. This site will continue to be maintained into January 2017. Please update your bookmarks.

Managing Locale in the HTTP <head> of a Page

The following article applies to Global Delivery Network project types. 

You can specify the current language-locale in the http head of a page, and you can also exclude or specify custom localized content.

Including Locale in the HTTP Header

The Smartling Global Delivery Network issues a custom http header describing the current language-locale for the request, in the format:


For example:

French (France):  X-LANGUAGE-LOCALE: fr-FR
French (Canada): X-LANGUAGE-LOCALE: fr-CA
English (United Kingdom): X-LANGUAGE-LOCALE: en-GB
Spanish (International): X-LANGUAGE-LOCALE: es

The header names are case sensitive, but the language and locale name (for example fr-FR) are not case sensitive.

You can add server-side logic to detect the language in use and add appropriate language-specific logic. This might be useful for such things as language-specific options, setting language defaults for the user or customizing checkout experiences.

Excluding or Specifying Localized Content in the <head> of a page

Localized content consists of strings from your source site that you may want to completely replace with entirely different content in your translated locales. This could be either different source content that requires translation, or locale-specific content that is already translated such as a client testimonial. Smartling refers to this as content 'swap'.

You can exclude or specify custom localized content in the meta tags (keywords and descriptions) and title tag that appear in the <head> tag of a page by using the Smartling "notranslate" and "SL:swap" HTML comments.

Here's an example that swaps meta keywords:

<!-- SL:swap-start:id:/page/html.html-keywords -->
<meta name="keywords" content="keyword1, keyword2, keyword three">

<!-- SL:swap-end -->

To exclude content:

<!-- SL:start:notranslate -->
<meta property="og:description" content="Smartling will exclude this content." />
<!-- SL:end:notranslate -->

To localize content:

<!-- SL:swap-start:id:UniqueID -->
<meta property="og:description" content="This content will appear in Smartling at Content > Localized Content" />
<!-- SL:swap-end -->

UniqueID is unique HTML ID that you specify and must be unique across all ID's in your content

If you tag meta keywords for swapping to localize content (instead of excluding content using 'do not translate'), Smartling will treat the swapped content as a comma-separated list. 

Title and Meta

Text appearing within the page <title></title> tags, as well as the keywords and description <meta> tags will always be translated and need not be marked for translation.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request
Powered by Zendesk