Preparing your community for behind-the-scenes header changes

Discourse is now shipping with a more modern implementation of the header, including more flexible and robust customization APIs. The new version has already been automatically enabled for sites with compatible themes & plugins.

For incompatible sites, a banner is being shown to admins warning them to take action before the old header implementation is removed. If you see this banner, follow the linked instructions to update your customizations. If you don’t see the banner, then your site is ready, and you don’t need to do anything.

Warning banners have been shown to admins since 20th June (v3.3.0.beta3).

From the week commencing 5th August (v3.4.0.beta1), we will enable the new header by default for all sites, even if they have incompatible customizations. It will still be possible for admins to switch back to the old header by manually setting the “glimmer header mode” site setting to “disabled”.

From the week commencing 2nd September, the option to use the old header will be removed entirely.

If you need help getting your site ready, please post in the instructions topic or speak to your hosting provider.

15 Likes

glimmer header mode site setting is missing on 3.4.0.beta2-dev 0923f5e3a7 , any idea why it happen? is it because I upgrade from an rather old version of discourse?

1 Like

Looks like the option to disable it has been removed entirely by this point.

Meaning that you have it enabled right now, and you can’t back out of it.

2 Likes

I see, I remember read somewhere said the setting will be set to auto after some time point but I couldn’t find it…

1 Like

It is in the instructions topic linked in the OP

2 Likes

under the setting it said: ‘auto’ will be enabled automatically after all themes and plugins are ready. Preparing your community for behind-the-scenes header changes

from:

my component theme (Group specific tool bar) is working when I set the option to auto, but it’s not working after updating, but shouldn’t it still work if it will be set to ‘auto’ ?

1 Like

The ‘glimmer header mode’ setting has been removed in the latest version of Discourse, and the new implementation is used on all sites.

So you’ll need to follow the upgrade instructions to make your theme compatible with the change.

3 Likes