> 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/viewer-configuration-overall-process/creating-a-new-viewer.md).

# Creating a new Viewer

### Introduction

This procedure describes how to create a new Viewer, with the exception of Site Plan Viewers. Configuration of Site Plan Viewers differs from other viewers as their structure is different, (i.e. they do not have a Navigation Panel, nor do they use tiles). Therefore, see [Configuring a Site Plan Viewer](https://help.security.gallagher.com/knowledge-hub/command-centre-client/configuring-command-centre/viewer-configuration-overall-process/configuring-a-site-plan-viewer.md) for the procedure on configuring Site Plan Viewers.

**Note:** Size and position of the Start menu, size of the taskbar and screen resolution should all be taken into account when configuring Viewers. Therefore it is recommended you configure Viewers either on the machine that they will be used on, or on a representative screen.

### Procedure

1. From the Configuration Viewer click the **New Viewer** button, and then click the type of Viewer you require, (i.e. Alarm Viewer, Cardholder Viewer, Controlled Challenge Viewer, Event Viewer, Monitor Site Viewer, or Spot Monitor Viewer).

   A Configuration pop-up displays.

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

   **Note:** This example is of the **Cardholder Viewer General Configuration** pop-up, however these same fields appear on the pop-ups for the other Viewer types.
2. Complete the fields as required.

<details>

<summary>Click here for a description of how the fields are populated</summary>

<table><thead><tr><th width="148">Field/Checkbox</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Defaults to <em>'&#x3C;Type of Viewer> Viewer &#x3C;next number that would make the name unique>'</em>.</td></tr><tr><td>Division</td><td><p>Defaults to the last Division in which the Operator created a Command Centre item, regardless of whether it was created in Configuration Client or via Command Centre Client.<br>The division can be changed, as follows:</p><ol><li>Click the <strong>&#x3C;Division Name></strong> button.<br>A browse tool displays.<br><img src="https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-5ea28b89c753564de542b1b9c1b328d1e0fc8c60%2Fselectdivisionforviewer_popup.png?alt=media" alt=""><br><br><strong>Note:</strong> Only divisions to which you are privileged to see will appear in the list.</li><li>Select the Division you want the Viewer to be in.</li><li>Click the <strong>OK</strong> button.<br>The browse tool closes and the name of the button changes to reflect the name of the Division you selected.</li></ol></td></tr><tr><td>Viewer Description</td><td>This field is blank.</td></tr><tr><td>Dock</td><td>This is used to determine the position of the Viewer's Navigation Panel. Available options are Top, Bottom, Left, Right, with the default value depending on the Viewer.<br><br><strong>Note:</strong> It is recommended that you dock the Navigation Panel either at the top or bottom for a Spot Monitor Viewer.</td></tr><tr><td>Resolution</td><td><p>This is used to determine the aspect ratio of the screen the Viewer is being configured for. The default is to use the resolution of the screen on which the Viewer is being configured, represented by the 'Current Screen' option. The following standard resolution options are available:<br>1024x768 (Old CRT monitor or non-widescreen TV, many projectors)<br>1280x720 (720p HD video and some widescreen laptops)<br>1280x800 (Many 13-15 inch widescreen laptops)<br>1366x768 ("HD Ready" TV's and some widescreen laptops)<br>1280x1024 (17 and 19 inch non-widescreen LCD monitors)<br>1440x900 (Some 15-17 inch widescreen laptops or 19 inch widescreen LCD monitors)<br>1680x1050 (Many 20 and 22 inch widescreen LCD's)<br>1920x1080 ("Full HD" TV's, 1080p HD video and some 24 inch LCD monitors)<br>1920x1200 (Many 24-27 inch widescreen LCD monitors)<br>2560x1440 (Wide Quad HD Monitors)<br>3840x2160 (4K Ultra HD Monitors)<br><br><strong>Notes:</strong></p><ul><li>This may change the aspect ratio of the Viewer displayed in the Configuration Panel.</li><li>If you need to configure a viewer for a resolution that is not listed then you can do so by logging on to the client at a PC that has a monitor of the required resolution.</li><li>The Cardholder viewer is not designed to be used at resolutions with a height of less than 768, due to the size of the Assign Access pop-up. However, if you are not using a Cardholder viewer to assign access, (e.g. for view only purposes) then any resolution can be used.</li></ul></td></tr><tr><td>Display viewer when a new alarm is raised</td><td>This checkbox only appears on the <strong>Alarm Viewer</strong> configuration pop-up.<br>If selected, when a new alarm occurs the Alarm Viewer will pop to the front.</td></tr><tr><td>Display viewer when a new challenge occurs</td><td>This checkbox only appears on the <strong>Controlled Challenge Viewer</strong> configuration pop-up.<br>If selected, when a new qualifying Challenge event occurs the Controlled Challenge Viewer will pop to the front.</td></tr></tbody></table>

</details>

3. Click the **Close** button.

   The Configuration pop-up closes. No changes will be saved to the database but will be retained and actioned within the confines of the Configuration as follows:

   * Setting/changing the **Name** will change what appears in the **Name** in the Configuration Panel.
   * Changing the **Division** changes the position of the Viewer entry in the Configuration Navigation Panel.
   * Changing the **Dock** setting (of the Viewer Navigation Panel) changes the layout of the Viewer on the Configuration Panel. The Viewer Navigation Panel will be relocated, and the Viewer Panel moved accordingly.

     **Note:** This may mean that the Panel, and its tiles now hang over the edge of the available real estate. It is up to the user to reconfigure the tiles on the Panel.
   * It is recommended that you dock the Navigation Panel either at the top or bottom for a Spot Monitor Viewer.
   * Changing the **Resolution** may change the aspect ratio of the real estate available for configuring the Viewer. This should be obvious to the user on the Configuration Panel, however it will be up to the user to reconfigure the Viewer as required.

     **Note:** For a Spot Monitor Viewer, choose the resolution of the screen on which you intend to use the Viewer. If the correct resolution is not selected the Viewer Panel may display with scroll bars.
   * Resizing Alarm Viewers can be difficult after a number of different panels have been configured. Therefore, it is important to set the size of Alarm Viewers prior to configuring any panels as these will all need to be modified if the size of the Alarm Viewers need to be changed later.

### Next

Configure the Viewer Navigation Panel.

See [Configuring the Viewer Navigation Panel](https://help.security.gallagher.com/knowledge-hub/command-centre-client/configuring-command-centre/viewer-configuration-overall-process/configuring-the-viewer-navigation-panel.md) for the procedure.


---

# 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/viewer-configuration-overall-process/creating-a-new-viewer.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.
