This is an automated email from the ASF dual-hosted git repository.
rusackas pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/superset.git
The following commit(s) were added to refs/heads/master by this push:
new 105820f1f4b docs(reports): playwright setup clarification (#40168)
105820f1f4b is described below
commit 105820f1f4b3da3647671dd070b5e65888f0cc3b
Author: SkinnyPigeon <[email protected]>
AuthorDate: Wed May 20 19:32:02 2026 +0200
docs(reports): playwright setup clarification (#40168)
---
docs/admin_docs/configuration/alerts-reports.mdx | 6 +++---
superset/config.py | 5 ++++-
2 files changed, 7 insertions(+), 4 deletions(-)
diff --git a/docs/admin_docs/configuration/alerts-reports.mdx
b/docs/admin_docs/configuration/alerts-reports.mdx
index f5c4efc42ed..6055d63211f 100644
--- a/docs/admin_docs/configuration/alerts-reports.mdx
+++ b/docs/admin_docs/configuration/alerts-reports.mdx
@@ -36,9 +36,9 @@ Screenshots will be taken but no messages actually sent as
long as `ALERT_REPORT
#### In your `Dockerfile`
You'll need to extend the Superset image to include a headless browser. Your
options include:
-- Use Playwright with Chrome: this is the recommended approach as of version
4.1.x or greater. A working example of a Dockerfile that installs these tools
is provided under "Building your own production Docker image" on the [Docker
Builds](/admin-docs/installation/docker-builds#building-your-own-production-docker-image)
page. Read the code comments there as you'll also need to change a feature
flag in your config.
-- Use Firefox: you'll need to install geckodriver and Firefox.
-- Use Chrome without Playwright: you'll need to install Chrome and set the
value of `WEBDRIVER_TYPE` to `"chrome"` in your `superset_config.py`.
+- Use Playwright with Chromium: this is the recommended approach as of version
4.1.x or greater. Playwright always uses Chromium — the `WEBDRIVER_TYPE` config
setting has no effect when Playwright is active. A working example of a
Dockerfile that installs these tools is provided under "Building your own
production Docker image" on the [Docker
Builds](/admin-docs/installation/docker-builds#building-your-own-production-docker-image)
page. Enable the `PLAYWRIGHT_REPORTS_AND_THUMBNAILS` feat [...]
+- Use Firefox (Selenium): you'll need to install geckodriver and Firefox. Set
`WEBDRIVER_TYPE` to `"firefox"` in your `superset_config.py`.
+- Use Chrome (Selenium): you'll need to install Chrome. Set `WEBDRIVER_TYPE`
to `"chrome"` in your `superset_config.py`.
In Superset versions <=4.0x, users installed Firefox or Chrome and that was
documented here.
diff --git a/superset/config.py b/superset/config.py
index ae63d828c83..2a29ce87147 100644
--- a/superset/config.py
+++ b/superset/config.py
@@ -2011,7 +2011,10 @@ SLACK_CACHE_TIMEOUT =
int(timedelta(days=1).total_seconds())
# For workspaces with 10k+ channels, consider increasing to 10
SLACK_API_RATE_LIMIT_RETRY_COUNT = 2
-# The webdriver to use for generating reports. Use one of the following
+# The webdriver to use for generating reports when using Selenium (not
Playwright).
+# This setting is ignored when PLAYWRIGHT_REPORTS_AND_THUMBNAILS is enabled, as
+# Playwright always uses Chromium regardless of this value.
+# Use one of the following:
# firefox
# Requires: geckodriver and firefox installations
# Limitations: can be buggy at times
