This is the reference page for the XML element recipient-country. See also the relevant overview page: Geography


A partner country that will benefit from this activity. This element is primarily for administrative and geopolitical purposes. If a specific country is not known, the activity report can use the recipient-region element instead. For geographical location, use the location element.

For the value of the @code attribute, see



Machine readable code for the entity being described. The value should be available on a related codelist.

This value must be of type xsd:string.

This value should be on the Country codelist.


The percentage of the budget allocated to this item. Content must be a positive decimal number between 0 and 100, with no percentage sign. In version 1.03 of the IATI Standard this value became designated as a decimal value and no longer as a positive integer.

This value must be of type xsd:decimal.


ISO 2 letter code specifying the language of text in this element.

This value should be on the Language codelist.

Example Usage

Example recipient-country with relevant Country code:

  <recipient-country code="AF" />

When multiple recipient-country are declared, then the percentage values should sum to 100% for the specific iati-activity:

  <recipient-country code="AF" percentage="50" />
  <recipient-country code="AL" percentage="50" />

Additionally, the name of the Country can also be declared:

<recipient-country code="AF">Afghanistan</recipient-country>



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: