Writing & Markdown

Icons

Insert inline SVG icons from the six built-in HugoBlox packs (hero, brands, devicon, academicons, hb, custom) using the icon shortcode.

Usage

{{</* icon name="hero/rocket" */>}}
{{</* icon name="brands/github" */>}}
{{</* icon name="devicon/python" */>}}
{{</* icon name="academicons/orcid" */>}}

Parameters

ParameterTypeDescription
namestringRequired. Icon name in pack/icon format

Icon Packs

HugoBlox ships with six built-in packs. Omit the prefix and it defaults to hero/.

PackPrefixSource
Hero Iconshero/heroicons.com
Brand Iconsbrands/simpleicons.org
Devicondevicon/devicon.dev
Academiconsacademicons/jpswalsh.github.io/academicons
HugoBloxhb/Curated by the HugoBlox kit
Customcustom/Your own SVGs under assets/media/icons/custom/

Font Awesome is not bundled. Neither are Lucide, Material Icons, Bootstrap Icons, Tabler, or Iconify. If you find an fa-* example in someone else's config, translate it: brand logos go in brands/ (brands/github), dev tools in devicon/ (devicon/python), generic UI icons in hero/ (hero/rocket). For anything that has no built-in equivalent, drop the SVG into assets/media/icons/custom/ and reference it as custom/<name>.

For the full list of available icons and how to add custom icon packs, see the Icons Reference.

Was this page helpful?

From the makers of

© 2026 Lore Labs.

On this page