> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeotap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ingestion Filter Criteria

The **Ingestion Filter** feature allows you to control which records from a source file or stream are to be ingested into the Zeotap platform. During source mapping review, you can define filter conditions on the mapped source fields, ensuring that **only records meeting the defined criteria** are processed further. If a record does not satisfy the defined filter condition for any mapped source field, the **entire record row will be rejected** from ingestion.

This feature provides precise control over incoming data, helping reduce unnecessary ingestion, optimize event consumption, and improve overall data quality.

### Defining Ingestion Criteria

To define a filter, click **Define Ingestion Criteria** in the review screen while mapping your source. Then, click **Add Filter** to view all available source fields of primitive data types (string, double, integer) in the dropdown.

<Frame>
  <img src="https://mintcdn.com/zeotap/8JL3J3GLnO5rMtb7/articles/unify-customer/Storage/unify-customer/ingestion-filter/ingestion-filter-2025-10-29.png?fit=max&auto=format&n=8JL3J3GLnO5rMtb7&q=85&s=769429877c24342849e66f845e17c47c" alt="" width="3182" height="592" data-path="articles/unify-customer/Storage/unify-customer/ingestion-filter/ingestion-filter-2025-10-29.png" />
</Frame>

Select the desired field, choose the appropriate operator, enter the value, and save the filter. This will define the condition for ingestion, allowing only those records that match the applied filter to be ingested. The filter operates on **source fields**, not on catalogue fields.

You can define up to **five conditions per source**. The system allows filters to be created only on **source fields mapped to a catalogue**.

<Frame>
  <img src="https://mintcdn.com/zeotap/8JL3J3GLnO5rMtb7/articles/unify-customer/Storage/unify-customer/ingestion-filter/ingestion-filter-2025-10-29-2.png?fit=max&auto=format&n=8JL3J3GLnO5rMtb7&q=85&s=3d18fa46734f5ceeff77c8e4f643aacf" alt="" width="1872" height="1022" data-path="articles/unify-customer/Storage/unify-customer/ingestion-filter/ingestion-filter-2025-10-29-2.png" />
</Frame>

When editing an existing ingestion filter, note that any changes will take up to **10 minutes** to start affecting incoming records after the mapping is saved.

<Note>
  **Note:**

  The available operators depend on the catalogue category selection:
  <ul><li>ID fields - exists / not exists</li><li> All other fields - equals / not equals / in / not in / exists / not exists / contains / not contains </li></ul>
</Note>

You can view the applied ingestion filter criteria in the **Catalogue Mapping Preview** by clicking the **View Ingestion Criteria** button.

<Frame>
  <img src="https://mintcdn.com/zeotap/8JL3J3GLnO5rMtb7/articles/unify-customer/Storage/unify-customer/ingestion-filter/ingestion-filter-2025-10-29-3.png?fit=max&auto=format&n=8JL3J3GLnO5rMtb7&q=85&s=36a772cadad9cc9397da99ce24cacfad" alt="" width="3198" height="716" data-path="articles/unify-customer/Storage/unify-customer/ingestion-filter/ingestion-filter-2025-10-29-3.png" />
</Frame>

The number of records rejected due to the applied filter can be viewed in the **Ingestion Log** under the **Source Report** section of the source.

<Frame>
  <img src="https://mintcdn.com/zeotap/8JL3J3GLnO5rMtb7/articles/unify-customer/Storage/unify-customer/ingestion-filter/ingestion-filter-2025-10-29-4.png?fit=max&auto=format&n=8JL3J3GLnO5rMtb7&q=85&s=0bcf5e45bdfd78aa63c6f9a39b996689" alt="" width="1226" height="1274" data-path="articles/unify-customer/Storage/unify-customer/ingestion-filter/ingestion-filter-2025-10-29-4.png" />
</Frame>
