> For the complete documentation index, see [llms.txt](https://help.solink.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.solink.com/docs/understand-your-business/search-and-save-reports/search-and-filter-events.md).

# Search and Filter Events

Use the search bar to create custom reports.

The **search bar** on the **Events** page allows you to find content within your events and/or filter your events based on search keywords and filters:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-50163ba22eabbf23618395d255ca5443a5da6db9%2F9ed109cffb23b5ed.jpg?alt=media" alt="" width="560">

To start a search:

1. Type something into the search bar;
2. Select "contains" from the dropdown list to search for events that contain the word you typed in; or select "does not contain" to filter out events that contain the word you typed.

You can repeat this process to filter your search with multiple keywords:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-6510f4729afede724b85e8ef8969f3f417de346a%2F253070ee83f3a17e.jpg?alt=media" alt="" width="560">

***

## Add Filter

Select the **Add Filter** button to refine your search using a list of predefined filters:

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-9866bdaa029dd2b59bbd17abdfc7ffcc96400c87%2F1acbc2a6fd358983.jpg?alt=media)

You can sort through the available filter categories using the dropdown menu:

​

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-995d56100b9d06a4a1591045f8856a08e59ae494%2Fd8fb2fcb209c646b.jpg?alt=media)

There are currently three types of filter categories you can choose from:

* Filters that require you to define a value (represented by the **#** icon):

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-da2dc6c54e312fbcbd88e364040dbf4197e66f9d%2F4aab44159151860d.jpg?alt=media)

* Filters with predefined values (represented by the **ab** icon):

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-e8874c2b8bb2fde16c8007457f6eba9d1e5a2f36%2Facf4cbaaf78238cc.jpg?alt=media)

* Date-specific filters associated with a **calendar icon**. See [Search by Date and Time](/docs/release-notes/share-only/how-to-use-search-on-the-events-page.md) for more information on these filters.

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-769c41076a27ee6662f52653f6652399b08edafe%2F83b2d46cd1a15295.jpg?alt=media)

### Update Existing Filters

You can always make adjustments to the filters in your current search. To do so:

1. Select the filter you want to update.
2. Make any changes to the filter (select new options, change the value, etc).
3. Select **Update** to apply the changes.

The GIF below provides an example of how to update a filter:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-e63136b520f4f8326cd3178be42db5f320fcc935%2F26f4a85a1f078806.gif?alt=media" alt="" width="560">

You can also select **Clear All** to clear all of your current filters and reset your search:

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-e854caa20cfda276184be61b2cca5d2f7e137ded%2F44bba2b47456a86b.jpg?alt=media)

See the sections below for more specific ways you can use the search bar on the Events page to find what you're looking for.

## Search by POS

If you are looking for transactions from a particular POS system, look at the bottom of your receipts to identify the POS name.

For example, you can type "DTP" in the search bar, then select "contains DTP" from the dropdown list to find transactions from a drive thru POS because that is what the POS is named in the Solink system:

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-fb83581db03377d901fa59f09b258ede53e32bad%2F04818b37108cab96.jpg?alt=media)

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

## Search by Transaction Amount

Use the **Total Amount** filter to search for specific dollar amounts within your transactions:

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-a5e6590201035ec506d967e25ba95bc71c4139fe%2F7aa25582c59fd4d1.jpg?alt=media)

For example, you could select the **Total Amount** filter, then select "is less than" and type "5" to filter all of your transactions with a total amount less than $5 dollars.

Or, select "is equal to" and then type "0" to search for transactions that resulted in $0 dollars (this is helpful if you want to see if employees are discounting transactions to give away or take free items).

## Search by Payment Method

If you are looking for transactions with a specific method of payment, search using the exact terms of the payment type.

For example, type **Paid Cash** in the search bar, then select "contains Paid Cash" from the dropdown list to find transactions where the customer paid in cash:

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-0f1f08b05ca08a31b39a90fe0938c2320eacd7f5%2Ff8d8016227680ea0.jpg?alt=media)

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

## Search by Date and Time

To filter your events based on date and time:

1. Select the **Add Filter** button on the Events page.
2. Select the **Date and Time** category:

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-af85eed3d9edd84d8faaa8bac918ef5c5bc028cb%2Fe3502856b3215a53.jpg?alt=media)

You can then select from a number of filters within the **Date and Time** category.

There are two types of date and time filters:

* **Date-specific filters**: A date-specific filter allows you to **search for events within or on a specific day/series of days**. These filters are represented by a calendar icon.
* **Hashtag Filters**: This type of filter allows you to **search for events within a period of time across all days**. These filters are represented by the **#** icon.

See the following sections for an overview of how to use **date-specific** and **hashtag filters**.

#### Date-Specific Filters

A Date and Time filter with a calendar icon allows you to do the following:

