# Event Definition Filters

Event definition filters give you a way to narrow down your event definitions. You can limit event definitions to a specific page, a specific domain, or a number of other options.

<div data-with-frame="true"><figure><img src="/files/4umbSjOi4bcvk64tfltG" alt=""><figcaption></figcaption></figure></div>

## Supported Properties

Freshpaint allows you to create filters on the following properties:

| Property      | Description                                                                                             |
| ------------- | ------------------------------------------------------------------------------------------------------- |
| Browser       | The name of the browser the event occurred in.                                                          |
| Device ID     | The ID of the device that generated the event.                                                          |
| Domain        | The domain the event occurred on.                                                                       |
| Full URL      | The full URL of the event, including the domain name.                                                   |
| Href          | For events that are clicks on links, the URL to where the link goes.                                    |
| IP            | The IP address that triggered the event.                                                                |
| Page Title    | The value of the `<title>` element tag located in the `<head>` section that defines a web page's title. |
| Path          | The portion of the URL that comes after the domain for where the event occurred.                        |
| Referrer      | The page URL where a user clicked a link that sent them to the current page.                            |
| Screen Height | The total number of vertical pixels forming a display.                                                  |
| Screen Width  | The total number of horizontal pixels forming a display.                                                |
| Target Text   | For events that are clicks, the text of the element that was clicked on.                                |
| User ID       | The user\_id if `identify()` has previously been called for this user.                                  |
| UTM Campaign  | The associated value of the `utm_campaign` parameter in the page url.                                   |
| UTM Content   | The associated value of the `utm_content` parameter in the page url.                                    |
| UTM Medium    | The associated value of the `utm_medium` parameter in the page url.                                     |
| UTM Source    | The associated value of the `utm_source` parameter in the page url.                                     |
| UTM Term      | The associated value of the `utm_term` parameter in the page url.                                       |

## Supported Filters

Freshpaint allows you to filter the above properties with the following filters:

| Filter           | Description                                                                                                                                                                                                                                                                            |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Contains         | Contains checks that the property value contain the given string of characters. As an example, the value `freshpaint` contains the string `paint`.                                                                                                                                     |
| Does not contain | Allows you to search for property values that do not contain the given string of characters.                                                                                                                                                                                           |
| Matches          | Matches allows you to use `*` to match any string of characters. This allows you to match certain URL patterns. As an example, the URL pattern `/docs/*/page/*` will match both the property values `/docs/directory1/page/abc` and `/docs/directory2/page/123`.                       |
| Does not match   | Allows you to search for values that do not match any string of characters.                                                                                                                                                                                                            |
| Equals           | Equals checks that the property value is the same as the provided string.                                                                                                                                                                                                              |
| Does not equal   | Checks that the property value is not the same as the provided string.                                                                                                                                                                                                                 |
| Any of           | <p>This will match on any of the values selected for a given property, granting the ability to do some simple OR logic within a given property.<br><br>This matches with the same wildcard <code>\*</code> matching logic as the <code>Matches</code> type Filter described above.</p> |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.freshpaint.io/admin-panel/events/event-definition-filters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
