You can still add duotone icons into your designs using ligatures, but we've changed how you access duotone layers using ligatures. In Version 5 you would access the primary layer using the -primary suffix and the secondary layer using the -secondary suffix. In Version 6 you now access the primary layer using a single hash (#) suffix and the secondary layer using a double has (##) suffix.
Layer
v5 Shortcut
v5 Example
v6 Shortcut
v6 Example
Primary layer
[icon-name]-primary
crow-primary
[icon-name]#
crow#
Secondary layer
[icon-name]-secondary
crow-secondary
[icon-name]##
crow##
Updating Version 5 Icon References
If you have existing files that reference Version 5 Duotone icons using the v5 ligature shortcuts, those will need to be manually updated to the new v6 syntax. Here are the manual steps to take for each reference:
Select the text boxes that contain the v5 Duotone icon's layers
Type the v6 shortcut for the current Duotone icon and layer
Adding New Icons After Upgrading
To use the Version 6 duotone icons open your desktop design app and create a text box with the font set to Font Awesome 6 Duotone. To get the primary layer, type the icon's name and then one hash (#). To get the secondary layer, type the name and two hashes (##).
Layer
v6 Shortcut
Example
Primary layer
[icon-name]#
crow#
Secondary layer
[icon-name]##
crow##
Typing crow# will get you the body of the crow, and typing crow## will get you the beak and legs.
Then change the font size to the size you want them to appear and set the text boxes to the same height and width. Adjust the color and opacity of the two layers as you like. The last step is to align the two text boxes to overlap using the align tools for vertical and horizontal center.
Assemble and align the parts of the duotone icon
Duotone Icons Using Glyphs
Advertisement
Remove ads with a Pro plan!
A subscription to a Pro-level plan will remove all third-party advertisements on fontawesome.com.
And of course Pro-level plans come with…
All 30,013 icons in Font Awesome
5 Classic styles of every icon
4 Sharp styles of every icon
A Perpetual License to use Pro
Services and tools to make easy work of using icons
While upgrading your duotone glyphs is pretty straightforward it's a bit fiddly. You'll treat it like changing any other type of font. The fiddly part about duotone icons is that they have multiple layers. Here's what you need to do.
Select each existing glyph layer.
Switch the selected font to Font Awesome Version 6.
Your glyph layers will update and now you're rocking the latest and greatest Font Awesome! For more information on aligning or using your glyphs please refer to our guide for using duotone glyphs.
Duotone Icons Using SVGs
Advertisement
Remove ads with a Pro plan!
A subscription to a Pro-level plan will remove all third-party advertisements on fontawesome.com.
And of course Pro-level plans come with…
All 30,013 icons in Font Awesome
5 Classic styles of every icon
4 Sharp styles of every icon
A Perpetual License to use Pro
Services and tools to make easy work of using icons