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


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



ISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.

This value must be on the Language codelist.

Example Usage

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

  <location ref="AF-KAN">
   <location-reach code="1" />	  
   <location-id vocabulary="G1" code="1453782" />
	<narrative>Location name</narrative>
	<narrative>Location description</narrative>
	<narrative>A description that qualifies the activity taking place at the location</narrative>
   <administrative vocabulary="G1" level="1" code="1453782" />
   <point srsName="">
    <pos>31.616944 65.716944</pos>
   <exactness code="1"/>
   <location-class code="2"/>
   <feature-designation code="ADMF"/>
The narrative element can be repeated for any language additional to the default language set in iati-activity, by using the xml:lang attribute. Example not shown.

Developer tools

Find the source of this documentation on github:

Last updated on 2015-01-21