country-flag-icons

![npm version](https://www.npmjs.com/package/country-flag-icons)
![npm downloads](https://www.npmjs.com/package/country-flag-icons)

Vector country flag icons in 3:2 aspect ratio.

* Optimized for small size on screen (little detail, minimalism).
* Small file size (generally 1 KB per flag).
* Exports a React component for each flag (from /react subpackage).

See the flags

Install



npm install country-flag-icons --save





API



$3



Tells whether there's a flag for a given country code.

js

import { hasFlag } from 'country-flag-icons'



hasFlag('US') === true

hasFlag('ZZ') === false





$3



The list of supported country codes.

js

import { countries } from 'country-flag-icons'



countries.includes('US') === true

countries.includes('ZZ') === false





$3



Flags can be linked directly from this library's gitlab pages website, or from a github pages mirror, which seems a tiny bit faster.

html

  alt="United States"

  src="https://purecatamphetamine.github.io/country-flag-icons/3x2/US.svg"/>





Flags can also be used in the form of CSS classes imported from

country-flag-icons/3x2/flags.css where all flag icons are inlined as background-image data URLs. CSS flag icon height can be set via --CountryFlagIcon-height

 CSS variable.



What if my project doesn't use CSS variables?



####



In that case, the default flag icon height is

1em, and to change it, just set a font-size

css

/ Set flag icon height to 24px. /

[class*=' flag:'], [class^='flag:'] {

  font-size: 24px;

}





$3



Unicode flag icons are available under the

/unicode

 export.

js

import getUnicodeFlagIcon from 'country-flag-icons/unicode'



getUnicodeFlagIcon('US') === '🇺🇸'

getUnicodeFlagIcon('ZZ') === '🇿🇿'





Unicode flag icons ("Regional Indicator Symbols") were introduced in 2010 in Unicode version 6.0.



Older operating systems might not support Unicode flags, either rendering "missing" (rectangle) characters (if their system doesn't support country flags), or displaying two-letter country codes instead of emoji flag images. For example, Windows 10 currently (01.01.2020) doesn't support Unicode country flags, and displays two-letter country codes instead of emoji flag images.



$3



React components for all flags are available at

/react/3x2

 export.

js

import { US } from 'country-flag-icons/react/3x2'





Or directly, if your bundler doesn't support tree shaking:

js

import US from 'country-flag-icons/react/3x2/US'





$3



There's an experimental component for Vue 3.



$3



All flags can also be imported as strings:

js

import { US } from 'country-flag-icons/string/3x2'



console.log(US) // > '





Or directly, if your bundler doesn't support tree shaking:

js

import US from 'country-flag-icons/string/3x2/US'



console.log(US) // > '





Country Code



This library includes the flags for all ISO-3166-1 country codes such as

US, CA

, etc.



Additionally, this library includes the flags for the following "exceptional reservations" of the ISO-3166-1 standard, which are not official ISO-3166-1 country codes, but still there have been requests to include them:

*

 — European Union

*

 — Canary Islands



Additionally, this library includes the flags for the "unofficial" two-letter codes used by

libphonenumber-js

:

*

 — Ascension Island

  *

 is an "exceptional reservation" of the ISO-3166-1 standard.

  * The last official ISO-3166-2 "subdivision code" assigned to Ascension Island region is

SH-AC

.

*

 — Tristan da Cunha

  *

 is an "exceptional reservation" of the ISO-3166-1 standard.

  * The last official ISO-3166-2 "subdivision code" assigned to Tristan da Cunha region is

SH-TA

.

*

 — Kosovo

  *

 is a "user-assigned" code in the ISO-3166-1 standard meaning that it can be freely assigned to any region by any application or organization for its own purposes.

  * This "user-assigned" code may potentially be changed or removed at any time.

  * The last official ISO-3166-2 "subdivision code" assigned to Kosovo region is

RS-KM

.

*

 — Abkhazia

  *

 is a "user-assigned" code in the ISO-3166-1 standard meaning that it can be freely assigned to any region by any application or organization for its own purposes.

  * This "user-assigned" code may potentially be changed or removed at any time.

  * The last official ISO-3166-2 "subdivision code" assigned to Abkhazia region is

GE-AB

.

*

 — South Ossetia

  *

 is a "user-assigned" code in the ISO-3166-1 standard meaning that it can be freely assigned to any region by any application or organization for its own purposes.

  * This "user-assigned" code may potentially be changed or removed at any time.

  * South Ossetia region has not ever been assigned any official ISO-3166-2 "subdivision code".

*

 — Northern Cyprus

  *

 is a "user-assigned" code in the ISO-3166-1 standard meaning that it can be freely assigned to any region by any application or organization for its own purposes.

  * This "user-assigned" code may potentially be changed or removed at any time.

  * Northern Cyprus region has not ever been assigned any official ISO-3166-2 "subdivision code".



Additionally, this library includes the flags for certain official ISO-3166-2  "subdivision codes" because there have been requests to include them:



*

 — Caribbean Netherlands

  *

BQ-BO

 — Bonaire

  *

BQ-SA

 — Saba

  *

BQ-SE

 — Sint Eustatius

*

 — United Kingdom

  *

GB-ENG

 — England

  *

GB-NIR

 — Northern Ireland

  *

GB-SCT

 — Scotland

  *

GB-WLS

 — Wales

*

 — Spain

  *

ES-CT

 — Catalonia



GitHub



On March 9th, 2020, GitHub, Inc. silently banned my account (erasing all my repos, issues and comments) without any notice or explanation. Because of that, all source codes had to be promptly moved to GitLab. The GitHub repo is now only used as a backup (you can star the repo there too), and the primary repo is now the GitLab one. Issues can be reported in any repo.



Alternatives



* FlagKit — MIT licence

  -

1.4x1

flagpack

 — MIT licence

  -

4x3

1x1





Credits



I used Google image search for flag references, and various country flag packs (including FlagKit /

flagpack

) for design ideas. Sometimes there was no need to re-draw a flag — usually in cases when a flag is just a set of colored stripes and there already is an SVG version of it somewhere at Wikipedia or some other free flag pack, so in those cases I simply copied those flags (because they look the same in every flag pack).



Some countries officially use their "mother" country flag (those used to be colonies). For example,

BV (Bouvet Island) and SJ (Svalbard and Jan Mayen) use the flag of Norway; GP (Guadeloupe) and RE

 (Réunion) use the flag of France.



CSS flag icons feature has been submitted by

@mindplay-dk

`country-flag-icons`





![npm version](https://www.npmjs.com/package/country-flag-icons)

![npm downloads](https://www.npmjs.com/package/country-flag-icons)



Vector country flag icons in 3:2 aspect ratio.







* Optimized for small size on screen (little detail, minimalism).

* Small file size (generally 1 KB per flag).

* Exports a React component for each flag (from /react subpackage).



See the flags







Install



``

npm install country-flag-icons --save

`



API



$3



Tells whether there's a flag for a given country code.



`js

import { hasFlag } from 'country-flag-icons'



hasFlag('US') === true

hasFlag('ZZ') === false

`



$3



The list of supported country codes.



`js

import { countries } from 'country-flag-icons'



countries.includes('US') === true

countries.includes('ZZ') === false

`



$3



Flags can be linked directly from this library's gitlab pages website, or from a github pages mirror, which seems a tiny bit faster.



`html

  alt="United States"

  src="https://purecatamphetamine.github.io/country-flag-icons/3x2/US.svg"/>

`



Flags can also be used in the form of CSS classes imported from country-flag-icons/3x2/flags.css where all flag icons are inlined as background-image data URLs. CSS flag icon height can be set via --CountryFlagIcon-height CSS variable.





What if my project doesn't use CSS variables?



####



In that case, the default flag icon height is 1em, and to change it, just set a font-size:



`css

/ Set flag icon height to 24px. /

[class*=' flag:'], [class^='flag:'] {

  font-size: 24px;

}

`





$3



Unicode flag icons are available under the /unicode export.



`js

import getUnicodeFlagIcon from 'country-flag-icons/unicode'



getUnicodeFlagIcon('US') === '🇺🇸'

getUnicodeFlagIcon('ZZ') === '🇿🇿'

`



Unicode flag icons ("Regional Indicator Symbols") were introduced in 2010 in Unicode version 6.0.



Older operating systems might not support Unicode flags, either rendering "missing" (rectangle) characters (if their system doesn't support country flags), or displaying two-letter country codes instead of emoji flag images. For example, Windows 10 currently (01.01.2020) doesn't support Unicode country flags, and displays two-letter country codes instead of emoji flag images.



$3



React components for all flags are available at /react/3x2 export.



`js

import { US } from 'country-flag-icons/react/3x2'





`



Or directly, if your bundler doesn't support tree shaking:



`js

import US from 'country-flag-icons/react/3x2/US'





`



$3



There's an experimental component for Vue 3.



$3



All flags can also be imported as strings:



`js

import { US } from 'country-flag-icons/string/3x2'



console.log(US) // > '
`



Or directly, if your bundler doesn't support tree shaking:



`js

import US from 'country-flag-icons/string/3x2/US'



console.log(US) // > '`



Country Code



This library includes the flags for all ISO-3166-1 country codes such as US, CA, etc.



Additionally, this library includes the flags for the following "exceptional reservations" of the ISO-3166-1 standard, which are not official ISO-3166-1 country codes, but still there have been requests to include them:

* EU — European Union

* IC — Canary Islands



Additionally, this library includes the flags for the "unofficial" two-letter codes used by libphonenumber-js:

* AC — Ascension Island

  * AC is an "exceptional reservation" of the ISO-3166-1 standard.

  * The last official ISO-3166-2 "subdivision code" assigned to Ascension Island region is SH-AC.

* TA — Tristan da Cunha

  * TA is an "exceptional reservation" of the ISO-3166-1 standard.

  * The last official ISO-3166-2 "subdivision code" assigned to Tristan da Cunha region is SH-TA.

* XK — Kosovo

  * XK is a "user-assigned" code in the ISO-3166-1 standard meaning that it can be freely assigned to any region by any application or organization for its own purposes.

  * This "user-assigned" code may potentially be changed or removed at any time.

  * The last official ISO-3166-2 "subdivision code" assigned to Kosovo region is RS-KM.

* XA — Abkhazia

  * XA is a "user-assigned" code in the ISO-3166-1 standard meaning that it can be freely assigned to any region by any application or organization for its own purposes.

  * This "user-assigned" code may potentially be changed or removed at any time.

  * The last official ISO-3166-2 "subdivision code" assigned to Abkhazia region is GE-AB.

* XO — South Ossetia

  * XO is a "user-assigned" code in the ISO-3166-1 standard meaning that it can be freely assigned to any region by any application or organization for its own purposes.

  * This "user-assigned" code may potentially be changed or removed at any time.

  * South Ossetia region has not ever been assigned any official ISO-3166-2 "subdivision code".

* XC — Northern Cyprus

  * XC is a "user-assigned" code in the ISO-3166-1 standard meaning that it can be freely assigned to any region by any application or organization for its own purposes.

  * This "user-assigned" code may potentially be changed or removed at any time.

  * Northern Cyprus region has not ever been assigned any official ISO-3166-2 "subdivision code".



Additionally, this library includes the flags for certain official ISO-3166-2  "subdivision codes" because there have been requests to include them:



* BQ — Caribbean Netherlands

  * BQ-BO — Bonaire

  * BQ-SA — Saba

  * BQ-SE — Sint Eustatius

* GB — United Kingdom

  * GB-ENG — England

  * GB-NIR — Northern Ireland

  * GB-SCT — Scotland

  * GB-WLS — Wales

* ES — Spain

  * ES-CT — Catalonia



GitHub



On March 9th, 2020, GitHub, Inc. silently banned my account (erasing all my repos, issues and comments) without any notice or explanation. Because of that, all source codes had to be promptly moved to GitLab. The GitHub repo is now only used as a backup (you can star the repo there too), and the primary repo is now the GitLab one. Issues can be reported in any repo.



Alternatives



* FlagKit — MIT licence

  - 1.4x1

* flagpack — MIT licence

  - 4x3

  - 1x1



Credits



I used Google image search for flag references, and various country flag packs (including FlagKit / flagpack) for design ideas. Sometimes there was no need to re-draw a flag — usually in cases when a flag is just a set of colored stripes and there already is an SVG version of it somewhere at Wikipedia or some other free flag pack, so in those cases I simply copied those flags (because they look the same in every flag pack).



Some countries officially use their "mother" country flag (those used to be colonies). For example, BV (Bouvet Island) and SJ (Svalbard and Jan Mayen) use the flag of Norway; GP (Guadeloupe) and RE (Réunion) use the flag of France.



CSS flag icons feature has been submitted by @mindplay-dk.