Skip to content
  • Home
  • Developers
  • API
  • Releases
  • Community
  • University
  • Status
  • Home
  • Developers
  • API
  • Releases
  • Community
  • University
  • Status
Home Charts Chart Features Report Alerts
Session Replay Getting Started Administration Data Management Definitions Charts Analysis Examples Heap Plays Integrations Heap Connect Data Privacy

Table of Contents

Was this article helpful?

Yes No

Thank you for your feedback!

Report Alerts

In this article you'll learn:

  • How to set up automatic email and Slack alerts for when analysis results change by a certain threshold
  • How to add Heap to Slack to enable Slack alerts
  • How to review a list of all reports with an alert set
  • How to manage and remove alerts from reports
This doc is for: Admins Architects Analysts Consumers

Overview

Report Alerts is only available for customers on a paid plan. To upgrade, contact sales@heap.io.

You can use alerts to set up Slack or email notifications when Heap graph or funnel analysis results go above or below a certain threshold. This enables you to quickly spot and address changes in crucial business metrics.

For example, if you see a drop in checkout conversion, you can review and fix any issues within that flow that might be holding back potential buyers. If you see a sudden increase in new signups, you can tailor marketing efforts to this new group of users to encourage additional engagement.

Alerts can only be set on the Production environment.

We recommend setting alerts for reports that you tend to check often, such as multiple times a week. You can set the alert threshold to ensure you’re only receiving them when significant changes occur.

Set New Alert

Team members in the Read-Only role cannot set Alerts.

You can set alerts on graph and funnel reports. To set an alert, navigate to the report you want to add the alert for or save a new report.

To add the alert, click the three dots in the top-right corner and click Configure Threshold Alerts in the drop-down that appears.

In the pop-up that appears, select: 

  • Whether the alert should be set off by an increase or decrease in metrics
  • The amount and type of change:
    • Percent: If you have a conversion rate of 50%, and you choose a threshold of 10%, you’ll get alerted if the conversion rate drops below 45%
    • Percentage points: If you have a conversion rate of 50%, and you choose a threshold of 10 percentage points, you’ll get alerted if the conversion rate drops below 40%
  • The comparison period for the alert to be compared to, e.g. previous month, quarter, or year
  • Send via Email: Add the email addresses that the alert should be sent to – you can select a Heap team member via autocomplete or type in a non-Heap team members’ email
  • Send via Slack: Select the Slack channels this alerts should be sent to – note that you cannot set up report alerts for private Slack channels

If the email address belongs to someone who is not part of your Heap workspace, they will still get the email, but they will need to be invited to join Heap before they can use the link in that email to see the report.

Once you click Enable, the alert will be set for this report.

For email alerts, when the alert is set off, all email addresses added to the alert will immediately receive an email like the one below. Note that alerts will be computed at 1am PDT (12am PST once DST is over) nightly, regardless of the recipient’s time zone.

An email stating that an Alert has increased by 6.22%

Add Heap to Slack

To set alerts that will be delivered as Slack notifications, you must first set up Slack with your Heap workspace. You’ll be prompted to do this when setting up an alert. Click the ‘Add Heap to Slack…’ button to get this set up.

The 'Add Alert' pop-up with an arrow pointing to the 'Add Heap to Slack' button

You must have permission to install apps to your Slack workspace to integrate Heap.

You’ll be prompted to grant permission for Heap to access Slack. Once you grant permission, you’ll be redirected back to Heap to finish setting up your alert.

Once enabled, here’s how your alert will look in Slack:

The Heap app posting a Slack message about an increased in a graph metric

Viewing Reports with Alerts Set

To see reports that have alerts enabled, navigate to the Reports page, click the Has Alerts option from the Alerts dropdown.

Updating & Deleting Alerts

You can review and update an alert at any time by navigating to the report and selecting Configure Threshold Alerts via the drop-down in the top-right corner.

Review and update the options listed in the Edit Alert pop-up to your heart’s content. You can also delete this alert by clicking Remove Alert in the bottom left corner.

The ‘Add Alert’ pop-up where the ‘Send via email’ and ‘Send via Slack’ fields are being populated

Limitations

Currently, alerts are not supported for:

  • Reports using a group by
  • Reports using a compare
  • Reports using the date range granularity ‘Date to Now’
  • Reports using a custom date range
  • Graphs using Hour, Week, or Month granularity
  • Graphs using average time between
  • Graphs with ratios
  • Multigraphs
  • Environments aside from Production

Was this article helpful?

Yes No

Thank you for your feedback!

Last updated October 19, 2022.

email alertsHeap alertsproduct alertingproduct alertsproduct metrics alertsreport alertsslack alerts
  • Blog
  • Partners
  • Legal
  • Security
  • Terms
  • About
  • Careers
  • Privacy
  • Contact Us

© 2023 Heap, Inc.