Alerts and subscriptions

Alerts let you and your team stay informed without needing to open a canvas. At scheduled times, Count captures the latest results and sends them via email or Slack, so you can keep stakeholders up to date automatically.

What can be alerted?

Alerts can be created from three types of objects:

  • Cells or visuals – sends an image of the cell or chart, including any visible inputs and outputs.
  • Frames – sends an image of everything inside the frame (the frame border itself is excluded).
  • Reports – sends one image for each report frame.

When an alert runs, Count re-executes the necessary queries in your canvas and then sends screenshots to the chosen destinations.

An example alert message sent to an email address
An example alert message sent to an email address

Creating an alert

You can add alerts from:

  • The floating controls on a cell, visual, or frame.
Create an alert from the floating object controls.
Create an alert from the floating object controls.
  • The Alerts tab in the right-hand sidebar using the + button.
Add an Alert using the '+' button in the Alerts sidebar
Add an Alert using the '+' button in the Alerts sidebar

Once created, all alerts for the canvas are listed in the Alerts sidebar.

All alerts in this canvas are listed in the alerts sidebar.
All alerts in this canvas are listed in the alerts sidebar.

Scheduling alerts

Default schedule

Each canvas has a single default alert schedule that all alerts follow. This is set in the Alerts sidebar.

  • Choose from simple options (hourly, daily, weekly, etc.).
  • For more advanced timing, use 'Custom' and a cron expression.
    • Example: 0 8 * * 1-5 → sends alerts at 8AM every weekday.

Alerts can run up to once per hour. More frequent cron schedules will be rejected.

Alerts respect your canvas caching settings. Make sure your cache duration isn’t longer than your alert frequency, or you may see old results in your alerts.

Individual alerts can override the default by defining their own schedule. This is done by accessing the Configure alert menu next to the alert name:

Subscribers

From the Alerts sidebar you can add and manage who receives alerts.

Click the Manage button to view alert subscribers for this canvas.
Click the Manage button to view alert subscribers for this canvas.

Who can subscribe

  • Workspace members – receive alerts by email, and optionally via Slack if their Slack account is connected.
  • Workspace groups – if enabled, alerts are sent to all members.
  • Slack channels – alerts are posted directly to a channel (requires Slack connection).
  • Email addresses – alerts can be sent to external emails.

Additionally:

  • If a subscriber does not have permission to view the canvas, they will not receive alerts unless public alerts are enabled in workspace settings. In this case a warning message will be displayed (see below)
  • If subscribers receive an alert and do not have a Count account or access to that canvas, then the alert will not include a link to the canvas.
If a subscriber cannot view this canvas, public alerts need to be enabled in order for them to receive alerts.
If a subscriber cannot view this canvas, public alerts need to be enabled in order for them to receive alerts.

Managing subscriptions

  • Use the checkboxes to choose which alerts a subscriber receives.
  • Use the subtract icon to remove a subscriber.
  • By default, subscribers also get error reports if an alert fails. You can toggle this off.
  • Individual users can opt out from their canvas menu and will not appear in the alert subscribers list.
Opt out of alerts from the canvas menu
Opt out of alerts from the canvas menu

Alert options

Click the settings icon on any alert to configure options:

  • Trigger – conditions under which the alert should send (see below).
  • Custom schedule – override the default schedule.
  • Include data – if enabled, for a cell or visual alert include a link to a CSV file containing up to 10,000 rows of the data for that cell or visual. If the canvas is deleted, this link will stop working.
  • Disable alert – turn off the alert without deleting it.

You can also reorder alerts in the sidebar — this order determines the order of alerts in the notifications that are sent.

Access alert settings from the settings icon for each alert.
Access alert settings from the settings icon for each alert.

Alert triggers

Triggers control when an alert actually fires. For alerts on cells, the condition will relate to the cell itself. For frames or reports, the condition can relate to any cell in the canvas. Options include:

  • None – always send at the scheduled time.
  • Rows returned / No rows returned – trigger only if a query does/does not return rows.
  • Query error / Query does not error – trigger based on query success or failure.
  • First row matches value – trigger if the first row in a column matches a set value (text, number, or null).
An example of a custom alert trigger on a Frame.
An example of a custom alert trigger on a Frame.

Testing alerts

Use the Test button in the Alerts sidebar to send a sample notification.

  • Test alerts respect subscriber settings, so you can confirm delivery.
  • If a trigger condition isn’t met, the alert will still be listed with a message explaining why it didn’t fire.

Troubleshooting