[meta] Tasks to deprecate Settings Tray [#3576667]

Problem/Motivation

Track the steps needed to deprecate extension Settings Tray. See Remove a core extension and move it to a contributed project of the deprecation policy.

The removal of extension Settings Tray was approved in #3576315: [policy, no patch] Move Settings Tray to a contributed project.

All the child issues here, except in the infrastructure project, are "11.5.0 release priority".

Settings Tray has a dependency on Toolbar. If Settings Tray is deprecated and moved to a contributed project before Toolbar this isn't a problem. Settings Tray in contrib can depend on Toolbar in contrib. See this comment.

Remaining tasks

To find uses of settings tray:

git grep -lwi "settings[_ ]tray" | grep -v core/modules/settings_tray/ | grep -v core/assets | grep -v phpstan-baseline | grep -v MAINTAINERS

✅ comsicdreams is a maintainer of the contrib version of the extension.
✅ Add the extension to the list of the Upcoming Deprecations.
Move integrations implemented by other modules to the extension.
Create child issues or child meta issues, as needed, to address the following points. Not all points will apply to all extensions.
- Move tests to the extension.
- Move Help Topics to the extension. #3582016: Move help topics about Settings Tray to Settings Tray
- Move block meta data #3582533: Move Settings Tray block metadata to Settings Tray module
- Themes #3586951: Remove Settings Tray integration in Default Admin, keep in Stable 9
- ~~Remove the extension from one or more profiles.~~
- Remove references to the extension from database dumps.
- Handle dependency on toolbar - Settings Tray should be deprecated and removed first because a contrib module can depend on the core Toolbar module.
✅ Do a thorough search of core for any remaining references to the extension. If references are found, outside of the extension, then create issues to remove the references.
✅ Create the contrib project with a stable release, before the alpha version of the major release. Follow the process in Create the contrib project with a stable release for creating the sub tree split.
✅ Deprecate the core extension. #3576669: Deprecate Settings Tray module.
✅ Create an issue, Ensure that Settings Tray does not get special core treatment
✅ Update the Deprecated and obsolete extensions

Comments

Comment #1

3 March 2026 at 03:48

quietone created an issue. See original summary.

Comment #2

quietone commented 3 March 2026 at 03:49

Parent issue:

» #3466088: [meta] Deprecate dependencies, libraries, modules, and themes that will be removed from Drupal 12 core

Comment #3

quietone commented 26 March 2026 at 21:57

Status:

Postponed

» Active

$ git grep -li "settings_tray" | grep -v core/modules/settings_tray
core/.phpstan-baseline.php
core/lib/Drupal/Core/Block/Plugin/Block/PageTitleBlock.php
core/modules/help/help_topics/core.ui_components.html.twig
core/modules/help/src/Plugin/Block/HelpBlock.php
core/modules/system/src/Form/SystemBrandingOffCanvasForm.php
core/modules/system/src/Plugin/Block/SystemBrandingBlock.php
core/modules/system/src/Plugin/Block/SystemMainBlock.php
core/modules/system/src/Plugin/Block/SystemMenuBlock.php
core/themes/default_admin/default_admin.libraries.yml
core/themes/stable9/stable9.info.yml

Comment #4

quietone commented 28 March 2026 at 09:57

Issue summary:

View changes

Comment #5

longwave

he/him

English

commented 31 March 2026 at 21:54

Added #3582533: Move Settings Tray block metadata to Settings Tray module

Comment #6

quietone commented 1 April 2026 at 08:35

Issue summary:

View changes

Comment #7

quietone commented 1 April 2026 at 08:42

Issue summary:

View changes

The remaining uses are in Stable 9 and Admin theme.

Comment #8

quietone commented 1 April 2026 at 22:50

core/themes/default_admin/default_admin.libraries.yml:    - default_admin/settings_tray
core/themes/default_admin/default_admin.libraries.yml:    - default_admin/settings_tray_edit
core/themes/default_admin/default_admin.libraries.yml:    - default_admin/settings_tray_edit
core/themes/default_admin/default_admin.libraries.yml:settings_tray:
core/themes/default_admin/default_admin.libraries.yml:      migration/css/components/settings_tray.css: { minified: false }
core/themes/default_admin/default_admin.libraries.yml:settings_tray_edit:
core/themes/default_admin/default_admin.libraries.yml:      migration/css/components/settings_tray_edit.css: { minified: false }
core/themes/stable9/stable9.info.yml:  settings_tray/drupal.settings_tray:
core/themes/stable9/stable9.info.yml:        css/settings_tray.module.css: css/settings_tray/settings_tray.module.css
core/themes/stable9/stable9.info.yml:        css/settings_tray.motion.css: css/settings_tray/settings_tray.motion.css
core/themes/stable9/stable9.info.yml:        css/settings_tray.toolbar.css: css/settings_tray/settings_tray.toolbar.css
core/themes/stable9/stable9.info.yml:        css/settings_tray.theme.css: css/settings_tray/settings_tray.theme.css

Comment #9

quietone commented 8 April 2026 at 10:50

Issue summary:

View changes

Comment #10

quietone commented 26 April 2026 at 11:11

Issue summary:

View changes

Comment #11

quietone commented 17 June 2026 at 10:16

Issue summary:	View changes
Issue tags:		+11.5.0 release priority

Comment #12

quietone commented 17 June 2026 at 10:22

Issue summary:

View changes

$ git grep -lwi "settings[_ ]tray" | grep -v core/modules/settings_tray/ | grep -v core/assets | grep -v phpstan-baseline | grep -v MAINTAINERS | nl
     1  core/themes/claro/css/base/elements.css
     2  core/themes/claro/css/base/elements.pcss.css
     3  core/themes/default_admin/css/base/elements.css
     4  core/themes/default_admin/css/base/elements.pcss.css
     5  core/themes/stable9/css/settings_tray/settings_tray.module.css
     6  core/themes/stable9/css/settings_tray/settings_tray.motion.css
     7  core/themes/stable9/css/settings_tray/settings_tray.theme.css
     8  core/themes/stable9/css/settings_tray/settings_tray.toolbar.css
     9  core/themes/stable9/stable9.info.yml