> 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/cardholder-viewer/simple-searching-for-cardholders.md).

# Simple searching for Cardholders

This procedure describes how to perform a "simple search" for Cardholders in the Cardholder Viewer.

1. Click the **Cardholder Viewer** button on the Command Centre toolbar.

   The Cardholder Viewer opens with no Cardholders displayed.
2. Ensure the search mode is set to **Simple Search**.
3. Select what criteria you want to search on from the **By** drop-down list, (i.e. Name, Description, Division, Card Number or All). By default, Name is selected.
4. Start entering characters in the **Search** field.
5. What search criteria did you select?
   * If you selected 'Card Number', go to Step 6.
   * If you selected 'Name', 'Description', 'Division' or 'All', go to Step 7.
6. Enter a number(s) in the **Search** field, and click the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-f1056e058547589bcd63a07bc872a1a741ea174c%2Fsearchbutton.png?alt=media) button.

   The Cardholder Viewer Navigation Panel lists all Cardholders that fit the search criteria.

   *For example:*

   In the following screen, the number '3' was entered in the **Search** field. All Cardholders that have a '3' in their Card Number display in the results, in ascending alphabetical order based on Cardholder's Last Name.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-1cd873059d133f1bc22329551fb75b24c2fdd2d7%2Fcardnumber_search.png?alt=media)
7. Start entering characters in the **Search** field.

   A minimum of 3 characters starts the search.

   *For example:*

   In the following screen, the letters 'don' are entered in the **Search** field. As soon as the third letter was entered, all Cardholders names (both First and Last) that have the letters 'don' in them display in the results, in ascending alphabetical order based on Cardholder's Last Name.

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

   After minimum characters are entered in the **Search** field, results are refined as additional characters are entered.

   *For example:*

   In the following screen, an 'a' was entered after 'don' in the **Search** field and one of the Cardholder names dropped off the results, (i.e. Donna McNabb disappeared from the results as neither her first or last names have 'dona' in them).

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

   **Notes:**

   * Matching is not case sensitive.
   * Inter spaces in search criteria are not ignored.
   * If you want to use an underscore in search terms then you have to either search with the entire string or use a wildcard \* after the underscore.
8. Click on the Cardholder you want to look at.

   The Cardholder Viewer Panel is populated with the Tiles that have been configured for it.

   *For example:*

   In the following screen, the Tiles that display are:

   * Cardholder Details
   * Cardholder Images
   * Cardholder Access Groups
   * Cardholder Expiries
   * Cardholder Cards

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

   **Notes:**

   * Cardholder Tiles can be edited from this Viewer.
   * The **Save** and **Revert to Saved** buttons will only be enabled if there are pending changes.


---

# 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/cardholder-viewer/simple-searching-for-cardholders.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.
