Skip to content
Last updated

The icon tag renders a Font Awesome icon. Icons can be used inline with text to provide additional visual context.

Attributes

AttributeTypeDescription
namestringREQUIRED. The name of a Font Awesome icon. Can be prefixed with a style: duotone, solid, regular or brands. Example: book, duotone book.
sizestringThe size of the icon. Accepts any CSS value for size, like px or em. Defaults to 1em.
colorstringThe color of the icon. Accepts any CSS color value.

Examples

Basic usage

To display a simple book icon:

Here is a book icon: {% icon name="book" /%}

Result:

Here is a book icon:

Sized and colored icon

To display a larger, colored icon:

A bigger, blue book icon: {% icon name="book" size="2em" color="blue" /%}

Result:

A bigger, blue book icon:

Different icon styles

You can specify a style for the icon, like solid or brands.

A solid check-circle: {% icon name="solid check-circle" color="green" /%}

A GitHub brand icon: {% icon name="brands github" /%}

Result:

A solid check-circle:

A GitHub brand icon:

Usage with other components

Icons are commonly used in navigation elements to provide visual cues. For more information on using icons in specific components, refer to the following documentation: