jal-co/shieldcn467

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

BadgeEndpointDescription
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
![badge](https://shieldcn.dev/flag/us.svg)
badge preview

Quick examples

![built in the USA](https://shieldcn.dev/flag/us.svg)
![built in Japan](https://shieldcn.dev/flag/jp.svg)
![built in Germany](https://shieldcn.dev/flag/de.svg?variant=outline)

Examples

France
Canada
South Korea
Australia
South Africa
Netherlands
European Union (region)
Outline variant

Default — the flag chip sits on a soft secondary surface.

![built in the USA](https://shieldcn.dev/flag/us.svg)

Outline variant — pairs well with a light-themed README header.

![built in Japan (outline)](https://shieldcn.dev/flag/jp.svg?variant=outline)

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:

![made in Japan](https://shieldcn.dev/flag/jp.svg?label=made+in)

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.