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, the number of unique visitors to your site increased by 5% week over week). Currently, alerts are supported on all trends, with 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 the Alerts button on the top right of the insight page. This shows you all the alerts for this insight.

    alerts button
  3. Click the New alert button.

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

  5. Select a '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 - $pageview (total count of page views for a URL) and B - signed_up (count of users who signed up on the page). You can select 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:

    • 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
  2. Set the threshold. This is the value you want to compare the series value against. For example, you can set a value of 5000 in the "more than" field to check when pageviews have exceeded 5k.

  3. (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
  4. Select how often you want the alert to be checked (e.g. every hour, every day, every week, every month)

  5. 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
  6. 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 Product analytics in the sidebar and then click 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

Command palette

Power users, rejoice! You can access many PostHog features (and saved dashboards) using your keyboard. Launch the command palette Open with Cmd + K (Mac) or Ctrl + K (Windows, Linux). Supported commands Go to... Dashboards Trends Funnels Retention Paths Events Actions Persons Cohorts Feature flags Annotations Team members Project homepage Project settings Account settings Apps Log out Instance status (staff users of self-hosted instances only) Open a saved dashboard Type a dashboard name…

Read next article