> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/icon-sets/creating-a-new-icon-set.md).

# Creating a new Icon Set

### Introduction

This procedure details how to create a new Icon Set in Gallagher Command Centre.

**Note:**

Standard Gallagher Icon Sets are created with dimensions of 32 x 32 pixels, so when creating new Icons Sets these same dimensions, and 256 Colour format, should be used. Other dimensions can be made to work but will cause scaling to be applied which may reduce the effectiveness of the icons.

### Procedure

1. Click **Configure** from the menu bar, then **Icon Sets**.

   The **Icon Set** List Window opens (in [grid view](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/list-windows/grid-view.md)).
2. **Right click** and select **New\...Icon Set**.

   By default the **General** tab displays.
3. Complete the fields as required.

   For further detail see [General tab](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/generic-properties-configuration/general-tab.md).
4. Click the **Icons** tab.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-330c5633253b36952d1d99788909e3ac04089e8c%2Fnewicon_iconstab.png?alt=media)
5. From the drop-down list, select the Item Type that this Icon Set will be used with.

   **Note:**

   The drop-down list displays licensed items only, however the main **Icon Set** List Window displays all items.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-ba2328c959b09160efbecc11ac766d78295237b2%2Fnewicon_iconstab2.png?alt=media)

   The grids become populated with the two sets of icon state(s) applicable to that Item Type, (i.e. the upper grid displays the icons for the Command Centre Client and the lower grid displays the icons for the Configuration Client).

   **Note:**

   The number of states that display in the main grid will depend on the type of item that the Icon Set represents. For example, in the screen above, 'Door' was selected, therefore the various states of a Door display, (i.e. Open, Closed and Unknown).
6. In the appropriate grid for either the Command Centre Client or Configuration Client icons, click on the icon state you want to select a new icon for.

   The state name becomes highlighted ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-4b71fcdf716d49abc945483591d90382fc32fd3e%2Ficonstate.png?alt=media), and the **Change Icon...** button and the **Open Line / Area Colour...** field become enabled.
7. Click the **Change Icon...** button.

   A dialog displays for you to select an icon file from.

   **Note:**

   This dialog automatically displays the default icons which are stored by default in an Icons folder (this may differ depending on your installation) under:

   `"...\Gallagher\Command Centre"`
8. Path your way to the directory where the icon file you require is stored.

   **Note:** Only **\*.ico** and **\*.png** Icon image files can be used.
9. Select the icon file and click the **Open** button.

   The icon displays above the icon state.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-38e3f0b33de3c4bb0508fcf5d77eb918f487d3df%2Fnewicon_iconstab3.png?alt=media)
10. Repeat Steps 6-9 for all icon states.

    **Note:**

    If you try to save your changes before selecting a state for each icon, a message will display:

    *"An icon has not been selected for the \<name> state"*
11. Click on the **Open Line / Area Colour...** field.

    A colour swatch displays allowing you to change the colour of the line/area.

    **Note:**

    Only the standard 48 colours are available. The custom colour option is disabled.
12. Click on the required colour, and click the **OK** button.

    The colour of the line/area in the preview pane changes, displaying the new colour selected.
13. Click the **Custom Fields** tab if you want to add and assign a custom field value to this Icon Set.

    For further details regarding the **Custom Fields** tab, see [Custom Fields](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/server-properties/custom-fields.md).
14. Click the **Notes** tab if you want to add a note(s) about this Icon Set.

    For further details regarding the **Notes** tab, see [Notes](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/server-properties/notes.md).
15. Click **OK** to exit and save your changes.

    Click **Cancel** to exit without saving your changes.

    Click **Apply** to save your changes and stay in this window.

### Result

A new Icon Set has been created.

### Hint

{% hint style="info" %}
**Deleting Icon Sets**

Refer to [Deleting items](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/generic-properties-configuration/deleting-items.md) for the procedure on how to delete an Icon Set.

**Note:** The system will allow an Icon Set to be deleted providing it is not currently used by a site item, or it is the only Icon Set for an Item Type. If an Icon Set cannot be deleted, one of the following messages explaining why will display:

*"This Icon Set cannot be deleted, as it is still used by a site item."*

OR

*"This Icon Set cannot be deleted, as it is the only icon set assigned to a type of item."*
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/icon-sets/creating-a-new-icon-set.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
