This is the reference page for the XML element location.


The sub-national geographical identification of the target locations of an activity. These can be described by gazetteer reference, coordinates, administrative areas or a textual description. Any number of locations may be reported.


This element may occur any number of times.



An internal reference that describes the location in the reporting organisation’s own system.

This value must be of type xsd:string.

Example Usage

Example location for an iati-activity.

This element is a parent for other child elements.
An example organisation @ref of AF-KAN is declared.
<location ref="AF-KAN">
Full example with all child elements:
  <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="http://www.opengis.net/def/crs/EPSG/0/4326">
    <pos>31.616944 65.716944</pos>
   <exactness code="1"/>
   <location-class code="2"/>
   <feature-designation code="ADMF"/>
The location element can be repeated in any iati-activity:
<location ref="AF-KAN">
<location ref="KH-PNH">



The following child elements were removed: coordinates; gazetteer-entry; location-type.

The @percentage attribute was removed.


Note that major changes were made to the subelements of location in version 1.04.

For more information refer to:
  • the 1.04 location changes overview guidance

  • the Activities Schema Changelog (or the individual subemelement pages)

The @ref attribute was introduced to provide a cross reference that a publisher can use to link back to their own internal system.
The @percentage attribute was deemed unworkable and deprecated in 1.04


Where used, the @percentage attribute is now designated as a decimal value and no longer as a positive Integer

Developer tools

Find the source of this documentation on github: