> 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/command-centre-client/configuring-command-centre/administration/site-plans/creating-new-site-plan-items/site-plan-design-tools/add-control.md).

# Add Control

The ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-798c4e351823ee8490e5176a79ef2ecb4ad4f0da%2Fsiteplan_addcontrolbutton_selected.png?alt=media) **Add Control** button allows controls to be added to an item menu and is available when there is an item menu displayed (provided you have the privilege to change it.) Controls are small windows of information and/or operational actions related to a selected graphic object, with an associated item that is clicked on a Site Plan.

The types of Controls are described below:

**Note:** Alarm controls can only be added to an item menu that is defined as "alarm" state and the rest of the controls can be added to either "normal" or "alarm" state item menus.

### Alarm controls

* Alarm controls allow operators to view details about an alarm and perform the required action.

<details>

<summary>Alarm controls</summary>

Use the following procedure to add an Alarm control to an item menu:

1. Open the Item Menu you want to add a control to, and click the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-798c4e351823ee8490e5176a79ef2ecb4ad4f0da%2Fsiteplan_addcontrolbutton_selected.png?alt=media) **Add Control** button on the Designer Toolbar.
2. From the browse tool that displays, select **Alarm** and drag it into position on the Item Menu.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-93ca0745cd2a77d51749d816744176bf9f5098e7%2Fsiteplan_addcontrol_alarmbrowsetool.png?alt=media)

   When you release the mouse button, an Alarm Configuration pop-up displays.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-63c17d70186638dd3db6eb0a2c0b33bd548820ac%2Fsiteplan_alarmcontrolpopup.png?alt=media)

   An Alarm Instruction tells the operator what needs to be done when a particular alarm is raised, and this pop-up allows you to include Alarm Instruction if required.

   **Note:** Alarm Instructions are configured in the Configuration Client.
3. Leave the **Show Alarm Instructions** checkbox ticked if you want Alarm Instructions to show on the Site Plan.
4. Click the **OK** button.

   An Alarm Panel displays in the position on the Item Menu that you dragged the Control to.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-2b37da7a8be519dbb4a2254fe9b5fbec0d9dd9ce%2Fsiteplan_dragalarmcontrol.png?alt=media)
5. You have the option to **Delete** this control or **Configure** it again.

</details>

### Information only controls

* Property controls allow operators to view the properties of an item.

<details>

<summary>Property controls</summary>

Use the following procedure to add a Properties control to an item menu:

1. Open the Item Menu you want to add a control to, and click the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-798c4e351823ee8490e5176a79ef2ecb4ad4f0da%2Fsiteplan_addcontrolbutton_selected.png?alt=media) **Add Control** button on the Designer Toolbar.
2. From the browse tool that displays, select **Properties** and drag it into position on the Item Menu.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-9a58a13939e255042250fd1e608681b2c8d16c81%2Fsiteplan_addcontrol_propertiesbrowsetool.png?alt=media)

   When you release the mouse button, a Properties Panel displays in the position on the Item Menu that you dragged the Control to.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-f502d0db2cf9f171f6fec9c990fa10d9bf3ad093%2Fsiteplan_dragpropertiescontrol.png?alt=media)
3. You have the option to **Delete** this control.

</details>

* Last Accessed By controls allow operators to see who the last person was through the door.

<details>

<summary>Last Accessed By controls</summary>

This control is available for Item Menus applying to Doors (irrespective of state).

1. Open the Item Menu you want to add a control to, and click the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-798c4e351823ee8490e5176a79ef2ecb4ad4f0da%2Fsiteplan_addcontrolbutton_selected.png?alt=media) **Add Control** button on the Designer Toolbar.
2. From the browse tool that displays, select **Last Accessed By** and drag it into position on the Item Menu.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-92f15751498dc514b1c8ea3e348599d2ba414e8e%2Fsiteplan_addcontrol_lastaccessedbybrowsetool.png?alt=media)

   When you release the mouse button, a Last Accessed By pop-up displays.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-0540a2410a734ccb46daddb2c9377b1bc2e348e8%2Fsiteplan_lastaccessedbycontrolpopup.png?alt=media)
3. Select the required PDF(s) from the drop-down list.
4. Click the **OK** button.

   A Last Accessed By Panel displays in the position on the Item Menu that you dragged the Control to.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-fe79ef376177f190b60548a338c0b54e30a64507%2Fsiteplan_draglastaccessedbycontrol.png?alt=media)
