Skip to main content

App notifications

Get notified when an app is refreshed, or only when a certain condition is met.

info
  • Available on the Team and Enterprise plans.
  • Users with Can Edit or higher project permissions can manage all notifications on a project.
  • Users with Can View project permissions and the Editor role can set up notifications for themselves.

There are two types of app notifications that can be created:

  • Subscriptions: Deliver a link to an app when a scheduled run completes, or be notified if the scheduled run errors.
  • Conditional notifications: Get notified after a scheduled run, only if a condition is met.

Create an app notification​

To create a notification:

  • Open the scheduled runs sidebar in either the published app or notebook view.
  • In the top right-hand corner, select Add notification.
  • Select Subscription or Conditional notification, and then configure the notification.

You can also add a notification to an existing scheduled run by clicking on the scheduled run entry in the sidebar, then selecting + Add notification.

Subscriptions​

When configuring a subscription, you can choose:

  • Which scheduled run to tie the subscription to (or optionally create a new scheduled run).
  • Whether to be notified when the scheduled run succeeds, errors, or both.

Conditional notifications​

tip

Use the bell icon on a Single Value or Table Display cell in a published app to quickly create a conditional notification.

When configuring a conditional notification, you can choose:

  • The condition to evaluate
  • The frequency of when the condition should be checked, via an existing or new scheduled run.

The following types of cells can be used to define a conditional notification:

  • Single value cells: Evaluate the numeric value in a single value cell against a condition.
  • Table display cells: Evaluate the number of rows returned by a table display cell against a condition.

Note: Cells must be included in the app to be used in a conditional notification criteria. Conditional notifications can only be created from the published app.

Configure notification delivery​

There are two main delivery methods for app notifications:

  • Users & groups: Deliver a notification to users and groups
  • Slack channels: Deliver a notification to a Slack channel

Notify users & groups​

This option delivers a notification directly to users and groups via in-app notifications, email and Slack — the delivery channel depends on the recipient's notification preferences.

tip

Notifications delivered via Slack are sent as a direct message from the Hex integration to each recipient. These are distinct from Slack channel notifications outlined below.

Users with Can edit project permissions can create subscription notifications for themselves and on behalf of others, as well as manage all notifications on an app.

Users with Can view project permissions and the Editor role can set only set up notifications for themselves.

A user must have App only project permissions or higher permissions to receive app notifications. If you attempt to send notifications to a user or group that does not have access to the project, the user(s) will automatically be granted App Only access.

Notify a Slack channel​

This option sends notifications to a Slack channel, rather than an individual user. They can be configured by users with Can edit project permissions.

To send Slack channel notifications, an Admin will first need to need to configure the Hex integration for Slack from Settings > Integrations.

The first time you set up a Slack notification by selecting the Send to Slack channel option, you'll be prompted to link your personal Slack account with the Sign in button.

To send an app notification to a private Slack channel, first add the Hex integration to the channel and refresh the page where you are configuring the schedule.

Attaching screenshots​

App notifications can optionally have a copy of the app attached when they are delivered.

To attach a screenshot to a notification, enable the "attach screenshot" toggle and choose from PNG or PDF format.

Customize notification content​

When configuring a notification, users can customize the subject line, and add an additional message to the body of the notification. Note that the default message sent as part of the notification is always included in the body.

To customize the notification content, enable the "customize notification content" toggle.

On this page