Font Awesome 3.2.1 compatibility package for Sugar 7.6

Matthew Marum —  June 3, 2015

In last week’s post on the Font Awesome 4.x upgrade in Sugar 7.6 we mentioned that Sugar Engineering has been putting together a compatibility package.  This package can be installed into Sugar 7.6 instances to add Font Awesome 3.2.1 back.

That package is now ready.  It can be installed into Sugar 7.6 Beta or Sugar 7.6 GA once that is available.

Package Installation

This package installs the Font Awesome 3.2.1 library used in Sugar 7.5 into a Sugar 7.6 instance. This restores the function of old Font Awesome CSS classes if there is code in a Sugar 7.6 instance that still relies on Font Awesome 3.2.1 in order to display icons.

SugarCRM offers no support on the use of this package.  We need Sugar Developers to move to Font Awesome 4.x.

Step 1: Identify that you actually need this package.  If you find that icons are missing from customizations in a Sugar 7.6 instance then installing this package will restore them.  Specifically, if your custom Sugar 7 HTML contains CSS classes that start with “icon-“.

Step 2: Download the FontAwesome-321 package.

Step 3: Install it on your Sugar 7.6 instance using Module Loader.

Your icons will then reappear.

Performance Warning

Installing this package does cause a degradation in render performance in Sugar 7.6. Sugar 7 is moving from 3.2.1 to 4.x for the improved performance. Only use this package if you know it is necessary.  Once in use, it should be uninstalled as soon as code customizations are migrated.

Moving to Font Awesome 4.x is easy, check out this blog post for migration details.

If you have any questions, please e-mail

Matthew Marum


Matt is the Director of Developer Advocacy for SugarCRM. Previously he was an Engineer on Sugar 7 and a Solutions Architect for the OEM program. He is also an avid trail runner, Boston Marathon qualifier and a karaoke aficionado.

Trackbacks and Pingbacks:

  1. Upgrade to Font Awesome 4.2 in Sugar 7.6 « Sugar Developer Blog – SugarCRM - June 3, 2015

    […] Font Awesome 3.2.1 compatibility package for Sugar 7.6 […]