Cross Border Data Exchange IG
1.0.0 - CI Build International flag

Cross Border Data Exchange IG, published by IEHR-Workgroup. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of and changes regularly. See the Directory of published versions

Translation Instructions

Translation in a nutshell: The different translations of a resource should be contained in a single resource and use extensions.

Original language

The language attribute of the resource (Resource.language) contains the language in which it was created originally created and all attributes contain the original text in this language.


To translate a text attribute it is extended with the Translation Extension. This extension contains a language (Extension.lang) and the translated text (Extension.content). Therefor, the to-be-translated attribute should have one extension for each different language.

Information about the system or person providing the translation can be provided by extending the Translation Extension with the ExtendedTranslation-IEHR Extension. The ExtendedTranslation-IEHR contains a reference to a Provenance resource with relevant information about the translation process, like the actor and the time of translation. This provenance should be transmitted together with the resources, but if multiple resources were translated together they can reference the same provenance. Thus, if for each language all resources are translated together into that language, it should be sufficient to have one provenance for each language. All translations in the same language would also reference the same Provenance in the ExtendedTranslation-IEHR, too.