> 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/configuration-client/site-monitoring/find-tool.md).

# Find Tool

### Introduction

Using the Find tool, you can locate items within Command Centre. Each of the tabs make it easier to fully define your search criteria.

**Note:** An extra **Alarm Transmission** tab will also be available if your site is licensed for the ContactID feature.

The Find function defines the search as per the settings within each of the tabs. The search results will only include items which meet all the conditions set across all the tabs.

When you have defined your search criteria, ensure any tabs you do not want to use are "blank" - that is, they do not contain previous search criteria data.

**Note:** Pressing **F3** on your keyboard brings up a new **Find** tool window, except if an Alarm Details window is open.

### Procedure

#### Using the Find Tool

1. Click **Monitor** from the menu bar, then **Find...**

   The **Find** tool opens.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-d43b071570c3e82ee03ada4e0c0cf560cbb1c932%2Fpartfour.png?alt=media)
2. Enter text in the **Name** and/or **Description** fields to help define your search criteria, if required.

   **Note:** Partial text and wildcards (%) can be used. See **Hints** at the end of this topic for further detail.
3. Click within the **Look in** field.

   From the displayed drop-down menu, click which **area to search** within Command Centre.

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

   **Note:** When searching for Controllers, you can opt to search either by the different Controller types, or for all Controllers at once.
4. Check the **Include deleted items** checkbox if you want to include these in your search.

   **Note:** When this option is checked, you can then search by 'Name' or 'Description' (on the **General** tab), or by 'Created', 'Modified' or 'Deleted' time (on the **Times** tab).
5. Select the appropriate Tabs and **define your search criteria**.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-70c8490a29a52b4500a8e3b4d754248b0ae327a3%2Ffindtabs.png?alt=media)
6. See [Examples](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-monitoring/find-tool/examples.md), using these tabs, to show how you can define your searches.
7. Click the **Start search** button.

### Result

Search list window opens and lists all items found.

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

### Hints

{% hint style="info" %}
**Stop search**

If you click on the **Stop Search** button, those items already found remain in the displayed list. To restart the search from the beginning click the **Start Search** button.
{% endhint %}

{% hint style="info" %}
**Partial text**

The Command Centre system will automatically search on partial text entered in the **Name** and **Description** fields. The search will find matches which contain partial text searched on.

For example, if you enter Will in the **Name** field, the search results will include any "Williams" or "Willis" in the system.
{% endhint %}

{% hint style="info" %}
**Wildcards (%)**

The percentage symbol (%) can be used as a wildcard in the **Name** and **Description** fields.

For example, if you enter partial text and include a % as a wildcard, so you have **co%er** in the **Name** field, the search results will include items with the word "controller" or "computer" in their name.

**Note:**

If you want to search for the actual symbol %, you need to enclose it in square brackets \[%].
{% endhint %}

{% hint style="info" %}
**Case sensitive**

The find search is not case sensitive. You can enter either lower-case or upper-case characters.
{% endhint %}

{% hint style="info" %}
**Properties of search list items**

You can go straight to the Properties window of any item in the list of Search results by right clicking on an item, then selecting Properties.
{% endhint %}


---

# 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/configuration-client/site-monitoring/find-tool.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.
