subscriptions.md

title: Dashboard subscriptions
redirect_from:
  - /docs/latest/users-guide/dashboard-subscriptions
  - /docs/latest/enterprise-guide/dashboards-subscriptions

Dashboard subscriptions

Dashboard subscriptions are a great way to keep you and your team up to date on the data that matters most. They allow you to send all of the questions on a dashboard via email or Slack. If your Metabase has email or Slack set up, all you need to do is create a dashboard, add subscribers to it, and tell Metabase how often you'd like the send out an update. You can set up as many subscriptions to a dashboard as you like, and if you make any changes to the dashboard, Metabase will update the subscriptions the next time they're delivered.

Enabling dashboard subscriptions

To enable dashboard subscriptions, your administrators will need to have set up email or Slack for your Metabase. See Setting up email or Setting up Slack.

Setting up a dashboard subscription

To set up a subscription to a dashboard, click on the sharing icon (the one-way arrow) and select Dashboard subscriptions.

Metabase will slide out a sidebar on the right, with an option to set up a subscription via email or Slack:

Let's say we want to email a dashboard. We'll click on the Email it option in the sidebar, and Metabase will give us some options:

How permissions work with dashboard subscriptions

• Recipients of dashboard subscriptions will be able to see whatever the creator of the dashboard subscription can see. That is, people will get to see charts in their email or Slack as if they had the subscription creator's permissions to view those charts, regardless of whether their groups have permission to view those charts.
• Admins can see and edit all subscriptions. Admins can modify recipients, filters, or delete the subscription without affecting the subscription's permissions; the subscription will continue to send data based on the subscription's creator's permissions.
• Non-admins only see their subscriptions, not subscriptions created by others. People who are 1) not in the Admin group, and 2) not sandboxed, can only see the subscriptions they've created. They can add anyone in their Metabase to their subscriptions using the dropdown menu.
• People in data sandboxes can only send dashboard results to themselves. People who are sandboxed will only see themselves in the list of recipients for dashboard subscriptions.

Email subscription options

For emails, we can:

• Add subscribers. Add email addresses to register subscribers.
• Determine frequency and timing. Tell Metabase how often it should send the dashboard (daily, weekly, or monthly), and what time of day to send the dashboard.
• Send email now sends an email to all subscribers.
• Skip updates without results. If there are no results, we can tell Metabase to skip sending the email.
• Attach results. Tell Metabase if it should also attach results to the email (which will include up to 2000 rows of data). You can choose between CSV and XLSX file formats.

If you've added filters to your dashboard and set default values for those filters, Metabase will apply those default values to your subscriptions, filtering the results of all questions that are connected to those filters when the subscriptions are sent. To learn more, check out dashboard filters.

Slack subscription options

For Slack subscriptions, you can set up a subscription for a channel (like #general), or for a single person via their Slack username.

You can specify how often Metabase sends a Slack message (hourly, daily, weekly, or monthly), and whether to send a message if the dashboard fails to return results.

Adding multiple subscriptions

You can add multiple subscriptions to a single dashboard. To add a subscription, click on the + icon in the dashboard subscription panel.

Deleting a subscription

To remove a subscription from a dashboard, select the subscription you'd like to remove. At the bottom of the sidebar, select Delete this subscription. Follow the instructions on the modal that pops up to confirm you'd like to delete the subscription.

Viewing existing dashboard subscriptions

{% include plans-blockquote.html feature="Audit logs" %}

To view a list of all alerts and dashboard subscriptions that people have set up in your Metabase, click on the gear icon in the upper right and select Admin settings > Audit > Subscriptions & Alerts. See Audit logs.

Customize filter values for each dashboard subscription

{% include plans-blockquote.html feature="Dashboard subscription filter customization" %}

You can customize which filter values to apply to each dashboard subscription. That way you can send different groups of people an email (or Slack message) the contents of the dashboard with different filters applied. You only need to maintain one dashboard, which you can use to send results relevant to each subscriber.

Setting filter values

You can set values for each filter on the dashboard. If you have any dashboard filters with default values, you can override those defaults for a given subscription, or leave them as-is.

Here's the sidebar where you can set the filter values:

The section to call out here is the Set filter values for when this gets sent. Here we've set "VT" as the value for the dashboard's State filter to scope results to records from Vermont. We didn't set a value for the Created_At filter, so the subscription will send the results without a filter applied. If you've set a default value for the filter, the subscription will list the value here.

Related reading

• Setting up email
• Setting up Slack