Country Flags
Built-in country badges with a natural-aspect flag chip — 265 countries and regions.
Show where your project is built with a “built in your country” badge. The country flag is rendered as a crisp little chip at its natural proportions next to the label — no stretching, no cropping. 265 countries and regions are supported.
Available badges
| Badge | Endpoint | Description |
|---|---|---|
| Country flag | /flag/{code} | “built in country” with a flag chip |
{code} is an ISO 3166-1 alpha-2 country code (case-insensitive), e.g. us,
jp, gb. A handful of regions and subdivisions are supported too — see
Codes & regions below.
Path Parameters
Quick examples
Examples
Default — the flag chip sits on a soft secondary surface.
Outline variant — pairs well with a light-themed README header.
Codes & regions
- Countries — use any ISO 3166-1 alpha-2 code:
/flag/us,/flag/jp,/flag/gb,/flag/in, … - Definite articles are handled automatically:
us→ “the USA”,gb→ “the UK”,nl→ “the Netherlands”,eu→ “the European Union”. - Subdivisions —
gb-eng(England),gb-sct(Scotland),gb-wls(Wales),gb-nir(Northern Ireland),es-ct(Catalonia),es-ga(Galicia),es-pv(Basque Country). - Regions —
eu(European Union), and a few others. - Unknown codes return a readable text badge (never a broken image).
Codes are case-insensitive — /flag/US, /flag/us, and /flag/Us all work.
Customizing
All standard badge query params apply (variant, size, mode, font,
label, colors, etc.). For example, override the label text:
Data source
Flags are from country-flag-icons (3×2), rendered inline as a flag chip. Country names are resolved from a static ISO 3166-1 map. No API key required. Cached 1 hour.