Filter Out

This connector enables you to create filters which prevent PostHog from ingesting data from your product unless it passes those filters. Any events which do not match the filter requirements are skipped over and are not ingested.

Requirements

Using this connector requires either PostHog Cloud with the data pipeline add-on, or a self-hosted PostHog instance running version 1.30.0 or later.

Self-hosting and not running 1.30.0? Find out how to update your self-hosted PostHog deployment.

Installation

In PostHog, click the "Data pipeline" tab in the left sidebar.
Search for 'Filter Out' and select the connector, press Install.
Follow the on-screen steps to configure the connector.

This connector will only work on events ingested after the connector was enabled.

Configuration

The connector can be configured via a JSON file which specifies the properties you would like to filter.

In the example config below, the connector will only keep events where all of the following conditions are met:

Email does not contain yourcompany.com
Host is not localhost:8000
Browser version greater than 100

[
  {
    "property": "email",
    "type": "string",
    "operator": "not_contains",
    "value": "yourcompany.com"
  },
  {
    "property": "$host",
    "type": "string",
    "operator": "is_not",
    "value": "localhost:8000"
  },
  {
    "property": "$browser_version",
    "type": "number",
    "operator": "gt",
    "value": 100
  }
]