> 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/generic-administration-tasks/searching-for-items.md).

# Searching for items

There are a number of ways an Operator can search for a site item, as follows:

1. From the Viewer Navigation Panel, select what criteria you want to search on from the **By** drop-down list.

   **Note:** The options available vary depending on the item type.
2. Click on an option below for a description how to use the search criteria.

#### Search options common to more than one item type

<details>

<summary>Search by Name</summary>

Start entering characters in the **Name** field.

Automatic searching starts when a minimum of 3 characters are entered, and subsequent characters entered refine the results.

*Wildcards*

The following wildcard characters can be used when searching:

* The percentage symbol ( **%** ) and asterisk ( **\*** ) represent any number of characters.
* The underscore ( **\_** ) represents a single character of any value.
* Search can be done using a combination and number of **\***, **%** and **\_**.

</details>

<details>

<summary>Search by Division</summary>

A 'Select a Division' browse tool displays.

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

1. Click the radio button next to the Division you want to search by.
2. Click the **OK** button.

   The browse tool closes and the **Select a Division** button changes to the name of the Division you selected.

</details>

<details>

<summary>Search by Description</summary>

Start entering characters in the **Description** field.

Automatic searching starts when the first character is entered, and subsequent characters entered refine the results.

</details>

<details>

<summary>Search by Related Item</summary>

A 'Select an Item' browse tool displays.

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

1. Search for the Scheduled item you want to use for searching by entering search criteria in the **Search** field and/or refining the filters.

   The grid becomes populated with items that match the search criteria.
2. Click on the radio button next to the item name you want to use.
3. Click the **OK** button.

   The browse tool closes and the **Select an Item** button changes to the name of the item you selected.

</details>

#### Access Groups only

<details>

<summary>Search by Door</summary>

A 'Select a Door' browse tool displays.

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

1. Click on the radio button next to the Door you want to search by.
2. Click the **OK** button.

   The browse tool closes and the **Select a Door** button changes to the name of the Door you selected.

</details>

<details>

<summary>Search by Access Zone</summary>

A 'Select an Access Zone' browse tool displays.

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

1. Click on the radio button next to the Access Zone you want to search by.
2. Click the **OK** button.

   The browse tool closes and the **Select an Access Zone** button changes to the name of the Access Zone you selected.

</details>

#### Macros only

<details>

<summary>Search by Macro Action Item</summary>

A 'Select an Item' browse tool displays.

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

1. Search for the Macro Action item you want to use for searching by entering search criteria in the **Search** field and/or refining the filters.

   The grid becomes populated with items that match the search criteria.
2. Click on the radio button next to the item name you want to use.
3. Click the **OK** button.

   The browse tool closes and the **Select an Item** button changes to the name of the item you selected.

</details>

#### Operator Groups only

<details>

<summary>Search by Viewer</summary>

A 'Select a Viewer' browse tool displays.

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

1. Click on the radio button next to the Viewer you want to search by.
2. Click the **OK** button.

   The browse tool closes and the **Select a Viewer** button changes to the name of the Viewer you selected.

</details>

<details>

<summary>Search by Report</summary>

A 'Select a Report' browse tool displays.

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

1. Click on the radio button next to the Report you want to search by.
2. Click the **OK** button.

   The browse tool closes and the **Select a Report** button changes to the name of the Report you selected.

</details>

#### Schedules only

<details>

<summary>Search by Schedule Type</summary>

A **Schedule Type** drop-down box displays.

Select the Schedule Type you want to search by.

</details>

<details>

<summary>Search by Scheduled Item</summary>

A 'Select an Item' browse tool displays.

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

1. Search for the Scheduled item(s) you want, by entering search criteria in the **Search** field and/or refining the filters.

   The grid becomes populated with items that match the search criteria.
2. Tick the checkbox next to the item name(s) you want to use, or click the **Select All** button if you want to include all the items displayed.
3. Click the **Apply Filter** button.

   The browse tool closes and the Viewer Navigation Panel is populated with a list of Schedules that fit the search criteria.

</details>

<details>

<summary>Search by Day Category</summary>

A 'Select a Day Category' browse tool displays.

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

1. If you want to refine the results, enter search criteria in the **Search** field.
2. Tick the checkbox next to the Day Category(s) you want to use, or click the **Select All** button if you want to include all the Day Categories displayed.
3. Click the **Apply Filter** button.

   The browse tool closes and the Viewer Navigation Panel is populated with a list of Schedules that fit the search criteria.

</details>

#### Bulk Changes

<details>

<summary>Search by Bulk Change Type</summary>

A **Bulk Change Type** drop-down box displays.

Select the Bulk Change Type you want to search by.

</details>

The Viewer Navigation Panel is populated with a list of items that fit the search criteria.

3. Click on the item you want to look at.

   The Viewer Panel is populated with the relevant related details, allowing you to directly edit the data or copy/delete the item.


---

# 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/generic-administration-tasks/searching-for-items.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.
