Skip to content
Back to top
View this page
Edit this page

# XLIFF

XLIFF [1] is the OASIS standard for translation.

[1]

XML Localization Interchange File Format

## Versions

The Translate Toolkit supports both XLIFF 1.x and XLIFF 2.0:

- XLIFF 1.x (1.1 and 1.2) - Available via `translate.storage.xliff`

- XLIFF 2.0 - Available via `translate.storage.xliff2` (added in version 3.17.0)

Warning

XLIFF 2.0 is not compatible with XLIFF 1.x.

### References

- XLIFF 1.2 Standard

- XLIFF 2.0 Standard

- OASIS XLIFF Technical Committee website

## Flavours

XLIFF 1.2 also has documents that specify the conversion from various standard source documents and localisation formats.

- PO – For conformance to the po2xliff spec, see xliff2po.

  - Draft XLIFF 1.2 Representation Guide for Gettext PO

- HTML – not implemented

  - Draft XLIFF 1.2 Representation Guide for HTML

- Java (includes .properties and Java resource bundles) – not implemented

  - Draft XLIFF 1.2 Representation Guide for Java Resource Bundles

- ICU Resource Bundles – not officially being developed by XLIFF – Proposed representation guide

## Standard conformance

### Done

- File creation and parsing

- API can create multiple files in one XLIFF (some tools only read the first file)

- source-language attribute

- trans-unit with

    - note: addnote() and getnotes()

    - state

        - fuzzy: isfuzzy() and markfuzzy()

        - translated: marktranslated()

        - approved

        - needs-review-translation: isreview(), markreviewneeded()

    - id: setid()

    - context-group: createcontextgroup()

- context groups

- alt-trans

## XLIFF and other tools

Here is a small report on XLIFF support by Windows programs.