> For the complete documentation index, see [llms.txt](https://documentation.freshpaint.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.freshpaint.io/admin-panel/events/event-definition-filters.md).

# 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> |
