• Documentation
  • File formats



File conversion to XLIFF format is only available on the Growth plan and up.

  • File extensions: .xliff, .xlf, .xml
  • i18n type: XLIFF

The XLIFF format is an industry standard format to exchange localization files (XML Localisation Interchange File Format).

Transifex currently supports a certain subset of the features XLIFF provides:

  • The <group>, <context-group>, <context>, <trans-unit>, <source>, <note> and <target>; elements are handled.
  • Any context data are handled.
  • Developer comments are supported the following way:
<note from="developer">TRANSLATORS: please limit the page width to 79
    characters here.

and appear in the Web Editor as Developer Notes.

  • Character limits are also supported
<trans-unit id="1" maxwidth="30" size-unit="char"></trans-unit>

where the attribute maxwidth should be a positive number and the site-unit must be set to char.

  • References are also supported where each reference is mapped to two <context> elements, one specifying the source file (context-type attribute set to sourcefile) and the other representing the location in the source file ( context-type attribute set to linenumber). Each reference is in addition grouped in a <context-group> element, with the name attribute set to a value that must be unique within the enclosing <file> element and the purpose attribute set to location
<context-group name="po-reference-2" purpose="location">
  <context context-type="sourcefile">simple.c</context>
  <context context-type="linenumber">5</context>

They appear as Occurrences in the Web Editor.

  • Approved attribute is also supported. It indicates whether a translation is final or has passed its final review.
      <trans-unit approved="yes" id="1" xml:space="preserve">
        <target>Nom d'utilisateur</target>
      <trans-unit approved="no" id="2" xml:space="preserve">
        <source>Email address</source>
        <target>Adresse de courriel</target>

After uploading such a translation file where the approved attribute is included, the parser will behave as follows:

  1. Entries with approved="yes" will be marked as translated in Transifex having the translation text available in the translation string's area.
  2. Entries with approved="no" will remain untranslated in Transifex. However, the text inside the <target> elements will be considered a user suggestion and it will be available under the suggestions tab in the editor.



Plural Support

Plural data are handled in the following manner:

      <group restype="x-gettext-plurals">
       <trans-unit id="1[0]" xml:space="preserve">
       <source>Your trial ends in 1 day</source>
       <trans-unit id="1[1]" xml:space="preserve">
       <source>Your trial ends in %@ days</source>

For more information on how plurals are represented in the web-editor, consult our documentation guide here.

The following features are not supported:

  • Attributes of the above elements.
  • The <alt-trans> element.
  • Binary elements, like <bin-unit>, <bin-source>; and <bin-target>.
  • The <glossary> elements.
  • Any other minor elements.