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.
United States
United Kingdom
Japan
Germany
India
Brazil
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.
GET/flag/:code.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/flag/us.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/flag/us.svg?mode=light"></picture>
Quick examples
Examples
France
Canada
South Korea
Australia
South Africa
Netherlands
European Union (region)
Outline variant
Default — the flag chip sits on a soft secondary surface.
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/flag/us.svg?mode=dark"><img alt="built in the USA" src="https://shieldcn.dev/flag/us.svg?mode=light"></picture>Outline variant — pairs well with a light-themed README header.
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/flag/jp.svg?variant=outline&mode=dark"><img alt="built in Japan (outline)" src="https://shieldcn.dev/flag/jp.svg?variant=outline&mode=light"></picture>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.