Publishing your data files

When you have prepared your data, place the files in an accessible online location so that you can link to them from the IATI Registry.

The IATI Registry contains links to published data files and descriptions of what information they hold. Organisations are responsible for their own data; you can store your data on your own website or server, or have it hosted by a third-party service or tool. Wherever your files are stored, they should be openly accessible, without passwords or other barriers.

Only users with the correct permission are allowed to publish data on behalf of an organisation.

Manual publishing

Individual files

If you only have a small number of data files to publish (less than five), log in to the IATI Registry and select ‘Data - Register’ on the blue bar at the top of the page. This opens a form where you can enter the required details for the IATI data file that you are publishing.

If you are publishing multiple files, add the details for each separately.

Bulk uploads

If you have more than five data files to add, upload them in bulk using a CSV file rather than adding each file individually.

Log in to the IATI Registry and select ‘Data - Upload CSV file’ on the blue bar at the top of the page. Download the CSV template and follow the link to guidance on how to fill in the template. Upload the CSV file when it is complete.

Automated publishing

IATI Publisher, and similar IATI publishing tools, can automatically publish data for users (see more information). Larger organisations with greater volumes or data or frequent updates often build their own bespoke systems.

Whether you are using a third-party tool or your own bespoke system, automatic publishing is done through an API (application programming interface). To enable this, you need an API token associated with your IATI user account – this grants access to the IATI system for your tools.

Each publishing tool or system guides you on how to set up automated publishing to the IATI Registry. As part of this you may be asked for:

• your publisher ID: this is normally an abbreviation of your organisation's name. Find this on your IATI Registry publisher page by clicking ‘Manage’. It also forms the last part of your publisher page’s URL.
• your IATI organisation identifier: this is the unique identifier for your organisation. On your IATI Registry publisher page it is listed as the 'identifier' on the right beneath your organisation's name
• your API token: this is a code associated with your IATI user account. A token can be generated in the 'My Account' tab when you are logged in to the IATI Registry.

Learn more about APIs

You can set up a system to interact with the IATI Registry using its own API, which is an implementation of the CKAN API. For details, see the full CKAN API documentation.

For further details and advice, contact us.

Removing your IATI data files

IATI is aware that, due to security concerns or privacy issues, data owners may choose to remove their data temporarily or permanently. If you need to remove your data please follow our Data removal guidance.