URL Pattern
All flag icons follow a consistent URL structure:
https://cdn.freeflags.org/{style}/{country}-flag-{style}-{size}.png{style}Icon style — e.g.
flat-circle, heart, shield{country}Country slug — e.g.
thailand, united-states, france{size}Image size in pixels —
64, 128, or 512Try the Flag Icon CDN
Pick a country flag and icon style to preview the CDN URL:
SVG (vector)
Available for flat-circle, flat-rectangle, and flat-square styles. Drop the size from the URL:
Available Flag Icon Styles
Use these style keys in the CDN flag icons URL:
KeyNameFormats
heartСердцеPNGcircle-badgeКруглый значокPNGshieldЩитPNGdropКапляPNGbubble-markerМаркер-пузырьPNGcolor-pinЦветная булавкаPNGbadgeЗначокPNGrounded-badgeКруглый бейджPNGsquare-pinКвадратная булавкаPNGleaf-badgeЛистовой бейджPNGflat-circleПлоский кругPNG, SVGflat-rectangleПлоский прямоугольникPNG, SVGflat-squareПлоский квадратPNG, SVGflat-heartПлоское сердцеPNGheart-badgeЗначок-сердцеPNGflat-shieldПлоский щитPNGsquare-badgeКвадратный значокPNGsquare-shadowКвадрат с теньюPNGstamp-rectangleМарка прямоугольнаяPNGstamp-squareМарка квадратнаяPNGFlag CDN Code Examples
Use country flag icons from CDN in HTML, CSS, React, or Markdown:
HTML
CSS
React
Markdown
Flag Icons CDN Usage Notes
- All country flag icons are free for personal and commercial use
- No authentication or API key required — just use the CDN link
- Served from a global CDN for fast loading worldwide
- PNG flag icons have transparent backgrounds
- SVG flag icons available for flat-circle, flat-rectangle, and flat-square styles
- Works as a CSS flag icon CDN — use in
background-imageor<img>tags - Country slugs use lowercase with hyphens (e.g.
united-states,south-korea) - Compatible alternative to flag-icon-css and bootstrap flag CDN packages