I need to add font icon in the admin menu.

Like all the core magento 2 menus, by default it shows the hexagonal icon for custom module menu, how can I change it?

enter image description here


1. Create Icon

By default magento 2 add custom default icon for you module.

But you can add your custom icon to your custom admin module menu.

Create custom icon .svg with inkscape software (open source soft for

creating vector try man !).

Create font icon of that .svg icon with help of IcoMoon.io

Go to lib/web/fonts

create your module folder. example Package and paste all files which obtained/exported from IcoMoon.io.

  1. injected it inside Magento 2 without touching the core files: Supposed your module name is Package_Modulename

go to app/design/adminhtml/Magento/backend

create folder with name Package_Modulename/web/css/source/

Create _module.less file under source folder

It will seem like Package_Modulename/web/css/source/_module.less

Now inside your file _module.less add this lines :

@modulename-icons-admin__font-name-path: '@{baseDir}fonts/modulename/icomoon';
@modulename-icons-admin__font-name : 'modulename';
@font-path: @modulename-icons-admin__font-name-path,
@font-weight: normal,
@font-style: normal
.admin__menu .item-modulename.parent.level-0 > a:before {
  font-family: @modulename-icons-admin__font-name;
  content: "\e800";

item-modulename : here modulename is comes from etc/adminhtml/menu.xml

        <add id="Package_Modulename::modulename" title="Modulename" module="Package_Modulename" sortOrder="40" resource="Package_Modulename::modulename"/> 

see the id Magento take the last word after ':: ' here is modulename and add the name to li html parent of a tag the class result is class='item-modulename parent level-0'

For more step by step understanding you can refer http://ibnab.com/en/blog/magento-2/magento-2-backend-how-to-create-custom-menu-in-admin-and-change-default-font-icon

  • BTW it should be .lib-font-face or .font-face? – MagePsycho Mar 27 '16 at 12:07
  • I m not sure how this worked for you? which gives .font-face is undefined error. Use .lib-font-face instead. – MagePsycho Mar 27 '16 at 19:13
  • I had used it into beta version. I am doing it now into stable and let you know. – Praful Rajput Mar 29 '16 at 6:27
  • it is not works for me. – MaYaNk Jun 9 '16 at 10:28
  • Can you please advice in detail, what thing do you face there? – Praful Rajput Jun 10 '16 at 8:46

I tried above solution but it not worked for me. so i tried to put _module.less file in


Direcrtory. and it works for me.

This is not recommended but i didn't find any other solution for this. so i try this solution. and it works. check the following file for make sure it work:


Where you should find a line like this:

@import '../Your_Module/css/source/_module.less';
  • 1
    Read this post, we describe in steps how to change in an easy way: uecommerce.com.br/… Thanks – Rafael Ortega Bueno Nov 18 '16 at 16:42
  • The vendor folder is subject to a lot of change, as soon as you do a Magento security patch, this change will vanish if using this route. And if you use a deploy system, this change will never appear. – evensis Jan 1 '19 at 13:38

Above mentioned answer are worked the different folders like lib, design.

So we have only worked the custom extension files. The step are:

1) you have create the menu.xml file for Package_Modulename/etc/adminhtml. Code are

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Backend:etc/menu.xsd">
        <add id="Package_Modulename::package_menu" title="package name" module="Package_Modulename" sortOrder="70" resource="Package_Modulename::package_menu"/>
        <add id="Package_Modulename::menu_config" title="Configuration" translate="title" module="Package_Modulename" sortOrder="1" parent="Package_Modulename::package_menu" resource="Package_Modulename::menu_config"/>

2) Create font icon of that .svg icon with help of IcoMoon.io. More details Documents

3) Create the default.xml file for Package_Modulename/view/adminhtml/layout. Coding are:

<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
        <css src="Package_Modulename::css/icon.css"/>

4) Create the fonts folder in Package_Modulename/view/adminhtml/web and paste the icon files. Files are





5) Create the icon.css file for Package_Modulename/view/adminhtml/web/css. Code are

@font-face {
    src:url('../fonts/icon.eot?#iefix') format('embedded-opentype'),url('../fonts/icon.woff') format('woff'),url('../fonts/icon.ttf') format('truetype'),url('../fonts/icon.svg') format('svg');font-weight:normal;font-style:normal

.admin__menu .level-0.item-package_menu > a::before {
    content: '\e900';
    font-size: 3.0rem;
    padding-top: 0.1rem;

Note: Above coding content: '\e900'; check the value. Please check font package file (demo.html). Refer the screen shot:

enter image description here

  • It worked me and it's very solution when have a sass implementation in frontend and not like compile less in admin area. – jruzafa Mar 29 '18 at 7:23
  • @jruzafa, Above comment does not understand. Please comment once again with detailed. – Sankar_k Mar 29 '18 at 9:42

Another "hackish" way to do it is to add a transparent png image in the vendor/modulename/view/adminhtml/web/images/icon.png and a few css lines in the vendor/modulename/view/adminhtml/web/css/styles.css:

/* you may have to adjust the selector a bit*/
.admin__menu .item-{modulename}-menu.last.level-0 > a:before {
    background: url("../images/icon.png") center center no-repeat;
    content: "";
    background-size: auto 95%;

.admin__data-grid-wrap .data-grid .data-grid-draggable .data-row .data-grid-thumbnail-cell .admin__control-thumbnail > img:before {

I personally had difficulties generating the webfonts and to be honest I find that approach a bit too much for an admin icon (1kb image).


You could also look for an admin icon that already exists and matches your needs inside the Iconography in Magento Admin Pattern Library and then look for the corresponding LESS variable at vendor/magento/theme-adminhtml-backend/web/css/source/variables/_icons.less file.

If you find something useful in this library, create your LESS file directly inside your module (no need for an adminhtml theme) at Vendor/ModuleName/view/adminhtml/web/css/source/_module.less and fill it with following content:

.admin__menu .item-modulename.parent.level-0 > a:before {
  content: @icon-tool__content; // Or whatever icon variable you want

Then, you must remove pub/static/adminhtml/Magento/backend/en_US/css/styles.css file, and reload the admin page

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.