Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion docs-mintlify/docs/explore-analyze/notifications.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,14 @@ Email notifications are sent to selected workspace users after a scheduled
refresh completes. Each recipient receives a message with a link to the
dashboard and the attached screenshot.

<Tip>

Recipients don't have to be added by an editor. Anyone who can view the dashboard
can [subscribe themselves][ref-subscribe] to a schedule's email notifications
from the published dashboard.

</Tip>

## Slack notifications

Slack notifications post a message with the dashboard screenshot to a single
Expand All @@ -83,4 +91,4 @@ workspace has access to.
[ref-roles]: /admin/users-and-permissions/roles-and-permissions
[ref-scheduled-refreshes]: /docs/explore-analyze/scheduled-refreshes
[ref-duplicate]: /docs/explore-analyze/scheduled-refreshes#duplicating-a-schedule
[ref-scheduled-refreshes]: /docs/explore-analyze/scheduled-refreshes
[ref-subscribe]: /docs/explore-analyze/scheduled-refreshes#subscribing-to-notifications
30 changes: 29 additions & 1 deletion docs-mintlify/docs/explore-analyze/scheduled-refreshes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,9 @@ description: Scheduled refreshes are available on Premium and Enterprise plans.

Scheduled refreshes are available on [Premium and Enterprise plans](https://cube.dev/pricing).
<br/ >Users need at least the [Explorer][ref-roles] role and Edit or Manage permission
on the workbook to set up scheduled refreshes.
on the workbook to set up scheduled refreshes. Anyone who can view the dashboard
can open the sidebar to see its schedules and [subscribe to
notifications](#subscribing-to-notifications).

</Info>

Expand All @@ -25,6 +27,16 @@ From the Dashboard Builder, click the calendar icon in the toolbar to open the
scheduled refreshes sidebar. From this sidebar, you can create new schedules,
modify existing ones, or remove schedules you no longer need.

The same calendar icon is also available on a published dashboard, so you can
reach the sidebar without opening the builder. What you can do there depends on
your permission on the workbook:

- **Edit** or **Manage** — the full sidebar: create, edit, run, and delete
schedules.
- **View only** — a read-only list of the configured schedules, where you can
[subscribe or unsubscribe](#subscribing-to-notifications) yourself from each
schedule's email notifications.

<Warning>

The dashboard must be published before schedules can be created.
Expand Down Expand Up @@ -104,6 +116,22 @@ duplicate it. There are two ways:
Duplicates are independent schedules: the original is left unchanged, and the
copy keeps the source schedule's enabled or disabled state.

## Subscribing to notifications

If a schedule sends [email notifications][ref-notifications], anyone who can view
the dashboard can subscribe to it themselves — an editor does not have to add
them as a recipient. Open the scheduled refreshes sidebar from the published
dashboard and use the toggle on a schedule to subscribe or unsubscribe.
Subscribing adds you to the schedule's email recipients; unsubscribing removes
you. The change takes effect on the next run.

The toggle appears only for schedules that email individual recipients — those
with notifications enabled and the email delivery channel. A schedule delivers to
either individual inboxes or a Slack channel, not both, so a schedule that posts
to Slack (or that has notifications turned off) has nothing to subscribe to. If an
editor switches a schedule to Slack, its existing subscriptions are cancelled;
you can subscribe again if it is later switched back to email.

## Run phases

When a scheduled refresh runs, it progresses through these phases:
Expand Down
Loading