Hugo Shortcodes are simple snippets inside your content files calling built-in or custom templates You can create custom Shortcodes to avoid adding raw html to your content. Below is a Shortcode to use Font Awesome icons without directly writing html. Add the following to new file layouts/shortcodes/awesome.html {{ if .Get 0}} {{ else }} Shortcode usage: {{< awesome "far fa-smile-wink" >}} {{ end }} That code will add all the Shortcode parameters inside the class attribute of the i html tag.