How to add a custom icon to a Craft CMS plugin

Oscar de la Hera Gomez
A flower that represents Craft CMS with the text "Plugin Icon" beneath it.

A step by step guide on adding a custom icon to a plugin in Craft CMS.

The following tutorial walks you through how to add a custom icon to a Craft CMS plugin.

We recommend that you download or clone our Open Source starter project, check out the main branch and complete the steps below. The changes can be found on the tutorial/plugin-icon.

git clone

Step One: Setup the plugin

A screenshot of our Sample Plugin Installed.

We recommend following the tutorial linked below to setup your Craft CMS plugin.

Step Two: Add the icon

A screenshot of Craft CMS showing our plugin icon.

A Craft CMS plugin icon must be a .svg titled icon.svg and must be added to the src folder of your Craft CMS plugin.

Any Questions ?

We are actively looking for feedback on how to improve this resource. Please send us a note to with any thoughts or feedback you may have.

delasign logo

Book a Free Consultation.

An icon of an email.

Click here to email us.

Fill in the details below to book a free consultation or to let us know about something else. Whatever it is, we are here to help.

How can we help you ?

Contact Details