Manually add Font Awesome icons in HubSpot

[vrneuman]

Font Awesome is a font of scalable vector icons that can be customized by size, color, and just about any attribute that can be changed with CSS. The easiest way to use Font Awesome icons in your content is by adding them in HubSpot's content editor.

The content editor currently uses version 5.6 of Font Awesome's library. You can access other versions of the Font Awesome Library by following the instructions below. 

Please note: Font Awesome icons will not work in email because the majority of email clients don't render webfonts. To use icons in an email, you will instead need to save icons as images, then insert the images into the email editor. 

Use the icon field in custom modules

You can select from pre-installed Font Awesome icons by adding an icon field to your custom modules. To add an icon field to a custom module:

• In your HubSpot account, navigate to Marketing > Files and Templates > Design Tools
• From the finder in the left sidebar, select an existing custom module. Or, create a new custom module.
• Add an icon field to the module by clicking Add field in the right sidebar, then selecting Icon.
  
  
• You can further customize the field by setting default values and editor options. Learn more about customizing module fields.
• Add the icon field to the module body by hovering over the field in the right sidebar, then clicking Actions. Select Copy snippet, then paste the snippet into the HTML + HUBL section where you want the icon to appear.
  
  
• In the upper right, click Publish.
• If this is a new module, add the module to any templates where you want to use the icons. Click Publish in the upper right to publish the template changes.
• You can now select Font Awesome icons in your custom module, either from the design manager or page editor.
  
  

Use a Font Awesome kit

You can add Font Awesome icons across your site by creating a Font Awesome kit, adding the code to your head HTML, and then adding the icons to your page. Learn more about Font Awesome kits.

• Start by creating a kit on Font Awesome's website. Once you create a kit, you'll be given a line of code that you can add to HubSpot. The code will look similar to:

  <script src="https://kit.fontawesome.com/xxxxxxxxxx.js" crossorigin="anonymous"></script>

• In HubSpot, paste the kit code into your site head HTML. This will make Font Awesome available across all pages, depending on the subdomain you choose when editing your site head HTML. To add Font Awesome to one page only, you can instead add the kit code to an individual page's head HTML.

Now that the kit is installed, you can add Font Awesome icons to your HubSpot pages.

Add icons to your page

To add an icon to a page, you'll need to edit your content HTML to assign Font Awesome classes to your elements. In HubSpot, this could mean editing a custom module or coded file, editing a blog template, or editing the source code of a rich text module in the page editor. 

Each icon has two parts to the class declaration:

• The icon name, prefixed by fa-. For example: fa-camera
• The style prefix. For example, fas. 

For brand icons, such as Facebook, you will need to use the fab style prefix. For example:

class="fab fa-facebook"

You can either use an <i> element or <span> element when inserting the icons. In the example below, both methods work:

<i class="fas fa-camera"></i>
<span class="fas fa-camera"></span>

Learn more about the basics of using Font Awesome icons in your content.

Add icons to your CTAs

After installing Font Awesome in HubSpot , you can use Font Awesome in your CTAs.

• In your HubSpot account, navigate to Marketing > Lead Capture > CTAs
• In the upper right, click Create CTA, or hover over an existing CTA and click the Actions dropdown menu and select Edit.
• In the right panel, rich text editor, click the source code icon code.

Please note: <i class=...> elements cannot be used with the source code of HubSpot's rich text editors. When you are implementing Font Awesome icons, it's recommended to use <span> tags as noted in the example below.

<h2>Font Awesome Icons Example</h2>
<ul class="fa-ul">
<li><span class="fab fa-twitter"></span>Twitter Icon</li>
<li><span class="fa-list-ul fa"></span>List Icon</li>
<li><span class="fa fa-camera-retro fa-lg fa"></span>Camera Icon</li>
</ul>

• Enter your code for your Font Awesome icon along with any text, and then click Save changes.
• Click Next, then click Save.

[Graham_USMC]

Bringing attention to author's original post that the icon option default "copy snippet" approach throws an error. I'm in production so I'm going to fall back to the old "photochop-it" strategy. 

Documentation on the error: https://community.hubspot.com/t5/CMS-Development/Custom-Module-Isn-t-Generating-HubSpot-Icons/m-p/42...

- Live long and write code 

[cdhq_cpander]

Hi @vrneuman  ,
thank you for this very helpful community post and the introductions!  - As my team also wanted to extend the available icons for our Hubspot Landingpage use cases, we also just bought the Fontawesome Pro license and integrated the Pro Kit succesful into our pages header.

But I just had the following issue: now it works to add the additional icons via source code e.g. in the richt text module very well. But when I try to add such new Icons via Insert - Icon  , these additonal Kit icons are not available in the selection.

Do you probably know if its possible to extend this icon selection too? 

Thanks for your help and feedback in any case!
Best, Constantin

[SteveHTM]

The icon field/tag use seems like a great option here - but I'm really having trouble in controlling the size of the icon created (outside of the <div> example given). How would size be controlled match font size in a <span> for example?

[TiphaineCuisset]

Hi @SteveHTM 

Thank you for reaching out. 

You can now insert and edit icons in your rich text modules by following these steps - that should make the process easier 

Hope that helps.
Have a lovely day,
Tiphaine.

[TiphaineCuisset]

Thank you for sharing @vrneuman !