> 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/configuring-tiles/configuring-individual-tile-types/configuring-a-cardholder-images-tile.md).

# Configuring a Cardholder Images Tile

This tile can display one or more "Image" type PDFs stored against a Cardholder. It can be configured to show details for:

1. the Cardholder selected from the Cardholder List (on a Cardholder Viewer), OR
2. the Cardholder who last badged or presented their finger at a Door (for *Challenge\**), OR
3. the Cardholder related to an Event.

{% hint style="info" %}
**\*Challenge**

The Challenge feature allows a Command Centre operator to contest Cardholders as they attempt to gain access through a Door, and either grant or deny access.
{% endhint %}

### How to configure

1. Double-click on **Cardholder Images** on the 'Tile Toolbox'.

   The Cardholder Images Tile appears on the Configuration Panel section of the screen in preview mode, with a light border representing the outline(s) of where the "Image" type PDF(s) will display. This allows you to size the tile correctly.

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

   **Note:** The number of outline images that display depends on the number of "Image" type PDFs that are configured in Configuration Client.
2. Move the mouse over the Cardholder Images Tile you have added, and click on the **Click to configure** button that appears.

   The Cardholder Images Configuration pop-up displays.

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

   **Note:** If you are adding this tile to a Monitor Site Viewer there will be an additional **Source** section at the bottom for selecting a door.
3. Enter an appropriate **Title** for this Tile.
4. Uncheck the **Show Tile Header** checkbox if you want the tile header to be removed in operational mode.

   **Note:** While this feature maximised the available screen real estate, be aware that Tile maximise/minimise can only be achieved using hot keys < **Ctrl** + **M** >.
5. In the **Fields** section, click the appropriate radio button for what PDFs you want to include, (i.e. either **All PDFs** or **Selected PDFs** ).

   Did you select **Selected PDFs**?

   <table><thead><tr><th width="66">If...</th><th>then...</th></tr></thead><tbody><tr><td>no</td><td>go to Step 6.</td></tr><tr><td>yes</td><td>a list displays of all the "Image" type PDFs that exist. Select those PDF(s) you want to include by clicking in the checkbox next to the PDF.</td></tr></tbody></table>
6. Are you adding this Tile to a Monitor Site Viewer?

   <table><thead><tr><th width="66">If...</th><th>then...</th></tr></thead><tbody><tr><td>no</td><td>go to Step 7.</td></tr><tr><td>yes</td><td><p>you must select a door for the <strong>Last Cardholder at Door</strong> field. The Cardholder who most recently badged a credential at this Door’s entry reader will have their image(s) displayed in the tile.<br>To do this:</p><ol><li>Click the <strong>Select Door</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-6fb121fe5bddc9238dd2b1ceb325ec21bfb474bb%2Fselectdoorpopup.png?alt=media" alt=""><br><br><strong>Note:</strong> Local and remote doors are displayed.</li><li>Check the door you want to use.</li><li>Click the <strong>OK</strong> button.<br>The pop-up closes and the <strong>Select Door</strong> button changes to the name of the door you selected.</li></ol></td></tr></tbody></table>
7. Click the **Close** button.

   The preview mode of the Cardholder Images Tile now displays the title given, and outline images for the number of "Image" type PDFs you selected.


---

# 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/configuring-tiles/configuring-individual-tile-types/configuring-a-cardholder-images-tile.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.
