Problem/Motivation

It would be better to default to "Auto" instead of "Light" for the Light/Dark mode setting for the Admin Theme.

Notes

  • Discussed during the Accessibility Office Hours on June 18, 2026.
  • Setting the best defaults is extremely important since often people do not change them.
  • Honoring system and browser defaults helps people who need a certain setting (like dark mode) not have to first use an inaccessible or less comfortable setting (like light mode for some) in order to update to their preferred setting.

Steps to reproduce

  • Go to the Admin Theme's Settings
  • Default isn't "Auto".

Proposed resolution

  • Set the default to "Auto".
  • Make "Auto" the first option in the list.

Remaining tasks

User interface changes

Toggle starts on Auto.

Introduced terminology

API changes

Data model changes

Release notes snippet

Issue fork drupal-3604071

Command icon Show commands

Start within a Git clone of the project using the version control instructions.

Or, if you do not have SSH keys set up on git.drupalcode.org:

Comments

jmstair created an issue. See original summary.

mherchel’s picture

+1 on this!

mgifford’s picture

This is great @jmstair thanks for setting up this issue.

This is absolutely a best practice and one we should be leading with.

mgifford’s picture

Issue summary: View changes
kentr’s picture

+1!

mherchel’s picture

I feel when we do this, we should make "Auto" the first option in the list.

bernardm28 made their first commit to this issue’s fork.

bernardm28’s picture

Status: Active » Needs review

It should be good to go. Switch the default config to load auto and the order of the buttons.

kentr’s picture

Issue summary: View changes

I added the bit about making "Auto" the first option to the proposed resolution.

jurgenhaas’s picture

Status: Needs review » Reviewed & tested by the community

I've reviewed the code and tested it on a fresh installation. Works as described.

kentr’s picture

@jurgenhaas I saw that you assigned #3606655: Make dark mode a first class citizen of Drupal core to yourself. Does that mean that you're working on it? Should this issue wait on that one?

jurgenhaas’s picture

@kentr yes I'm working on the other one. And actually, it would be better if this one could be merged before as my other work could then sit in top of it.

jurgenhaas’s picture

Turns out that the implementation over at #3606655 makes this issue and its MR redundant, as the settings being adjusted here will disappear entirely. So, when the other one lands, this one should be closed as won't fix.

  • longwave committed 2092b419 on 11.x
    task: #3604071 Change default to auto for light/dark mode
    
    By: jmstair...

  • longwave committed 73524b05 on main
    task: #3604071 Change default to auto for light/dark mode
    
    By: jmstair...
longwave’s picture

Version: main » 11.x-dev
Status: Reviewed & tested by the community » Fixed

Let's land this anyway as an accessibility improvement as it's ready, and it's not clear if the other issue will land before 11.5/12.0.

Committed and pushed 73524b05a7f to main and 2092b4196a0 to 11.x. Thanks!

Now that this issue is closed, review the contribution record.

As a contributor, attribute any organization that helped you, or if you volunteered your own time.

Maintainers, credit people who helped resolve this issue.

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.