Skip to content


Astro Icon supports every deployment method that Astro supports. Refer to the official Deploy your Astro Site guide for specific instructions.

Rendering Modes

Astro projects support multiple Rendering Modes, pages, routes, and API endpoints can be either pre-rendered at build time or rendered on demand by a server when a route is requested.


Astro projects that are entirely pre-rendered do not need any special configuration to use Astro Icon.

On-demand rendered

Astro projects that have enabled on-demand server rendering should take special care when using Astro Icon.

By default, all @iconify-json/* packages will be bundled into your server code, potentially bloating your server JavaScript bundles.

For complete control over the size of your bundle, it is highly recommended to configure the include option to enable only your required icons.