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 may occur any number of times.


Example Usage

The narrative child element can be used to declare freetext for the recipient-country element.

Note: Both the recipient-region and recipient-country elements still allow both a @code and descriptive text to be specified. This is to cover the isolated cases where the organisation publishing the data may not agree with name of a country or region given by the lookup codelists IATI uses.
<recipient-country code="XK">
        <narrative>Kosovo (As per UNSCR 1244)<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 recipient-country element was introduced in 2.01.

Developer tools

Find the source of this documentation on github: