> 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/using-command-centre/working-with-viewers/tile-actions/cardholder-images-tile-actions.md).

# Cardholder Images Tile actions

The Cardholder Images tile is available on all Viewer types, and displays one or more image PDFs stored against a Cardholder. It only displays the image PDFs that have been configured for the tile AND the Cardholder belongs to an *Access Group\** that includes that PDF.

{% hint style="info" %}
**\*Access Group**

A group of cardholders with identical access criteria. An Access Group also has privileges other than access, including the ability to escort visitors and to do manual overrides.
{% endhint %}

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

By hovering over the Cardholder Images tile a number of options become available allowing you to capture an image from a webcam, providing there is a webcam attached to your workstation, and you have the privilege to edit the PDF.

### Operator Privileges

<table><thead><tr><th width="182">To...</th><th>you need...</th></tr></thead><tbody><tr><td><strong>view</strong> a Cardholder's images,</td><td><p>one of the following privileges in the division of the cardholder:</p><ul><li>"View Cardholders"</li><li>"Edit Cardholders"</li><li>"View Cardholder Notes"</li><li>"Edit Cardholder Notes"</li><li>"Edit Cardholder Notification"</li><li>"Print/Preview &#x26; Encode Card"</li><li>"Delete Cardholders"</li></ul></td></tr><tr><td><strong>edit</strong> a Cardholder's images,</td><td>the "Edit Cardholders" privilege in the division of the cardholder AND the privilege to "Edit" the PDF in the same division.<br><br><strong>Note:</strong> If you have the "Advanced User" privilege in the division of the cardholder you do not need the "Edit" privilege for the PDF.</td></tr></tbody></table>

Whether a PDF displays on the tile depends on:

* the configuration of the tile,
* the Access Groups assigned to the Cardholder
* the user's privileges.

  The user needs "View Cardholders", "Edit Cardholders", "View Cardholder Notes", "Edit Cardholder Notes" OR "Print/Preview & Encode Card" privilege in the division of the cardholder AND the privilege to "View" or "Edit" the PDF in the same division.

  **Note:** If the user has the "Advanced User" privilege in the division of the cardholder you do not need the "View" or "Edit" privilege for the PDF.

### Tile Actions

<details>

<summary>Capturing an image</summary>

1. Hover over the Cardholder Images Tile, and click on the **Capture Image** ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-5eded8871d29c746922cb4c4f4e6f12e932c504e%2Fcaptureimage_button.png?alt=media) button.

   (Alternatively, press < **Ctrl** + **I** > on your keyboard.)

   The Image Capture window displays, showing whatever is picked up by the webcam.
2. Crop the image if necessary, as follows:
   1. Select the area of the image to be retained by clicking on the image.
   2. Drag out the corner of the drawing tool to create a border, either as a square or rectangle, around the part of the image to be kept.

      **Note:** The maximum area that can be selected is determined by the PDF definition.
3. Click the **Capture** button.

   The Image Capture window closes and the image visible in the display field prior to the window being closed is displayed on the Cardholder Images Tile.

   **Notes:**

   * If you click the **Cancel** button the Image Capture window closes with no changes to the content of the Cardholder Images Tile.
   * If the area selected is smaller than the PDF image definition, the 'retained image' is zoomed to fill the space available as specified in the definition.
   * The frame rate from a laptop's camera may be very slow. If you experience this issue, you can resolve it by updating the webcam driver.
4. Click the **Save** button.

</details>

<details>

<summary>Uploading an image</summary>

1. Hover over the Cardholder Images Tile, and click on the **Upload Image** ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-54a9aec527428981cd8112649211cebb914fc942%2Fuploadimage_button.png?alt=media) button.

   (Alternatively, press < **Ctrl** + **U** > on your keyboard.)

   The standard window for selecting a file from the PC or network displays, with the folder from which the last image was uploaded open by default.
2. Select the required file.

   **Note:** The system will check that the file chosen is a valid image.
3. Click the **Open** button.

   The Crop Image pop-up displays showing the content of the selected file, in preparation for cropping, if necessary.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-a907e4ff7c15b1f00307082a1e65da37b6225dd7%2Fcropimagepopup.png?alt=media)
4. Crop the image as necessary, and click the **OK** button.

   The image now displays on the Cardholder Images Tile.

   **Note:** If you decide to cancel this change, the **Revert to Saved** button allows you to do so before saving it.
5. Click the **Save** button.

</details>

<details>

<summary>Copy and Pasting an image</summary>

1. Hover over the Cardholder Images Tile, and click on the **Copy Image** ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-a925cc215a35b8592bdd2c5d364a8021dea2bf44%2Fcopyimage_button.png?alt=media) button.

   (Alternatively, press < **Ctrl** + **C** > on your keyboard.)
2. Paste the image either:

   * into an external application, using < **Ctrl** + **V** >, OR
   * directly onto another Cardholder Images Tile from the clipboard by clicking on the **Paste Image** ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-d691889068f9cca677664d735b6afebd452bd1bb%2Fpasteimage_button.png?alt=media) button or using < **Ctrl** + **V** >.

   The Crop Image pop-up displays showing the content of the selected file, in preparation for cropping, if necessary.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-a907e4ff7c15b1f00307082a1e65da37b6225dd7%2Fcropimagepopup.png?alt=media)
3. Crop the image as necessary, and click the **OK** button.

   The image now displays on the Cardholder Images Tile.

   **Note:** If you decide to cancel this change, the **Revert to Saved** button allows you to do so before saving it.
4. Click the **Save** button.

</details>

**Note:** Copy is only available if there is already an image on the particular Cardholder Images tile you are focused on.

<details>

<summary>Deleting an image</summary>

1. Hover over the Cardholder Images Tile, and click on the **Delete Image** ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-e3c31b2d667c9e9e0f75189faeda6cd13858b73c%2Fdeleteimage_button.png?alt=media) button.

   (Alternatively, press < **Del** > on your keyboard.)

   The message *"Are you sure you want to delete this image?"* displays.
2. Click the **Yes** button.

   The image disappears from the Cardholder Images Tile.

   **Note:** If you decide to cancel this change, the **Revert to Saved** button allows you to do so before saving it.
3. Click the **Save** button.

</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/using-command-centre/working-with-viewers/tile-actions/cardholder-images-tile-actions.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.
