From d6d1f3588aa5665ea516396d4dd486579104c379 Mon Sep 17 00:00:00 2001 From: Joe Li Date: Thu, 25 Sep 2025 16:23:00 -0700 Subject: [PATCH] docs: document APP_ICON deprecation in favor of theme-based brandLogoUrl MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The APP_ICON configuration variable was deprecated in PR #31590 (Ant Design v5 theming overhaul) but this breaking change was not documented in UPDATING.md. Users were confused when their custom logos stopped working in Superset 6.0.0rc1. Added clear migration instructions showing how to replace APP_ICON with the new THEME_DEFAULT.token.brandLogoUrl configuration. Resolves misconceptions about APP_ICON functionality mentioned in issue #34824. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- UPDATING.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/UPDATING.md b/UPDATING.md index 83e22ced382b..6ba96da759ab 100644 --- a/UPDATING.md +++ b/UPDATING.md @@ -233,6 +233,18 @@ See `superset/mcp_service/PRODUCTION.md` for deployment guides. --- - [35621](https://github.com/apache/superset/pull/35621): The default hash algorithm has changed from MD5 to SHA-256 for improved security and FedRAMP compliance. This affects cache keys for thumbnails, dashboard digests, chart digests, and filter option names. Existing cached data will be invalidated upon upgrade. To opt out of this change and maintain backward compatibility, set `HASH_ALGORITHM = "md5"` in your `superset_config.py`. +- [31590](https://github.com/apache/superset/pull/31590): The `APP_ICON` configuration variable is now deprecated and ignored by the frontend. Custom logos should now be configured using the theme system with `brandLogoUrl`. To migrate, replace: + ``` + APP_ICON = "/static/assets/images/custom_logo.png" + ``` + with: + ``` + THEME_DEFAULT = { + "token": { + "brandLogoUrl": "/static/assets/images/custom_logo.png" + } + } + ``` - [35062](https://github.com/apache/superset/pull/35062): Changed the function signature of `setupExtensions` to `setupCodeOverrides` with options as arguments. ### Breaking Changes