Magento : Get country code by country name

Magento : Get country code by country name

October 14, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento : Get country code by country name

Getting Country Code from Country Name in Magento

In Magento, while the platform provides extensive functionality for managing countries and their codes, finding a country code given its name isn’t as straightforward as you might expect. The built-in methods are designed to work primarily in the opposite direction—converting country codes into names.

Understanding the Built-In Functionality

Magento uses a combination of core files and configuration data to manage countries and their translations. The Mage::app()->getLocale()->getCountryTranslation($country_code) method you’ve found is a part of this architecture. It retrieves the translated name of a country given its ISO 2-alpha code.

The problem arises when you need to reverse this process—converting a country name back into its corresponding code. Unfortunately, Magento does not provide a native function for this purpose out-of-the-box.

A Workaround Approach

While there is no direct method available in the core Mage_Core_Helper_Abstract class or the Mage::app()->getLocale() functions, you can achieve your goal by leveraging the country data stored in the database and performing a manual lookup.

Let me guide you through the process:

  1. Access the Country Collection: The first step is to retrieve all available countries from the database. You can do this using Magento’s Mage::getModel factory class.
$countryCollection = Mage::getModel('directory/country')->getCollection();
  1. Iterate Through the Records: Next, you’ll need to loop through each record in the collection.
foreach ($countryCollection as $country) {
    // Your code here
}
  1. Compare Country Names: Inside your loop, compare the country name from the database with the one you have:
if (strtolower($country->getName()) == strtolower('Netherlands')) {
    // The country match has been found
    $countryCode = $country->getTwoLetterCountryName();
}
  1. Retrieve the Country Code: Once a match is found, Magento stores the two-letter country code in the two_letter_country_name field.
$countryCode = $country->getTwoLetterCountryName();

Putting it All Together

Here’s how you can combine these steps into a single function:

function getCountryCodeByName($countryName)
{
    $countryCollection = Mage::getModel('directory/country')->getCollection();

    foreach ($countryCollection as $country) {
        if (strtolower($country->getName()) == strtolower($countryName)) {
            return $country->getTwoLetterCountryName();
        }
    }

    // Return null or throw an exception if no country is found
    return null;
}

Best Practices and Additional Considerations

  • Ensure you’ve enabled the necessary Magento modules required for the directory/country model to function correctly.
  • Be aware that case sensitivity may affect the comparison results. In this example, I’ve converted both the provided name and the database value to lowercase before comparing them.

If you’re looking to optimize performance or handle countries not available in your specific Magento installation, consider Laravel Company’s guide on extending Magento functionality.

While this workaround serves its purpose, it’s essential to understand the underlying architecture and potential limitations. For complex integrations or high-load systems, a more efficient approach might involve creating an index or cache for country names and their corresponding codes.

Conclusion

In summary, while Magento doesn’t provide a direct method to get a country code from a name, you can achieve this by leveraging the built-in directory/country collection. By iterating through the records and performing a simple string comparison, you can successfully retrieve the required two-letter country code for any given name.

Remember, your solution should be tailored to your specific use case and Magento version. Always refer to the official documentation and consider the impact on performance before implementing it in a production environment.

Happy coding!

Database Configuration Errors

Our network