cms · enhancement

How to inject the custom icons to Sitecore 8

Someone wants to inject their own icons to Sitecore 8 so that they will be able to change the icon of Sitecore items later inside Sitecore (please click here to get how to configure item icons). It’s something like this:


The Reference

Modifying \sitecore\shell\Applications\Content Manager\Dialogs\Set Icon\Set Icon.xml which handles Change Icon dialog of Sitecore:

  • replace CodeBeside to the new class so that we can have a chance to add the custom icons and some missing icons of Sitecore such as ApplicationsV2, BusinessV2, FlagsV2, NetworkV2, PeopleV2, SoftwareV2 to Change Icon dialog
    • csi_3csi_4
  • add new multiple ListItem to “Selector” Combobox
  • add new multiple Scrollbox to “List” Border
    • csi_6.png

In the new class SetIconForm which is cloned from Sitecore.Shell.Applications.ContentManager.Dialogs.SetIcon.SetIconForm

  • add new multiple properties:
    • csi_7
  • update RenderIcons method by adding these lines below:
    • csi_8

Creating a zip file as whose the folder structure should be same as the default ones (Ex: \sitecore\shell\Themes\Standard\ and putting it into \sitecore\shell\Themes\Standard folder

  • csi_9

PLEASE DO NOT FORGET to deploy the new SetIconForm class to the Sitecore instance.



Yes, I am. That’s why I create a Sitecore package so that I can install it and play with the custom icons + the missing ones as well on any Sitecore instances:

  1. should backup sitecore\shell\Applications\Content Manager\Dialogs\Set Icon\Set Icon.xml
  2. download it on Sitecore Marketplace or on Gitlab and install it to your Sitecore instance via Installation Wizard
    • Update (16-May-2018): a new version 1.1 is to make it work properly with Sitecore 9, otherwise you would see something like this
      • csi_20
    • the known issue: Sitecore 9 has its own custom icons (have a look at \sitecore\shell\Themes\Standard\Custom) so this module will replace them with our own custom icons after installing version 1.0
    • how to solve it: by defining the new name CustomIcons for all stuff of this module
  3. click Yes button when you see something like this
    • csi_10
  4. try to change the icon of a Sitecore item and hopefully you’re gonna see these ones
    • This slideshow requires JavaScript.


  1. in case you don’t see new custom icons on Change Icon dialog after adding them to file, please try to delete these files below in \Website\temp folder then open up that dialog again:
    • csi_20.png
  2. integration example:


Not Good Enough? Please feel free to download the source code and add your own enhancements if necessary.

Got issues?

Please send your issues (with screenshots if possible) to so that I have a chance to understand your problem and be able to suggest the solution.

Happy Sitecore Coding!

2 thoughts on “How to inject the custom icons to Sitecore 8

Leave a Reply

Please log in using one of these methods to post your comment: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.