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

# Filters

> Filter out events in your Destinations

export const OutboundLink = ({linkText, linkTarget}) => {
  return <a target="_blank" href={linkTarget}> {linkText} 
    <div className="inline h-3 w-3 fill-gray-500 dark:fill-gray-100 text-gray-500 dark:text-gray-300 ml-1 mr-1">
      <svg className="inline w-2.5 h-2.5 bg-gray-500 dark:bg-gray-300" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/up-right-from-square.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }}></svg> 
    </div>
    </a>;
};

## Overview

Converge allows you to filter out events based on **Event Properties**, **Profile Properties** or by their **Source**.

* [Property filters](#event-and-profile-property-filters)
* [Source filters](#source-filters)

***

## Property filters

Converge allows you to filter out events granularly based on their event properties and profile properties according to the [Converge event spec](/sources/converge-spec).

<Note>
  A Converge property filter only forwards events if a condition is **True**. As such, a destination with the following filter only forwards `Placed Order` events if the property is not equal to `subscription_contract`.

  <Frame>
    <img src="https://mintcdn.com/converge/dh0K_Fgr0_qazJsh/images/destinations/filters/filters-2.png?fit=max&auto=format&n=dh0K_Fgr0_qazJsh&q=85&s=d88a8bad867021343a08d537dc461f98" alt="subscription filters" width="1075" height="232" data-path="images/destinations/filters/filters-2.png" />
  </Frame>
</Note>

<Warning>
  Property filters are currently only supported for server-side forwarded events.
  Client-side forwarded events will **not** be filtered out.
</Warning>

<Warning>
  Property filters apply to both event properties and profile properties. If the same property name exists in the event and profile properties, the filter will check both.
</Warning>

### How to set up a property filter

1. Navigate to the [Destinations Tab](https://app.runconverge.com/-/connections) in your Converge dashboard
2. Click on the Destination for which you want to filter out certain events.
3. Click on the **Configuration** tab and on the **Filters**-subtab to open the Filter Configuration
4. Click on **Edit configuration** to add a Filter.
5. Click on **Add condition** and choose the Event for which you want to set up a filtering rule.
6. Click on **Select Property** and choose the property on which you want to filter.
7. Once you are happy with your rule, click **Save**.
   <Frame>
     <img src="https://mintcdn.com/converge/dh0K_Fgr0_qazJsh/images/destinations/filters/filters-0.png?fit=max&auto=format&n=dh0K_Fgr0_qazJsh&q=85&s=cbdcbfe17c2527a00550f097d947c49d" alt="pick filters" width="1007" height="615" data-path="images/destinations/filters/filters-0.png" />
   </Frame>

### Examples

#### Filtering out subscription orders from a Destination

Subscription brands typically want to filter out recurring purchases when forwarding to ad platforms. To achieve this, you can set up a Filter on the `Placed Order` event on a per-destination basis.

<Steps>
  <Step title="Find a property and property value that defines a recurring subscription order">
    1. Navigate to the <OutboundLink linkText="Source Log" linkTarget="/sources/monitoring#source-logs" /> and filter on the `Placed Order` event.

    2. Check a few `Placed Order` events by clicking on them to see all of their properties, **find a property and property value that uniquely define a subscription purchase**.

           <Note>
             If you are using the [Shopify Server Integration](/sources/server-integrations/shopify.mdx) in a standard setup, then the following property and property value pair defines a recurring purchase:

             `source_name` → `subscription_contract`
           </Note>
  </Step>

  <Step title="Set up your filter accordingly">
    3. Set up a filter for the `Placed Order` event as follows. Replace the property and property value with the ones you identified in *Step 2*.
           <Frame>
             <img src="https://mintcdn.com/converge/dh0K_Fgr0_qazJsh/images/destinations/filters/filters-2.png?fit=max&auto=format&n=dh0K_Fgr0_qazJsh&q=85&s=d88a8bad867021343a08d537dc461f98" alt="subscription filters" width="1075" height="232" data-path="images/destinations/filters/filters-2.png" />
           </Frame>
  </Step>
</Steps>

***

## Source filters

Converge allows you to filter out all events of a specific source with a single filter.
This is especially helpful when you have multiple sales channels, such as multiple storefronts.

### How to set up a source filter

1. Navigate to the [Destinations Tab](https://app.runconverge.com/-/connections) in your Converge dashboard
2. Click on the Destination for which you want to filter out certain sources.
3. Click on the **Configuration** tab and on the **Sources**-subtab to open the Source Filter Configuration
4. Click on **Edit configuration** to modify the configuration.
5. Choose the Sources for which you want to send events.
6. Once you are happy with your selection, click **Save**.
   <Frame>
     <img src="https://mintcdn.com/converge/dh0K_Fgr0_qazJsh/images/destinations/filters/filters-1.png?fit=max&auto=format&n=dh0K_Fgr0_qazJsh&q=85&s=29ff690697811ecbc48c951ceeb51cea" alt="pick filters" width="1062" height="924" data-path="images/destinations/filters/filters-1.png" />
   </Frame>

### Multi-store or multi-website setups

A typical example of source filters is when you are setting up multiple stores.
You might want to set up different Google Ads Destinations for each store for example.
You can use source filters to filter out the appropriate sources per destination.

As an example, if you have a US and CA store, and you are creating a Google Ads Destination for the CA Store -- you will want to configure your Canadian Sources to be the only ones streaming into this Destination.

<Frame>
  <img src="https://mintcdn.com/converge/dh0K_Fgr0_qazJsh/images/destinations/filters/multi-store-example.png?fit=max&auto=format&n=dh0K_Fgr0_qazJsh&q=85&s=3451daa1a3648acac594dd22233b5a01" alt="CAD Example" width="918" height="876" data-path="images/destinations/filters/multi-store-example.png" />
</Frame>
