This is the reference page for the XML element narrative.


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).



A code specifying the language of text in this element. It is recommended that wherever possible only codes from ISO 639-1 are used. If not present, the default language is assumed.

This value should be on the Language codelist.

Example Usage

The narrative child element can be used to declare freetext for the expense-line element.

   <period-start iso-date="2014-01-01" />
   <period-end iso-date="2014-12-31" />
   <value currency="USD" value-date="2014-01-01">250000000</value>
   <expense-line ref="1234">
     <value currency="USD" value-date="2014-01-01">200000000</value>
     <narrative xml:lang="en">Expense Line</narrative>
Note: The narrative element can be repeated for any language additional to the default language set in iati-organisation, by using the @xml:lang attribute. Example not shown.



The optional total-expenditure element was added.

Developer tools

Find the source of this documentation on github: