Overview
The dark theme variant is available with the out-of-the-box Polaris theme that is available with the Next Experience UI. Users can toggle between light and dark variants in their user preferences and will see the dark version of a page depending on which family release your instance is on.
Features
We introduced dark theme in San Diego and have made improvements to it through the Utah release for Next Experience UI. Please see the family release below to understand where dark theme will be applied.
San Diego
Dark theme is only available on Next Experience pages such as the out-of-the-box landing page or configurable workspaces. Dark theme is not enabled by default on San Diego, administrators can enable it with the glide.ui.polaris.dark_themes_enabled system property.
Tokyo
Dark theme is available on Next Experience pages such as the out-of-the-box landing page or configurable workspaces as well as Classic Environment lists and forms.
Dark theme is not enabled by default on Tokyo, administrators can enable it with the glide.ui.polaris.dark_themes_enabled system property. In order to use Dark theme on Classic Environment lists and forms, set the glide.ui.polaris.core_ui_exclude_dark_mode system property to false.
Utah
Dark theme is available on Next Experience pages such as the out-of-the-box landing page or configurable workspaces, Classic Environment lists, forms, dashboards, and reports.
Here's a quick list of where dark theme in Utah is supported:
- Lists and Forms
- Dashboards, Dashboard Overview, Dashboard widgets, and Analytics Hub
- Report Designer/Builder, all Reports, and Performance Analytics widgets
- Knowledge articles, Service Catalog, Virtual Agent Client, and the Visual Task Board landing page
Dark theme is not enabled by default on Utah, administrators can enable it with the glide.ui.polaris.dark_themes_enabled system property. In order to use Dark theme on Classic Environment lists and forms, set the glide.ui.polaris.core_ui_exclude_dark_mode system property to false.
Note: Some custom pages do not inherit the dark theme, which may create visual inconsistencies in the classic environment. This is an expected behavior and it is the admins' responsibility to exclude the dark theme from their classic environment if the inconsistencies are unacceptable for company use.
FAQs
Q: Can I use dark mode with a custom theme I've created with UI Builder?
A: Right now, we're only supporting using dark theme when using the Polaris theme. You can associate the dark variant to a custom theme you've created with Theme Builder or manually, but you'll notice that colors such as menus, etc. will still use the Polaris colors. You can also attempt to create your own dark variant and associate it to a custom theme.
As of Utah our product and support teams will not support dark theme issues and/or questions outside of the out-of-the-box dark theme variant paired with the Polaris theme.
Q: When will dark theme be available on custom themes created with Theme Builder?
A: This is on the roadmap, and we'll discuss a Store release date once we know more information.
Q: I'm using the Polaris theme, but dark theme isn't available to select, how can I use it?
A: Make sure the following system property is set to true: glide.ui.polaris.dark_themes_enabled
Q: I'm on Tokyo/Utah and using the Polaris theme, when I select dark mode Classic Environment forms and lists are still using light theme.
A: There's a separate system property to enable dark theme on Classic Environment forms and lists. We recommend testing dark theme with users prior to activating to ensure there are no issues. When ready, you can set the glide.ui.polaris.core_ui_exclude_dark_mode system property to false and this will allow dark theme to be used on Classic Environment as well as Workspaces.
