Changes in version 1.8.0 (2026-04-16) - New Spanish regular expressions and names: country.name.es, cldr.name.es and country.name.es. Thanks to @dieghernan for the contribution, and to @NilsEnevoldsen and @cjyetman for review. - Misc regex improvements and testing. Thanks to @NilsEnevoldsen. Changes in version 1.7.0 (2026-02-27) - Add telephone as a new code from ITU-T E.164 country codes for telecommunication. - Add coverage for historical Gleditsch & Ward polities (including United Provinces of Central America, Transvaal, and Tibet) and regression tests. Thanks to @JoeNoonan for Issue #320. - custom_match now suppresses ambiguity and duplicate-match warnings for overridden values. Thanks to @victorhartman and @NilsEnevoldsen for the report and analysis (Issue #364). - Stricter Micronesia regular expressions. Thanks to @mattkerlogue, @stefgehrig, @cjyetman, @NilsEnevoldsen for discussion in Issue #354. - TÜRKİYE (dotted capital İ) now matches Turkey. Thanks to @cjyetman and @NilsEnevoldsen for report #347. - Update many dictionaries to the latest versions from publishing organizations. Thanks to @NilsEnevoldsen. - Improve Ireland regular expressions and add tests. Issue #313. - Improve Germany / East Germany regular expressions and add tests. Issue #313. - Update ISO4217 currency codes. Thanks to @cjyetman. Changes in version 1.6.1 (2025-03-31) - The simplify argument in apply was introduced in R 4.1.0. We used it, which broke usage of countrycode on older versions of R. - genc code improvements. Changes in version 1.6.0 (2024-03-22) - Important speed-up for detection of country names using regular expressions (Thanks to Etienne Bacher). - countryname gets the nomatch argument. - countryname returns NA when the code does not support a given country. (Issue #336) - Improved regex for Italy - eurocontrol_statfor updated: ESRA->ECAC to account for redistribution: https://www.eurocontrol.int/sites/default/files/2020-11/eurocontrol-forecast-2020-2024-region-definition.pdf Thanks to @sthonnard for contribution #352. - Antarctica now has a "continent" value. Thanks to @geryan for report #353. Changes in version 1.5.0 (2023-05-30) - get_dictionary() function to download custom dictionaries (cross-walks): - US States, Swiss Cantons, Global Burden of Disease, ExioBase, GTAP. - New codes: Polity V "p5c", "p5n" - New code "unhcr_region". Thanks to @galalH for code contribution #329 - Many regex improvements - Several minor bug fixes Changes in version 1.4.0 (2022-05-04) - Detect French country names using regular expressions: origin = "country.name.fr" (Thanks to Samuel Meichtry) - Detect Italian country names using regular expressions: origin = "country.name.it" (Thanks to Samuel Meichtry) Changes in version 1.3.1 (2022-02-02) - New code: unhcr Changes in version 1.3.0 (2021-07-15) - destination argument accepts a vector of strings and tries one after the other - countryname(warn=TRUE) by default - better class checks - countryname defaults to country.name.en for missing country names (nomatch=NULL) - Vietnam: better regex and support for vdem - Namibia fixes: eurostat, genc2c, wb_api2c, ecb - Various regex improvements - Congo French disambiguation Changes in version 1.2.0 (2020-05-22) - New 'countryname' function converts country names from any language (thanks to @davidsjoberg) - New guess_field function guesses which code a vector uses - Bug in dict build inserted NA in region variable (Thanks to M. Pascariu) - Added region23 with the old, more granular regions - Added unicode.symbol, which converts to emoji flags - Added ISO 4217 currency name, alpha, and numeric codes - Added UN region codes and names - Added IANA ccTLD codes - Improved various regexes Changes in version 1.1.3 (2020-05-07) - Added Demographic and Health Surveys (thanks to @mcooper) Changes in version 1.1.2 (2020-04-22) - Updated World Bank regions with manual additions Changes in version 1.1.1 (2020-02-08) - Bug: Typo prevented users for using "p4n" as origin code - Fixed bad icao.region codes (Thanks to @espinielli) - Added country name "United Arab Republic" and its regex (Thanks to Gina Reynolds) - Added SOM to wb code (Thanks to Fabian Besche) - Added Vietnam to codelist_panel Changes in version 1.1.0 (2018-10-27) - Gleditsch and Ward codes (Thanks to Altaf Ali) - V-Dem 8 country codes (panel and cross-section) - Fixed Netherlands Antilles test (ANT code retired by ISO) - codelist_panel now excludes years where a country didn't exist - Scraping function for UN M49 codes. (Thanks to @cjyetman and @emilBeBri) - nomatch = NULL now works as expected when sourcvar is a factor (#192 thanks to @jhuovari for reporting) Changes in version 1.0.0 - Huge thanks to @cjyetman for his incredible work on this major release! - Country-Year (panel) conversion dictionary - Dictionary built from original sources - Liechtenstein should not be in eu28 - Russia eurocontrol region fix - CLRD country names Changes in version 0.19.1 - Move to Semantic Versioning 2.0.0 http://semver.org/#semantic-versioning-specification-semver - Fixed North Korea regex and added tests - Fixed Sudan iso3n code - Removed lookbehind from Ireland regex for javascript compatibility (request by plotly) - Added nomatch argument Changes in version 0.19 (2017-02-06) New features - "custom_dict" argument allows user-supplied dictionary data.frames - "custom_match" argument allows a user-supplied named vector of custom origin->destination matches that will supercede any matching values in the default result (issue #107) (Thanks to @cjyetman) - German, French, Spanish, Russian, Chinese, and Arabic country names as destination codes - German regular expression to convert from German names to codes. (Thanks to @sumtxt) - Aviation codes (Thanks to Enrico Spinielli) - ar5 and eu28 (Thanks to Niklas Roming) - eurostat (Thanks to @cjyetman) - 2 and 3 character codes for the World Bank API: wb_api2c and wb_api3c (Thanks to @cjyetman) - alpha and numeric codes for Polity IV: p4_scode and p4_ccode (Thanks to @cjyetman) - World Values Survey numeric code (Thanks to @cjyetman) Regex fixes and improvements: - Improved regex for Ireland and United States of America (Thanks to @cjyetman) - D.R. Congo (found in WVS) matches Democratic Republic of the Congo (Thanks to @cjyetman) - Southern Africa - Federated States of Micronesia - Republic of China == Taiwan (Thanks to Nils Enevoldsen) - Martinique (Thanks to Martyn Plummer) - Tahiti country name string converts to French Polynesia Misc: - Major speed-up in regex conversion by using factors (Thanks to @cjyetman) - when more than one match is found for a given string, is returned rather than arbitrarily choosing the last match found (Thanks to @cjyetman) - updated tests to new testthat convention (Thanks to @cjyetman) - English country names are now official UN versions - Better docs, examples, and README - Taiwan FAO code is 214 (Thanks to Matthieu Stigler) Changes in version 0.18 (2014-12-29) - Nils Enevoldsen did wonderful work refactoring most of the regex in the dictionary. - Nils also added a bunch of tests. Thanks! - Added Tokelau Changes in version 0.17 (2014-07-15) - Added International Olympic Committee codes (Thanks to Devon Meunier) - Bug: fips04 -> fips104 (Thanks to Florian Hollenbach) - Complete FIPS104 codes (Thanks to Andy Halterman) - Generic code name validity check (Thanks to Stefan Zeugner) - Fixed IMF codes (Thanks to Stefan Zeugner) - Regex fix to work better with Database of Political Insitutions (Thanks to Christopher Gandrud) - Avoids confusion with Eq Guinea (Thanks to Christopher Gandrud) Changes in version 0.16 (2013-08-20) - Bug: NA cowc -> ABW (Thanks to Jon Mellon) Changes in version 0.15 - Regex fixes - Guinea - West Bank - Kitts / Christopher - Georgia / India - Mali - Sudan nigeria - Belgium - Korea Somalia - Oman Changes in version 0.14 (2013-05-30) - sint maarten typo Changes in version 0.13 (2013-03-22) - add sint maartin & curacao (thanks johnb30) Changes in version 0.12 (2013-03-08) - Missing wb codes filled-in using iso3c - Added South Sudan - Thanks to Rod Alence! Changes in version 0.11 (2013-02-12) - Vietnam cown - Regexes: - Dominica / Dominican Republic - New Zealand / Aland Changes in version 0.10 (2013-01-20) - De-duplicate Sudan - Niger vs. Nigeria regex Changes in version 0.9 (2012-12-27) - Fixed regexes: Mali, Korea, Oman, Dominica Changes in version 0.8 (2012-06-26) - Added World Bank (wb) country codes. Very similar, but slightly different from iso3c. Changes in version 0.7 (2012-06-04) - Removed useless functions countrycode.nomatch and countryframe - Fixed 2 Congo-related problems - Added option for countrycode() to report codes for which no match was found - Moved documentation to roxygen2 - Fixed Trinidad Tobago regex - Added UN and FAO country codes