5. You have the option to **Delete** this control or **Configure** it again.

</details>

### Monitoring controls

* Item Camera controls allow operators to see the footage associated with cameras.

<details>

<summary>Item Camera controls</summary>

Use the following procedure to add a Camera control to an item menu:

1. Open the Item Menu you want to add a control to, and click the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-798c4e351823ee8490e5176a79ef2ecb4ad4f0da%2Fsiteplan_addcontrolbutton_selected.png?alt=media) **Add Control** button on the Designer Toolbar.
2. From the browse tool that displays, select **Item Camera** and drag it into position on the Item Menu.

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

   When you release the mouse button, an Item Camera pop-up displays.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-d9a6c46f43bfade268fbd7b2ad8ce31f8281c713%2Fsiteplan_itemcameracontrolpopup.png?alt=media)
3. The **Assigned Camera Number** is the order in which the associated cameras are listed.

   Select the appropriate number for the camera.
4. Enabling the **Display Camera Controls** option means operators will be able to review stored footage and/or reposition PTZ controls.

   Tick the checkbox if required.
5. Click the **OK** button.

   A Camera Panel displays in the position on the Item Menu that you dragged the Control to.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-281d05b82c233b085b5906709b87c7fa34e1939e%2Fsiteplan_dragcameracontrol.png?alt=media)
6. You have the option to **Delete** this control or **Configure** it again.

</details>

* Fence Voltage controls allow operators to view the voltage of a fence zone.

<details>

<summary>Fence Voltage controls</summary>

This control is available for item menus applying to Fence Zones (irrespective of state).

1. Open the Item Menu you want to add a control to, and click the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-798c4e351823ee8490e5176a79ef2ecb4ad4f0da%2Fsiteplan_addcontrolbutton_selected.png?alt=media) **Add Control** button on the Designer Toolbar.
2. From the browse tool that displays, select **Fence Voltage** and drag it into position on the Item Menu.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-c25e7e4db211744b24bc725b339f94cf58e0e19f%2Fsiteplan_addcontrol_fencevoltagebrowsetool.png?alt=media)
3. When you release the mouse button, a Fence Voltage Panel displays in the position on the Item Menu that you dragged the Control to.

   **Note:** The configuration settings, (i.e. thresholds) for the Fence Zone Value Tool are based in the Configuration Client.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-b481acb9008705fe677fb8eafdd96e3c8a2be2b4%2Fsiteplan_dragfencevoltagecontrol.png?alt=media)
4. You have the option to **Delete** this control.

</details>

### Action / Override controls

* Override controls allows operators to perform an action against the item.

<details>

<summary>Override controls</summary>

This control is only available for items that can have an override.

Use the following procedure to add an Override control to an item menu:

1. Open the Item Menu you want to add a control to, and click the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-798c4e351823ee8490e5176a79ef2ecb4ad4f0da%2Fsiteplan_addcontrolbutton_selected.png?alt=media) **Add Control** button on the Designer Toolbar.
2. From the browse tool that displays, select the appropriate override control and drag it into position on the Item Menu.

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

   **Note:** This example is for an Access Zone which can have **Overrides** and **Timed Overrides** configured.

   The item type determines what override options are available, and whether or not they can be set for a specific duration.

   * **Non-timed overrides**

     Includes *Overrides*, *Open Door*, *Override Entry Access* and *Reset*
   * **Timed overrides** can be configured either until the next schedule change or for a set period of time

     Includes *Timed Overrides*, *Enable WWW Connections* and *Open Unallocated Lockers*
3. Did you select a Timed Override?

   <table><thead><tr><th width="76">If...</th><th>when you release the mouse button...</th></tr></thead><tbody><tr><td>no</td><td>an Override Configuration pop-up displays. This example is for Inputs.<br><img src="https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-df3bbf18a3fbfff7d5459deb84c1375f14651fd6%2Fsiteplan_8inputexpoverridecontrolpopup.png?alt=media" alt=""><br>Select the <strong>Overrides</strong> you want to be displayed for Control Room Operators, and go to Step 4.</td></tr><tr><td>yes</td><td><p>a Timed Override Configuration pop-up displays. This example is for Alarm Zones.<br><img src="https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-d2e320766bbd959cab56733195574590ac09e4a8%2Fsiteplan_accesszonetimedoverridecontrolpopup.png?alt=media" alt=""></p><ol><li>Select the <strong>Overrides</strong> you want to be displayed for Control Room Operators.</li><li><p>Set a <strong>Duration</strong> for the override(s), to assist Control Room Operators when deciding the period of time the override is required for.<br>You can select either:</p><ul><li><strong>Until Next Schedule Change</strong> (if this option is present), or</li><li><strong>Until Operator Specified Time</strong>, and enter the time of day you want the override to occur, or</li><li><strong>For an Operator Specified Duration</strong>, or</li><li><strong>For xx Hours, xx Minutes</strong>, and enter the hours and/or minutes (this is limited to a maximum of 23 hours and 59 minutes).</li></ul></li><li>Go to Step 4.</li></ol></td></tr></tbody></table>
