Filter Out

Last updated:

What does the Filter Out app do?

This app 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.

What are the requirements for this app?

Using the Filter Out app requires either PostHog Cloud, or a self-hosted PostHog instance running version 1.30.0 or later.

Not running 1.30.0? Find out how to update your self-hosted PostHog deployment!

How do I install the Filter Out app?

  1. Visit the 'Apps' page in your instance of PostHog.
  2. Search for 'Filter Out' and select the app, press Install.
  3. Follow the on-screen steps to configure the app.

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

How do I configure the Filter Out app?

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

In the example config below, the app 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
}
]

The followed types and operators are allowed:

TypeOperators
numbergt, gte, lt, lte, eq, neq
stringis, is_not, contains, not_contains, regex, not_regex
booleanis, is_not

Who maintains this app?

This app was created by @plibither8 and is maintained by the community. If you have issues with the app not functioning as intended, please raise a bug report to let us know!

What if I have feedback on this app?

We love feature requests and feedback! Please create an issue to tell us what you think.

What if my question isn't answered above?

We love answering questions. Ask us anything via our Support page.

You can also join the PostHog Community Slack group to collaborate with others and get advice on developing your own PostHog apps.

Questions?

Was this page useful?