Static CDN

The Iconweuse Static CDN allows you to serve single vector assets or optimized CSS font bundles dynamically using our ultra-fast Edge Network. No build steps or installations required.

Using CSS Font Bundles

You can load all icons in a specific project kit by embedding a single stylesheet link. This links all vector styles as custom webfonts under our high-performance HTTP/3 servers.

<link href="https://cdn.iconweuse.com/icon/19babe39-18b5-4d71-9d28-84fbdc895142" rel="stylesheet" crossOrigin="anonymous" />

Note: The identifier in the URL corresponds to your project's unique Kit ID, which you can configure in your dashboard settings.

Referencing Single SVGs

If you do not want to load a font bundle, you can request and render individual SVG files directly via <img> tags or raw references:

<img src="https://cdn.iconweuse.com/svg/k4z9rm2tq1/regular/home.svg" alt="Home Icon" />

CDN Query Parameters

Customize how the CDN delivers your icons by adding query parameters to your requests:

• `v` (Version): Lock your kit to a specific version release, avoiding breaking changes during development. E.g., `?v=1.0.0`.
• `minify` (Compression): Minimizes stylesheet whitespace to reduce data transfer size. Defaults to `true` on production. E.g., `?minify=true`.
• `display` (Font Display): Configures browser CSS font-display options. Defaults to `swap`. E.g., `?display=block`.

Edge Caching & Performance

All CDN requests are cached across regional edge nodes. This ensures sub-millisecond response times for global users. When you deploy updates to your custom kits, our CDN automatically invalidates cache layers using stale-while-revalidate headers, delivering updates instantly without downtime.