# Filter

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FHskB7CyoHsqIChZCkb1g%2Fimage.png?alt=media&#x26;token=cf41315b-ac3c-4c08-981d-162d655f63c4" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FmfyKr4KUIoqvYUmsgjyb%2Fimage.png?alt=media&#x26;token=11887ade-5216-49f0-89ab-20c565d0738b" alt=""><figcaption></figcaption></figure>

## Description <a href="#description" id="description"></a>

**What it does: Filter** evaluates one or more conditions and lets the workflow continue only if the conditions pass.\
Unlike **Branch**, it does not create multiple paths; it’s a single **gate** in your flow.

Use **Filter** when you need a yes/no checkpoint (e.g., “only proceed for paid users”, “skip if file isn’t PDF”, “run when score ≥ 0.8”).\
Use **Branch** when you need different actions for different outcomes.\
\
Add more rules with **+ And** (all must pass) or group alternatives with **+ Or Group** (any group that passes allows continuation).

## Component settings <a href="#component-settings" id="component-settings"></a>

### Tab "Config"

<table><thead><tr><th width="299.359375">Parameter Name</th><th>Description</th></tr></thead><tbody><tr><td>Only continue if</td><td><p>Build one or more rules. A rule consists of:</p><ul><li><strong>Field</strong>: pick an upstream value via <strong>@</strong> (or select from the dropdown).</li></ul></td></tr><tr><td>Choose condition</td><td><p>Choose an operator<br></p><ul><li>(Text) Contains</li><li>(Text) Does not contain</li><li>(Text) Exactly matches</li><li>(Text) Does not exactly match</li><li>(Text) Is in</li><li>(Text) Is not in</li><li>(Text) Starts with</li><li>(Text) Does not start with</li><li>(Text) Ends with</li><li>(Text) Does not end with</li><li>(File format) Are</li><li>(Number) Equals</li><li>(Number) Greater than</li><li>(Number) Less than</li><li>(Date/time) Equal</li><li>(Date/time) After</li><li>(Date/time) Before</li><li>(Boolean) Is true</li><li>(Boolean) Is false</li><li>Exists</li><li>Does not exists</li><li>Is Null</li><li>Is Not Null</li></ul></td></tr><tr><td>Value</td><td><p>Only available for Text, File format, Number and Date/time.<br></p><p>This allows you to enter a text, a number or a date/time.</p></td></tr></tbody></table>

### Tab "Preview"

Use **Preview** to test your rule set against example inputs from recent runs.

* True → the flow continues to the next node.
* **False** → the run stops at Filter (no error; it is intentionally gated).

## Advanced configurations <a href="#advanced-configurations" id="advanced-configurations"></a>

This component has no advanced configurations.

## Use case

Filter - Allow flow run if "Field" contains value = 2

* Only continue if = @ trigger.field
* Condition = (Text) Contains
* Value = 2

Set up at the "Filter" node

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FsUSuKgYhYZNAj7hDf2VT%2Fimage.png?alt=media&#x26;token=58174527-25cb-425b-8f67-2d29176cb845" alt=""><figcaption></figcaption></figure>

The result:

* (1) When Field = 3 -> false

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FXTSaf3s4WBJy82ydWyNf%2Fimage.png?alt=media&#x26;token=0252141a-9b42-431b-ac0f-a46dbb09b37d" alt=""><figcaption></figcaption></figure>

* (2) When Field = 2 -> True

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FTdkB3VQ9vwrVVcPE7dPs%2Fimage.png?alt=media&#x26;token=399f4647-de78-4e52-b340-c749aa7da98c" alt=""><figcaption></figcaption></figure>

<br>
