Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

Lots and lots of flags

What is this?

This is a big repository of flag images for countries (and subdivisions). The flags are all named according to ISO 3166 alpha-2 for easy use in applications. You can download the entire repository, or you can access individual flags via (see below for details).

You can see a list of all the flags available and the names/codes/aliases for the corresponding countries in this spreadsheet.

How do I use this?

You can get the flag for any country just by its two-letter code. Just access, where "xx" is the ISO 3166 alpha-2 country code (in lowercase).

This repository also has flags for many subdivisions of countries (including U.S. states, Canadian provinces, etc). Just access, where "xx" is the first part of the ISO 3166-2 code and "yy" is the second part after the dash (again, both parts in lowercase).

I have also added flags for many U.S. cities. There is no proper code standard I know of for identifying cities, so the format I used is simply, where "xx" is the two-letter state abbreviation in lowercase, and "yy" is the name of the city. The city name should be all lowercase, with spaces changed to underscores and all other non-alphabetic characters removed (i.e. "St. Paul" becomes "st_paul").

If SVGs don't suit your purpose, you can also access very low resolution PNGs via and However, be warned that I will probably be changing the directory structure for PNGs in the near future, so you shouldn't rely on it.

Why does this exist?

I originally made this repository to allow me to easily embed flags in Google Sheets. You can read more about how to do that here.

Is this freely usable?

Yes! Most of these flags are public domain images from Wikimedia Commons, so you can do with them what you want. Flags that are not freely licensed are listed in the SPECIAL_LICENSES.csv (note that the special licenses are only for the SVG recreations of the flags; the flags themselves are still public domain). Everything else in this repository that is not an image file is licensed under the MIT license.