* Search for events that started, ended etc. **between** two periods of time on a certain day or series of days;
* Search for events that started, ended etc. **on** a certain day.

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-ff4972415bce78d0933f0d6f5f3f19d1910156cb%2Fa986574f758da1be.gif?alt=media" alt="" width="560">

Date-specific filters include:

* ![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-6256f8fd80a989eb6de9c86aeeea5309310762f7%2F46a0323331e1e285.jpg?alt=media)
* ![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-cfbd971c085cd5e35ba5d82e8ad13ca5e7a24e05%2F09adee2ff141c3eb.jpg?alt=media)

Select the **Start Time** or **End Time** filters to search for events:

* with a start time/end time on a specific day;
* with a start time/end time that falls within a select period of time on a specific day.

To search for events with a start time/end time on a specific day:

1. Select the **on** option:

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-a4462e17f4b20f4b1fd683a72696905ff684251b%2F899adf31db574bc4.jpg?alt=media)

2. Select a day from the calendar widget.
3. Select **Add** to filter events based on the selected day.

To search for events that began/ended within a specified period of time on a specific day:

1. Select the **between** option:

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-a5011e08120ff85592bee8b0393e96c112c42369%2F3031c9a988cb1bf7.jpg?alt=media)

2. Select a start date with the calendar widget:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-c8153de10db6e444a3cc3246c9cf762cfce8a21f%2F8b912e95de7c9d71.gif?alt=media" alt="" width="560">

3. Select either the same day, or another day after the one you selected in step 2:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-4013b83b9ab7585818db0925b66588d9de44f371%2F8640ebe4684f6c9a.gif?alt=media" alt="" width="560">

4. Select a time for each of the selected days.
5. Select **Add** to filter events that began/ended between the selected days and times.

#### Hashtag # Date and Time Filters

You can use # hashtag filters to search for **all events** within a specific time period. For example, you could choose to only display events created between 9 A.M. and 1:00 P.M. if you wish.

To display events only created within a specified period of time:

1. Ensure you are searching on the selected date you wish to display events from. Use the calendar widget/date picker to the top-right of the page to select a specific day.
2. Select the **Add Filter** button next to the search bar. Type in or navigate to and select **# Start Time (HHMM)**:

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-c40656948d8821faebfcf0edaece370a3a58c4f8%2F5df51eaf975ac514.jpg?alt=media)

3. Select "is greater than" to indicate that events will be greater than the start time you input.
4. Type the time you would like using the 24 hour format. For example, if you want to display events between the hours of 9 A.M. and 1:00 P.M., type "0900" for the **Start Time** field.
5. Select **Add** (or Enter on your keyboard) to confirm the start time.
6. Repeat steps 2-4, (use a **# Start Time (HHMM)** filter) but select the "is less than" option instead. Enter the desired time using the 24 hour format (in this example, the user would like to search for all events created up until 1 PM, so they would type in "1300").
7. Scroll through the events on the page to see only events generated between the start and end times you specified in the search.

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-45516a17bb8c2fc9fac6aee730d106cc26d55568%2F323e392a1aae1894.jpg?alt=media" alt="" width="560">

## Search by Line Items and Keywords

You can use the search feature to track sales of a specific receipt item. In the following example, the user is tracking sales of Dark Roast coffees simply by typing the item name into the search bar:

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-713cc8ef617ca0d2987fd008db58c233df515c48%2F09ad56114464d1bb.png?alt=media)

## Special Search Keywords (AND/OR Filters)

You can expand your event search with each additional search term. For example, **type one search term** into the search bar **and then search for an additional term** separately:

* An "**AND"** filter displays between each separate search term. The "**AND**" filter highlights specific areas in all receipts, titles, subtitles and notes **that contain both of those search terms**. For example, search for "contains milk" and then search for "contains bagels" to show only receipts containing both of these terms:

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-37700565e09639f3a151f064f5ad93bbcec1072e%2Fa93b0bc31f9a5740.png?alt=media)

* Select the "**AND**" filter to switch to an "**OR**" filter. The "**OR**" filter highlights specific areas in all receipts, titles, subtitles and notes **that contain at least one of those search terms**. For example, "**milk" OR "bagels"** will show only receipts containing at least one of these terms:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-7ea6db803f91d6e63d66c7fc4170a08e8038289d%2F36cb5f050643dbb1.gif?alt=media" alt="" width="560">

## Save Your Searches (Create a Report)

You can save your searches for later without having to type terms into the search bar again. A saved search is referred to as a **Report**.

See [Create a Report](/docs/understand-your-business/search-and-save-reports/create-a-report.md) to learn more.

​


---

# 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.solink.com/docs/understand-your-business/search-and-save-reports/search-and-filter-events.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.
