A collection of flags for the countries specified in ISO 3166-1.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



A collection of flags for countries defined in ISO 3166-1, part of the ISO 3166 standard published by the International Organization for Standardization (ISO).


The scope of this collection is limited only to the flags of countries listed in the current edition of ISO 3166-1.

Countries without a flag

A place holder image is generated for countries without a flag. The place holder image consisted of the ISO 3166-1 alpha-2 code on a gray rectangular background.


If you identify an error please submit a new issue or open a pull request.

Many of the flags in this collection were obtained either from the Wikimedia Commons Flag project or OpenClipart.org. If you are creating or modifying artwork please consider submitting to these collections in the first instance, before submitting an issue to have it incorporated in this collection.

Why this project?

There are a number of other public domain flag collections available, many of them more extensive than this collection, such as:

The objective of this project is to produce a up-to-date and organised collection of sovereign flags for ISO 3166-1 countries that developers may easily incorporate into their projects without resorting to the use of web scrapers.

Files and directories

  • svg/

    Directory containing flag images in SVG format. File names follow this format: [ISO 3166-1 alpha-2 code (lowercase)].svg For example: nz.svg, gb.svg.

  • check

    Script for validating the flag collection against the official list of ISO 3166-1 countries.

  • flags.csv

    List of ISO 3166-1 country codes along with the flag file name, and the original file source.

  • iso3166-1_en.csv

    Official list of ISO 3166-1 countries. As the publicly available CSV and XML files are not version controlled please refer to different versions by the date("YYYY-mm-dd") of download from the ISO website.


    Licence information.

  • Makefile

    Example makefile for converting SVG images to raster formats.

  • placeholder.txt

    List of countries for which a placeholder image was generated.

  • README.md

    This file.

  • scraper

    Web scraper used to download the original set of flags from Wikimedia Commons Flag project