Alerts

Last updated:

|Edit this page

Alerts enable you to monitor your insights and get notified when the value of the insight breaches a threshold that you've set (for example, number of unique visitors to your site increased by 5% week over week). Currently alerts are supported on all trends (support for funnels coming soon!).

How to create an alert?

  1. Alerts are based off of insights. You can pick any existing trend insight or create a new one.

  2. Click on the Alerts button on top right of the insight page. This shows you all the alerts you've setup for this insight.

    alerts button
  3. Click on New alert

    new alert button
  4. Set a name for the alert.

  5. Pick which 'series' you want to alert on. These are the different events/values you're plotting in the insight. For example, an insight might have multiple series like A - Pageviews (total count of page views for a URL) and B - Signups (count of users who signed up on the page). You can pick either A or B, which will determine if the alert gets checked against the value for A (total page views) or B (signups).

    series picker
  1. Select the alert type. You can choose:
    • has value - checks the series against a specific value.
    • increases by/decreases by - checks if the series has changed by a certain amount.
alert type picker
  1. Set the threshold. This is the value you want to compare the series value against.

  2. (Optional) For relative alerts (increases by/decreases by), you can set a percentage threshold. It compares the percentage change in the series value to the thresholds you've set.

    percentage threshold
  3. Select how often you want the alert to be checked (e.g. every hour, every day, every week, every month)

  4. Pick who should be notified when the alert is triggered. The alert will send an email to everyone in this list when the alert is triggered.

    filled alert
  5. Click Create alert, and you're done!

insight alerts

You can now view all the alerts set on the insight. To view all the alerts set, click on Product Analytics in the sidebar and then click on the Alerts tab.

all alerts

Relative alerts

Relative alerts check for change in the value of an insight. For example, if a value increases by 5% in a week. To create a relative alert, you just need to change the has value option to increases by or decreases by. This will then also enable you to set a percentage threshold.

relative alert picker

Thresholds

We support both absolute value thresholds (insight value more than or less than a certain number) or percentage thresholds (insight value changed by a certain percentage). Percentage thresholds are only available for relative alerts (as you need to compare two values to figure out percentage change).

Notification

Currently alerts only support email notifications. We will add more notification options like webhooks and Slack soon.

Alerts on breakdowns

When you set an alert on a trend with a breakdown, the alert will be triggered when any of the breakdown values breaches the thresholds set.

alert on breakdown

Questions?

Was this page useful?

Next article

Self-host PostHog

This page covers our free, open-source Docker compose deployment , which is available under a MIT license without guarantee . We continue to develop this version, but some premium features are only available on PostHog Cloud. We do not provide support for this "Hobby" version. We no longer support paid, open-source deployments and it is no longer possible to buy licenses for self-hosted versions - we instead recommend migrating to PostHog Cloud . Our MIT-licensed Docker compose…

Read next article