You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@superset.apache.org by ru...@apache.org on 2026/08/27 15:52:15 UTC

(superset) branch fix/from-pr-40885-needs-docs-feat-added-email-delivery-of- created (now ac3a8cd86d1)

This is an automated email from the ASF dual-hosted git repository.

rusackas pushed a change to branch fix/from-pr-40885-needs-docs-feat-added-email-delivery-of-
in repository https://gitbox.apache.org/repos/asf/superset.git


      at ac3a8cd86d1 docs(alerts-reports): document report/alert content format options

This branch includes the following new commits:

     new ac3a8cd86d1 docs(alerts-reports): document report/alert content format options

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.



(superset) 01/01: docs(alerts-reports): document report/alert content format options

Posted by ru...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

rusackas pushed a commit to branch fix/from-pr-40885-needs-docs-feat-added-email-delivery-of-
in repository https://gitbox.apache.org/repos/asf/superset.git

commit ac3a8cd86d10a21477ad9fd946c7258fdf344024
Author: rusackas <ev...@rusackas.com>
AuthorDate: Thu Aug 27 08:51:44 2026 -0700

    docs(alerts-reports): document report/alert content format options
    
    Alerts & Reports supports PDF, PNG, CSV, XLSX, and Text delivery
    formats, but alerts-reports.mdx never listed them or noted which
    apply to dashboards vs. charts. Adds a dedicated section covering
    this, following up on #40885 which added XLSX support without
    documenting it.
    
    Co-Authored-By: Claude <no...@anthropic.com>
---
 docs/admin_docs/configuration/alerts-reports.mdx | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/admin_docs/configuration/alerts-reports.mdx b/docs/admin_docs/configuration/alerts-reports.mdx
index d07dead9de2..336e25e22f6 100644
--- a/docs/admin_docs/configuration/alerts-reports.mdx
+++ b/docs/admin_docs/configuration/alerts-reports.mdx
@@ -14,6 +14,18 @@ Users can configure automated alerts and reports to send dashboards or charts to
 
 Alerts and reports are disabled by default. To turn them on, you'll need to change configuration settings and install a suitable headless browser in your environment.
 
+## Content Format Options
+
+When scheduling an alert or report, you can choose the format used to deliver the dashboard or chart:
+
+- **PDF** – a full-page screenshot rendered as a PDF attachment. Available for both dashboards and charts.
+- **PNG** – a screenshot embedded directly in the email or Slack message. Available for both dashboards and charts.
+- **CSV** – chart data attached as a `.csv` file. Available for charts only.
+- **XLSX (Excel)** – chart data attached as a `.xlsx` file. Available for charts only. If the chart's data spans multiple server-paginated files, the attachment is delivered instead as a `.zip` archive containing the individual `.xlsx` files.
+- **Text** – chart data embedded directly in the email or Slack message body. Available only for charts using a text-based visualization type (e.g. Table, Pivot Table, Paired t-test).
+
+Dashboard reports and alerts are limited to the PDF and PNG formats; the CSV, XLSX, and Text options are only available when scheduling a report or alert for an individual chart.
+
 ## Requirements
 
 ### Commons