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
heartHeartPNGcircle-badgeCircle BadgePNGshieldShieldPNGdropTeardrop PinPNGbubble-markerBubble MarkerPNGcolor-pinColor PinPNGbadgeBadge SealPNGrounded-badgeRounded BadgePNGsquare-pinSquare PinPNGleaf-badgeLeaf BadgePNGflat-circleFlat CirclePNG, SVGflat-rectangleFlat RectanglePNG, SVGflat-squareFlat SquarePNG, SVGflat-heartFlat HeartPNGheart-badgeHeart BadgePNGflat-shieldFlat ShieldPNGsquare-badgeSquare BadgePNGsquare-shadowSquare ShadowPNGstamp-rectangleStamp RectanglePNGstamp-squareStamp SquarePNGFlag 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