> For the complete documentation index, see [llms.txt](https://support.iafcertsearch.org/verifiers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.iafcertsearch.org/verifiers/iaf-certsearch-dataset/countries/country-mapping-behavior.md).

# Country Mapping Behavior

This section outlines how legacy country entries from **Version 1** are mapped to their updated counterparts in **Version 2**, which follows the **ISO 3166-1** standard.

The mapping ensures **backward compatibility** while aligning all current and future data with standardized country codes and names:

<table><thead><tr><th>Legacy Entry (version 1)</th><th width="294.833251953125">Latest Version (ISO 3166-1) (version 2)</th><th>Mapping Behavior</th></tr></thead><tbody><tr><td>Swaziland</td><td>Eswatini</td><td><p><strong>Automatic Replacement</strong></p><ul><li>For countries with updated names (e.g., Swaziland → Eswatini). The system will automatically map and display the updated name (e.g., Eswatini) in the UI, including on the Detail Page, Listing Page, and other relevant areas.</li></ul></td></tr><tr><td>Netherlands Antilles</td><td><ul><li>Bonaire, Sint Eustatius and Saba</li><li>Curaçao</li><li>Sint Maarten (Dutch part)</li></ul></td><td><p></p><p><strong>Legacy Display with Guidance</strong></p><ul><li>The original name will still be shown for legacy country names without a direct one-to-one mapping, such as the Netherlands Antilles.</li><li>However, we <strong>recommend mapping to the corresponding updated countries where possible.</strong></li></ul></td></tr><tr><td>N/A</td><td>South Sudan</td><td>Newly added in Version 2</td></tr></tbody></table>

***

**Impact on Data Import and Display**

| Use Case                            | Example                                                                                                                           | Behavior                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Data with one-to-one mapping**    | Swaziland → Eswatini                                                                                                              | <p><strong>During Import (File Upload / API)</strong></p><ul><li>If a legacy country name like <strong>Swaziland</strong> is used, the system will <strong>accept it</strong> and <strong>automatically map it to the updated name</strong>, <strong>Eswatini</strong>.</li></ul><p><strong>How it's displayed?</strong></p><ul><li>Record will then show the <strong>latest country name</strong> in the system. <em>(e.g., Eswatini)</em></li></ul>                                                                                                                                                    |
| **No Direct Mapping (One-to-Many)** | <p>Netherlands Antilles →</p><ul><li>Bonaire, Sint Eustatius and Saba</li><li>Curaçao</li><li>Sint Maarten (Dutch part)</li></ul> | <p><strong>During Import (File Upload / API)</strong></p><ul><li>If a legacy country name like the<strong>Netherlands Antilles</strong> is used, the system will <strong>accept it</strong> and <strong>will save it as it is.</strong></li></ul><p><strong>How it's displayed?</strong></p><ul><li>Record will still show the legacy <strong>country name</strong> in the system. <em>(e.g., Netherlands Antilles)</em></li></ul><p><strong>Action Required</strong></p><ul><li>To comply with the ISO 3166-1 standard, it is recommended that you map the legacy name to the latest version.</li></ul> |
