--- title: Scheduled Reports description: >- Send recurring dashboard PDFs to email addresses, Slack channels, and Microsoft Teams channels with customizable schedules and time frames. breadcrumbs: Docs > Dashboards > Sharing > Scheduled Reports --- # Scheduled Reports ## Overview{% #overview %} Scheduled reports enable Datadog users to share dashboards as high-density PDFs on a recurring basis. {% image source="https://datadog-docs.imgix.net/images/dashboards/scheduled_reports/report_pdf.0a40a776e5e0c0eb9082813deca3923a.png?auto=format" alt="Example report PDF attachment" /%} The report PDF can be sent to email addresses, Slack channels, or Microsoft Teams channels. {% image source="https://datadog-docs.imgix.net/images/dashboards/scheduled_reports/report_slack.1d9f23c9b956f09ddff368542150209a.png?auto=format" alt="Example report slack with PDF report linked" /%} For emails, the report PDF is included as an email attachment or as a link, depending on its size. {% image source="https://datadog-docs.imgix.net/images/dashboards/scheduled_reports/report_email.5be3618e46ab66c74f73ba19adb7622f.png?auto=format" alt="Example report email with PDF attachment" /%} ## Schedule a report{% #schedule-a-report %} Create a report from any [dashboard or timeboard](https://docs.datadoghq.com/dashboards/#get-started) that has at least one supported widget. Click the **Share** button at the top of your dashboard and select **Schedule report**. ### 1. Set a schedule In the configuration modal that opens, set a schedule for the report to determine when and how often the report is sent. **** **{% image source="https://datadog-docs.imgix.net/images/dashboards/scheduled_reports/set_schedule.d23a75703081a3d9aed48869fa3e2e9f.png?auto=format" alt="Section for defining a report schedule. Includes a schedule preview table showing the next 5 scheduled report dates." /%}** ### 2. Configure report Define the report title and set a time frame to determine the range of time displayed in the resulting report. The report time frame can be different from the time frame displayed on the dashboard. **Note:** Modifying the report time frame updates the **Schedule Preview** dropdown table above. **** **{% image source="https://datadog-docs.imgix.net/images/dashboards/scheduled_reports/configure_report.1dd2b6d17c3aa9f3a600d599c3c5205a.png?auto=format" alt="Section for defining a report schedule" /%}** Click **Edit Variables** to modify the filters applied when the report is sent. These values do not affect the dashboard's default template variable values. **** **{% image source="https://datadog-docs.imgix.net/images/dashboards/scheduled_reports/edit_variables.6bc05556314033d55200215a5b496c80.png?auto=format" alt="The configuration modal section for customizing the report title, timeframe and variables." /%}** ### 3. Add recipients #### Email recipients{% #email-recipients %} To add email recipients to your report, enter their email addresses. The email associated with your Datadog account is automatically added as a recipient. You can remove yourself as a recipient by hovering over your email and clicking the trash icon that appears next to it. **Note:** Enterprise and Pro accounts can send reports to recipients outside of their organizations. **** **{% image source="https://datadog-docs.imgix.net/images/dashboards/scheduled_reports/add_email_recipients.f827399ece7be8480a32c35a6317eca5.png?auto=format" alt="The configuration modal for editing scheduled report variables." /%}** To see the report before saving the schedule, click **Send Test Email**. You can pause a report schedule at any time. #### Slack recipients{% #slack-recipients %} To add Slack recipients, select the Slack workspace and channel from the available dropdowns. If you do not see any Slack workspaces available, ensure you have the Datadog [Slack Integration](https://docs.datadoghq.com/integrations/slack/?tab=datadogforslack) installed. All public channels within the Slack workspace should be listed automatically. To select a private Slack channel, make sure to invite the Datadog Slack bot to the channel in Slack. To send a test message to Slack, add a channel recipient and click **Send Test Message**. **** **{% image source="https://datadog-docs.imgix.net/images/dashboards/scheduled_reports/add_slack_recipients.8e83e9ebf9741181c4c9a97006a8ee06.png?auto=format" alt="The configuration modal for editing scheduled report email recipients." /%}** #### Microsoft Teams recipients{% #microsoft-teams-recipients %} Before adding Microsoft Teams recipients, ensure: - The [Microsoft Teams integration](https://docs.datadoghq.com/integrations/microsoft_teams/) is installed in your Datadog organization. - The Datadog app is added to the target Team in Microsoft Teams. To add Microsoft Teams recipients, select the **Microsoft Teams** tab, then choose a **Tenant**, **Team**, and **Channel** from the available dropdowns. To send a test message, add a channel recipient and click **Send Test Message**. ## Managing reports{% #managing-reports %} A single dashboard can have multiple scheduled reports with different settings, which allows you to inform different groups of stakeholders interested in the same dashboard. To see the reports on an existing dashboard, click the **Share** button and select **Configure Reports**. From the configuration modal that opens, you can pause an existing report or create a new report. To see and edit the details of an existing report, or delete the report, click **Edit**. {% image source="https://datadog-docs.imgix.net/images/dashboards/scheduled_reports/manage_reports-2.0feea9ca3af7a1b832716051fe1a4c96.png?auto=format" alt="The configuration modal for scheduled reports, with two reports displayed, each showing their titles, tags, recipients, frequency, an option to toggle the report on or off, and a button to edit the report. At the bottom is a button to add a new report and a cancel button" /%} ## Permissions{% #permissions %} Users need the **Dashboards Report Write** [permission](https://docs.datadoghq.com/account_management/rbac/permissions/) to create and edit report schedules. This permission can be granted by another user with the **User Access Manage** permission. {% image source="https://datadog-docs.imgix.net/images/dashboards/scheduled_reports/dashboard_permissions-2.a4ddbc5150107dfe23760cb893aaf9ac.png?auto=format" alt="A screenshot of an individual user's permissions from within the organization settings page. The dashboards report write permission is highlighted under the dashboards section" /%} Users with the **Org Management** permission can enable or disable the scheduled reports feature for their organization from the **Settings** tab under [Public Sharing](https://docs.datadoghq.com/account_management/org_settings/#public-sharing) in **Organization Settings**. {% image source="https://datadog-docs.imgix.net/images/dashboards/scheduled_reports/report_management_org_preference.e6236051012d20d7f04d436aa10fd5a6.png?auto=format" alt="The Report Management setting in the Settings tab in Public Sharing within Organization Settings in Datadog with the setting Enabled" /%} Additionally, users with the **Org Management** permission can enable or disable Slack recipients for their organization from the **Settings** tab under [Public Sharing](https://docs.datadoghq.com/account_management/org_settings/#public-sharing) in **Organization Settings**. {% image source="https://datadog-docs.imgix.net/images/dashboards/scheduled_reports/report_send_to_slack_org_preference.687bc381166f378a65a633aff78c063b.png?auto=format" alt="The Send to Slack setting under Report Management setting in the Settings tab in Public Sharing within Organization Settings in Datadog with the setting Enabled" /%} Similarly, users with the **Org Management** permission can enable or disable Microsoft Teams recipients for their organization from the **Settings** tab under [Public Sharing](https://docs.datadoghq.com/account_management/org_settings/#public-sharing) in **Organization Settings**. ## Unsupported widget types{% #unsupported-widget-types %} The following widget types are **not** supported and will be shown as empty in the report: - [Iframe](https://docs.datadoghq.com/dashboards/widgets/iframe/) - [Image](https://docs.datadoghq.com/dashboards/widgets/image/) - [Hostmap](https://docs.datadoghq.com/dashboards/widgets/hostmap/) - [Run Workflow](https://docs.datadoghq.com/dashboards/widgets/run_workflow/) ## Further Reading{% #further-reading %} - [Share Datadog dashboards securely with anyone](https://www.datadoghq.com/blog/dashboard-sharing/) - [Use associated template variables to refine your dashboards](https://www.datadoghq.com/blog/template-variable-associated-values/)