README

Country Flag Emoji JSON

Country flag emojis in JSON format and SVG image.

CDN

Check out the /dist directory to see all available JSON files and SVG images. All These files are also available through JSDELIVR CDN.

List of Country Flag Emojis

You can use the following URL to get a list of all country flag emojis:

cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/index.json

[
  {
    "name": "Ascension Island",
    "code": "AC",
    "emoji": "🇦🇨",
    "unicode": "U+1F1E6 U+1F1E8",
    "image": "https://cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/images/AC.svg"
  },
  // More items...
  {
    "name": "Indonesia",
    "code": "ID",
    "emoji": "🇮🇩",
    "unicode": "U+1F1EE U+1F1E9",
    "image": "https://cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/images/ID.svg"
  },
  // More items...
]

name: The country name
code: The country code based on ISO 3166-1 alpha-2
emoji: The country flag emoji
unicode: The unicode code points for presenting the emoji flag
image: The country flag SVG image url

List of Country Flag Emojis by Country Code

If you prefer the list to be keyed by the country code, use the following URL:

cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/by-code.json

{
  "AC": {
    "name": "Ascension Island", 
    "emoji": "🇦🇨", 
    "unicode": "U+1F1E6 U+1F1E8", 
    "image": "https://cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/images/AC.svg"
  },
  // More items...
  "ID": {
    "name": "Indonesia",
    "emoji": "🇮🇩",
    "unicode": "U+1F1EE U+1F1E9",
    "image": "https://cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/images/ID.svg"
  },
  // More items...
}

Country Code for Subdivision Flags

As of 2021, there are three subdivision flags included: England, Scotland, and Wales. These countries are not listed on ISO 3166-1 alpha-2, thus three of them listed with a non-standard code field:

[
  // More items...
  {
    "name": "England",
    "code": "ENGLAND",
    "emoji": "🏴󠁧󠁢󠁥󠁮󠁧󠁿",
    "unicode": "U+1F3F4 U+E0067 U+E0062 U+E0065 U+E006E U+E0067 U+E007F",
    "image": "https://cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/images/ENGLAND.svg"
  },
  {
    "name": "Scotland",
    "code": "SCOTLAND",
    "emoji": "🏴󠁧󠁢󠁳󠁣󠁴󠁿",
    "unicode": "U+1F3F4 U+E0067 U+E0062 U+E0073 U+E0063 U+E0074 U+E007F",
    "image": "https://cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/images/SCOTLAND.svg"
  },
  {
    "name": "Wales",
    "code": "WALES",
    "emoji": "🏴󠁧󠁢󠁷󠁬󠁳󠁿",
    "unicode": "U+1F3F4 U+E0067 U+E0062 U+E0077 U+E006C U+E0073 U+E007F",
    "image": "https://cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/images/WALES.svg"
  }
]

Generate the JSON

If you want to generate the JSON files by yourself:

1. Clone the Repository

Clone this repository to your local computer:

$ git clone git@github.com:risan/country-flag-emoji-json.git

2. Install the Dependencies

CD into the project directory and install the dependencies:

# Go to the project directory
$ cd country-flag-emoji-json

# Install the dependencies
$ npm install

3. Generate the JSON Files

Run the following command to generate the JSON files:

$ npm run build

country-flag-emoji: List of country codes and its flag emojis.

Data Source

Emojis data used to generate the JSON files are provided by the Unicode Consortium.
All country flag SVG images are designed by OpenMoji – the open-source emoji and icon project. License: CC BY-SA 4.0

License

CC-BY-SA 4.0 · Risan Bagja Pradana

country-flag-emoji-json

Usage no npm install needed!