# \[FEATURE\] Needing to restart gateway and designer after changing/adding icon libraries

**URL:** <https://forum.inductiveautomation.com/t/feature-needing-to-restart-gateway-and-designer-after-changing-adding-icon-libraries/112021>\
**Category:** Ignition\
**Tags:** ignition83\
**Created:** [November 7, 2025, 4:41am UTC](https://forum.inductiveautomation.com/t/feature-needing-to-restart-gateway-and-designer-after-changing-adding-icon-libraries/112021 "2025-11-07T04:41:23Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![nminchin](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/nminchin/32/6911_2.png) [@nminchin](https://forum.inductiveautomation.com/u/nminchin)\
**Post date:** [November 7, 2025, 4:41am UTC](https://forum.inductiveautomation.com/t/feature-needing-to-restart-gateway-and-designer-after-changing-adding-icon-libraries/112021/1 "2025-11-07T04:41:23Z")

</div>

I just discovered that you need to restart both the Gateway and every Designer when you’re importing new icon libraries. I’m onto my 6th restart so far… it’s getting a bit old testing a new icon library and making incremental changes…

In 8.1 you didn’t need to restart the gateway. You didn’t always have to restart the designer either, but it was always a bit hit and miss.

Can the project file scan please be made to work with icon library updates? and the Update Project button in the DEsigner be made to import these changes?

(I also found that the icon library I imported is called “icons” when it’s imported, regardless of my svg library name)

---

<div class="post-metadata">

**Author:** ![a.alghannam](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/a.alghannam/32/75158_2.png) [@a.alghannam](https://forum.inductiveautomation.com/u/a.alghannam)\
**Post date:** [November 7, 2025, 6:56am UTC](https://forum.inductiveautomation.com/t/feature-needing-to-restart-gateway-and-designer-after-changing-adding-icon-libraries/112021/2 "2025-11-07T06:56:43Z")

</div>

and how i can import a new icons library? 😅

---

<div class="post-metadata">

**Author:** ![andrew.budaiev](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/andrew.budaiev/32/72921_2.png) [@andrew.budaiev](https://forum.inductiveautomation.com/u/andrew.budaiev)\
**Post date:** [November 7, 2025, 8:15am UTC](https://forum.inductiveautomation.com/t/feature-needing-to-restart-gateway-and-designer-after-changing-adding-icon-libraries/112021/3 "2025-11-07T08:15:50Z")

</div>

Check this topic

> [@Custom Icon Library in 8.3](https://forum.inductiveautomation.com/t/custom-icon-library-in-8-3/109259/2):
>
> Okay, here's the current steps. Navigate to your install directory, and in the /data/config/resources/core/ folder, create a new folder com.inductiveautomation.perspective/ (if it doesn't already exist). Within that folder create an icons/ folder. Within that folder create a \<repository name\>/ folder. Within that folder, create: The spritesheet of your SVG, at whatever arbitrary filename you want, e.g. icons.svg. A config.json file that contains a single entry, svgFileName, that co…

---

<div class="post-metadata">

**Author:** ![a.alghannam](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/a.alghannam/32/75158_2.png) [@a.alghannam](https://forum.inductiveautomation.com/u/a.alghannam)\
**Post date:** [November 7, 2025, 2:13pm UTC](https://forum.inductiveautomation.com/t/feature-needing-to-restart-gateway-and-designer-after-changing-adding-icon-libraries/112021/4 "2025-11-07T14:13:08Z")

</div>

I’ve tried it and it is not working. no matter what i try. it never worked.  
the best i can get is adding the icon library to the drop list. but icons never get displayed. but the path is working. and i keep getting error in the log

 ![Screenshot 2025-11-07 181244](https://us1.discourse-cdn.com/inductiveautomation/original/3X/d/a/dac3d44247bcd67711dda50a33c139f3a301f209.png)

 ![Screenshot 2025-11-07 180959](https://us1.discourse-cdn.com/inductiveautomation/original/3X/4/2/4233d7cee0fb739140f2e8b08e85b6a0e01e56ed.png)

EDIT: It worked finally. the format of the sprite file must be very accurate. make sure to follow this format:  
[https://forum.inductiveautomation.com/t/use-custom-svg-for-navicon/28637/2?u=a.alghannam](https://forum.inductiveautomation.com/t/use-custom-svg-for-navicon/28637/2)

---

<div class="post-metadata">

**Author:** ![cmallonee](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/cmallonee/32/6416_2.png) [@cmallonee](https://forum.inductiveautomation.com/u/cmallonee)\
**Post date:** [November 7, 2025, 3:58pm UTC](https://forum.inductiveautomation.com/t/feature-needing-to-restart-gateway-and-designer-after-changing-adding-icon-libraries/112021/5 "2025-11-07T15:58:47Z")

</div>

There’s something wrong with the relevant files. Could you please share the files you’re using? Not snippets - attach the actual files, please.

---

<div class="post-metadata">

**Author:** ![paul-griffith](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/paul-griffith/32/37249_2.png) [@paul-griffith](https://forum.inductiveautomation.com/u/paul-griffith)\
**Post date:** [November 7, 2025, 4:38pm UTC](https://forum.inductiveautomation.com/t/feature-needing-to-restart-gateway-and-designer-after-changing-adding-icon-libraries/112021/6 "2025-11-07T16:38:59Z")

</div>

> [@nminchin](#):
>
> Can the project file scan please be made to work with icon library updates?

No, but you can use the **config** scan and it will pick up icons just fine.

> [@nminchin](#):
>
> (I also found that the icon library I imported is called “icons” when it’s imported, regardless of my svg library name)

The name of the icon library is derived from the _resource_ name, which will be the name of the folder containing the resource files. In other words, the icon library name will be `custom` here, not `whateverYouWant.svg`:

 ![image](https://us1.discourse-cdn.com/inductiveautomation/original/3X/5/5/5535b0ab1931cc5a76774594d943496d0244495d.png)

> [@nminchin](#):
>
> You didn’t always have to restart the designer either, but it was always a bit hit and miss.

I'm aware of two issues:

1. The _preview_ of the icon library you get in the designer will never update after the designer has started. This was just laziness on our part, and means you do have to do a full designer restart for the **preview** to update.
2. There appears to be some internal caching of the active 'page' you're looking at in the designer. I was able to bust this cache just by shift + right clicking the view and selecting 'Refresh Browser'. Make sure you've saved any pending changes to the view before you do this:  
 ![image](https://us1.discourse-cdn.com/inductiveautomation/original/3X/f/c/fcf3dcc0a68845cf1cc6fa27ce8aa10cf43efe43.png)

All that said - this "worked" for me, with the following steps:

1. Make a change to the icon library SVG file on disk.
2. Hit the scan endpoint for **gateway config**.
3. Refresh the active Perspective view in the designer (or just close and reopen it).
4. Manually enter the icon I just added.

I'm not going to blow smoke and pretend this is _great_ UX, but it's also not as catastrophic as having to restart both the gateway and the designer with every change.

---

<div class="post-metadata">

**Author:** ![nminchin](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/nminchin/32/6911_2.png) [@nminchin](https://forum.inductiveautomation.com/u/nminchin)\
**Post date:** [November 8, 2025, 2:25pm UTC](https://forum.inductiveautomation.com/t/feature-needing-to-restart-gateway-and-designer-after-changing-adding-icon-libraries/112021/8 "2025-11-08T14:25:04Z")

</div>

> [@paul-griffith](#):
>
> The name of the icon library is derived from the _resource_ name, which will be the name of the folder containing the resource files. In other words, the icon library name will be `custom` here, not `whateverYouWant.svg`:

Ah that makes more sense. The section in the user manual is super confusing. It says to add the SVG and create the resource and config files directly inside the icons folder… I didn't think that sounded right. I was wondering how you then added more..

> [@paul-griffith](#):
>
> No, but you can use the **config** scan and it will pick up icons just fine.

Hmm, I must have missed this, I've only seen the project scan.

Sounds like it’s not as bad as I thought. The library not updating isn’t the end of the world! Cheers
