Site Settings: Custom Icons
Upload custom SVG icons for use in menus, sidebars, footers, and marketing home page sections. Icons are validated, sanitised for security, and available across all icon pickers.
Custom icons allow you to upload your own SVG icons for use throughout the published site. Custom icons appear alongside the built-in icon libraries (Lucide, Heroicons, Bootstrap) in all icon pickers across the settings editor.
Uploading Custom Icons
SVG Requirements
Using Custom Icons
Once uploaded, custom icons are referenced using the custom:id format throughout the system. They appear in all icon pickers in the following areas:
Managing Custom Icons
Icon Rendering
Custom icons are rendered as inline SVG in the published site. The SVG content is embedded directly in the HTML, which means custom icons work offline and do not require additional network requests.