4. Tick the **Confirmation** checkbox if you require Control Room Operators to be presented with a confirmation pop-up before performing an override.
5. Click the **OK** button.

   An Overrides Panel displays in the position on the Item Menu that you dragged the Control to.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-9d9be35d949d85d1ae4e6955742d4ed6d341b450%2Fsiteplan_dragtimedoverridescontrol.png?alt=media)

   **Note:** This example is for an Alarm Zone Timed Overrides.
6. You have the option to **Delete** this control or **Configure** it again.

</details>

* Run Macro controls allow operators to run a macro.

<details>

<summary>Run Macro controls</summary>

Use the following procedure to add a Run Macro control to a Macro item menu:

1. Open the Item Menu you want to add a control to, and click the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-798c4e351823ee8490e5176a79ef2ecb4ad4f0da%2Fsiteplan_addcontrolbutton_selected.png?alt=media) **Add Control** button on the Designer Toolbar.
2. From the browse tool that displays, select **Run Macro** and drag it into position on the Item Menu.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-401e3d07f147d466306314cde8920ed0c327ba8e%2Fsiteplan_addcontrol_macrobrowsetool.png?alt=media)
3. When you release the mouse button, a Run Macro Panel displays in the position on the Item Menu that you dragged the Control to.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-b6f083014a219460952bfc4d2ace05ef2cde7d8a%2Fsiteplan_dragmacrocontrol.png?alt=media)
4. You have the option to **Delete** this control.

</details>

* Context Report controls allow operators to run a contextual report.

<details>

<summary>Context Report controls</summary>

Use the following procedure to add a Context Report control to an item menu:

1. Open the Item Menu you want to add a control to, and click the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-798c4e351823ee8490e5176a79ef2ecb4ad4f0da%2Fsiteplan_addcontrolbutton_selected.png?alt=media) **Add Control** button on the Designer Toolbar.
2. From the browse tool that displays, select **Context Report** and drag it into position on the Item Menu.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-afc6dee1fca1503dc2966a782aeb627479834abe%2Fsiteplan_addcontrol_contextreportbrowsetool.png?alt=media)
3. When you release the mouse button, a Run Report Panel displays in the position on the Item Menu that you dragged the Control to.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-778f796b87ae6310e88697d3e962ca62c83b2054%2Fsiteplan_dragreportcontrol.png?alt=media)
4. You have the option to **Delete** this control.

</details>

* See Related Items controls allow operators to see relevant related items.

<details>

<summary>See Related Items controls</summary>

**Note:** This feature allows sites to declutter Site Plans by minimising the number of items on them. Operators can check the status of related items when something goes wrong, (e.g. if a door is offline they can check if it is just the door, or maybe the controller is offline too).

Use the following procedure to add a See Related Items control to an item menu:

1. Open the Item Menu you want to add a control to, and click the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-798c4e351823ee8490e5176a79ef2ecb4ad4f0da%2Fsiteplan_addcontrolbutton_selected.png?alt=media) **Add Control** button on the Designer Toolbar.
2. From the browse tool that displays, select **See Related Items** and drag it into position on the Item Menu.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-613b953ab7c28b204fa28c14cd4ecb577b52a5be%2Fsiteplan_addcontrol_seerelateditemstool.png?alt=media)

   When you release the mouse button, a See Related Items Panel displays in the position on the Item Menu that you dragged the Control to.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-5560327dee7392f20435d9722dc2fba25f7df86a%2Fsiteplan_relateditemscontrol.png?alt=media)
3. You have the option to **Delete** this control.

</details>


---

# 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/command-centre-client/configuring-command-centre/administration/site-plans/creating-new-site-plan-items/site-plan-design-tools/add-control.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.
