# Filtering

### Overview

Filtering lets you target the right contacts at the right time - making your communications more relevant, more effective, and less likely to reach people they shouldn't.

Across UbiQuity, filtering is available in multiple areas of the platform. Rather than sending to your entire database every time, filters let you define exactly who should receive a communication or be included in a workflow - based on contact data, previous send results, or other interactions your contacts have had with UbiQuity.

***

### Where filtering is available

Filtering appears throughout UbiQuity and works slightly differently depending on the context. The areas where you can apply filters include:

* **Database** - Filter contacts and transactional records directly within your database view
* **Forms** - Apply filters to control which contacts receive a form-triggered email
* **Mailouts & Automated Mailouts** - Restrict email sends to a specific subset of your audience
* **Surveys** - Control who receives a survey-triggered email based on filter criteria
* **Events** - Filter contacts for event-triggered email communications
* **Push notifications** - Apply filters to push-triggered email sends

Each of these areas has its own filtering interface, but the underlying logic is consistent across all of them.

***

### How filtering works

Filters are built from **conditions** - rules based on fields in your contact or transactional data, the results of previous sends, or other interactions your contacts have had with UbiQuity. You can combine multiple conditions using **AND** or **OR** logic:

* **AND** - every condition must be true for a contact to be included. For example, *Country = New Zealand* AND *Segment = Customer* would only include contacts who are both based in New Zealand and tagged as a Customer.
* **OR** - at least one condition must be true for a contact to be included. For example, *Country = New Zealand* OR *Segment = Customer* would include anyone in New Zealand, plus any Customers regardless of location.

Once you've built a filter you want to reuse, you can save it using the **Save Filter** option and apply it again in future.

***

### Managing saved filters

You can manage your saved filters in the **Database** module. 

This allows you to delete, rename or update the content of saved filters within your account, regardless of where in UbiQuity they were initially created.

***

### Where to go next

For guidance on filtering within a specific part of the platform, refer to the relevant section of this documentation:

* Filtering in the Database - *see* [*Database*](/documentation/audience-management/database.md)
* Filtering in Forms - *see* [*Forms*](/documentation/data-capture/forms.md)
* Filtering in Mailouts - *see* [*Email*](/documentation/channels/email.md)
* Filtering in Surveys - *see* [*Surveys*](/documentation/data-capture/surveys.md)
* Filtering in Events - *see* [*Events*](/documentation/data-capture/events.md)
* Filtering in Push Notifications - *see* [*Push*](/documentation/channels/push.md)


---

# 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://docs.ubiquity.co.nz/documentation/basics/filtering.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.