This is the reference page for the XML element narrative. See also the relevant overview page: Related Documents


The free text name or description of the item being described. This can be repeated in multiple languages.


The text in this element must be of type xsd:string.

This element must occur at least once (within each parent element).


Example Usage

The narrative child element can be used to declare freetext for the description element.

  <document-link format="application/vnd.oasis.opendocument.text" url="">
    <narrative>Project Report 2013</narrative>
    <narrative xml:lang="fr">Rapport de projet 2013</narrative>
     <narrative> Description of the content of the project report or guidance on where to access the relevant information in this report </narrative>
   <category code="A01" />
   <language code="en" />
   <document-date iso-date="2014-02-05" />
The narrative element can be repeated for any language additional to the default language set in iati-organisation, by using the @xml:lang attribute.
Note: This relates to the language of the text in the XML.



This mandatory narrative element of a description in a document-link element was added.

Developer tools

Find the source of this documentation on github:

Last updated on 2018-02-19