The Internationalization Tag Set (ITS) is a set of attributes and elements designed to provide internationalization and localization support in XML documents.

The ITS specification identifies concepts (called "ITS data categories") which are important for internationalization and localization. It also defines implementations of these concepts through a set of elements and attributes grouped in the ITS namespace. XML developers can use this namespace to integrate internationalization features directly into their own XML schemas and documents.


ITS v1.0 includes seven data categories:

  • Translate: Defines what parts of a document are translatable or not.
  • Localization Note: Provides alerts, hints, instructions, and other information to help the localizers or the translators.
  • Terminology: Indicates parts of the documents that are terms and optionally pointers to information about these terms.
  • Directionality: Indicates what type of display directionality should be applied to parts of the document.
  • Ruby: Indicates what parts of the document should be displayed as ruby text. (Ruby is a short run of text alongside a base text, typically used in East Asian documents to indicate pronunciation or to provide a brief annotation).
  • Language Information: Identifies the language of the different parts of the document.
  • Elements Within Text: Indicates how elements should be treated with regard to linguistic segmentation.

The vocabulary is designed to work on two different fronts: First by providing markup usable directly in the XML documents. Secondly, by offering a way to indicate if there are parts of a given markup that correspond to some of the ITS data categories and should be treated as such by ITS processors.

ITS applies to both new document types as well as existing ones. It also applies to both markups without any internationalization features as well as the class of documents already supporting some internationalization or localization-related functions.

ITS can be specified using global rules and local rules.

  • The global rules are expressed anywhere in the document (embedded global rules), or even outside the document (external global rules), using the its:rules element.
  • The local rules are expressed by specialized attributes (and sometimes elements) specified inside the document instance, at the location where they apply.


Example of ITS markup for the Translate data category:

The elements and attributes with the its prefix are part of the ITS namespace. The its:rules element list the different rules to apply to this file. There is one its:translateRule rule that indicates that any content inside the head element should not be translated.

The its:translate attributes used in some elements are utilised to override the global rule. Here, to make translatable the content of title and to make non-translatable the text "faux pas".

<text xmlns:its="">
  <revision>Sep-10-2006 v5</revision>
  <author>Ealasaidh McIan</author>
   its:translate="yes">The Origins of Modern Novel</title>
  <its:rules version="1.0">
   <its:translateRule translate="no" selector="/text/head"/>
  <div xml:id="intro">
    <p>It would certainly be quite a <span its:translate="no">faux
pas</span> to start a dissertation on the origin of modern novel without 
mentioning the <tl>Epic of Gilgamesh</tl>...</p>

Example of ITS markup for the Localization Note data category:

The its:locNote element specifies that any node corresponding to the XPath expression "//msg/data" has an associated note. The location of that note is expressed by the locNotePointer attribute, which holds a relative XPath expression pointing to the node where the note is, here ="../notes".

Note also the use of the its:translate attribute to mark the notes elements as non-translatable.

<Res xmlns:its="">
  <its:rules version="1.0">
   <its:translateRule selector="//msg/notes" translate="no"/>
   <its:locNoteRule locNoteType="description" selector="//msg/data" locNotePointer="../notes"/>
  <msg id="FileNotFound">
   <notes>Indicates that the resource file {0} could not be loaded.</notes>
   <data>Cannot find the file {0}.</data>
  <msg id="DivByZero">
   <notes>A division by 0 was going to be computed.</notes>
   <data>Invalid parameter.</data>

ITS limitationsEdit

ITS does not have a solution to all XML internationalization and localization issues.

One reason is that the version 1.0 does not have data categories for everything. For example, there is currently no way to indicate a relation source/target in bilingual files where some parts of a document store the source text and some other parts the corresponding translation.

The other reason is that many aspects of internationalization cannot be resolved with a markup. They have to do with the design of the DTD or the schema itself. There are best practices, design and authoring guidelines that are necessary to follow to make sure documents are correctly internationalized and easy to localize. For example, using attributes to store translatable text is a bad idea for many different reasons, but ITS cannot prevent an XML developer to make such choice.

External linksEdit

Ad blocker interference detected!

Wikia is a free-to-use site that makes money from advertising. We have a modified experience for viewers using ad blockers

Wikia is not accessible if you’ve made further modifications. Remove the custom ad blocker rule(s) and the page will load as expected.