How to Assign Custom SharePoint Themes to a Light and Dark Mode Toggle
Question details
The user is looking to assign specific custom Light and Dark themes in SharePoint to a display mode toggle that users can control.

- Product
- Microsoft SharePoint
- Device & OS
- not provided
- Scenario
- Customizing a SharePoint intranet site to allow users to manually switch between branded light and dark interfaces using a toggle switch.
- Observed behavior
- SharePoint does not offer an out-of-the-box setting to link custom Light and Dark themes to a user-controlled toggle switch, requiring additional custom development.
Ensure you have SharePoint Administrator privileges to review site theme settings and the necessary permissions to deploy custom SharePoint Framework (SPFx) solutions if development is required.
Implement a Custom Toggle via SharePoint Framework (SPFx)
Since SharePoint lacks a native toggle for custom themes, the most robust workaround is to develop a custom SharePoint Framework application extension.
While SharePoint allows administrators to create custom themes using brand colors, it does not natively link these to a user-facing light/dark toggle switch. To achieve this functionality, developers often utilize the SharePoint Framework (SPFx) to inject a custom toggle into the site header or footer, which then dynamically alters the CSS properties on the page.
Navigate to the SharePoint site settings and click 'Change the look'. Verify the native theme options to confirm whether out-of-the-box settings can satisfy your basic branding requirements before committing to custom development.
Create an SPFx extension using React or plain JavaScript. Use the Top or Bottom placeholder in modern SharePoint pages to render your custom Light/Dark toggle switch.
Configure your custom toggle to switch a CSS class on the document body. This class should swap out predefined CSS variables mapped to your custom Light and Dark brand colors.
Package your SPFx solution and deploy it to your SharePoint Tenant App Catalog, ensuring you test the toggle behavior across different browsers and site pages.

Looking for a Simpler Way to Handle Documents with Dark Mode?
While SharePoint requires complex web development to implement custom Light and Dark themes, handling your daily documents doesn't have to be complicated. WPS Office provides a lightweight, highly compatible alternative to Microsoft Office that includes a built-in, easy-to-use Dark Mode for comfortable viewing.
- 1. Download the Installer: Visit the WPS Office website and download the free installation package for your operating system.
- 2. Install the Suite: Run the setup file and follow the on-screen prompts to complete the installation in minutes.
- 3. Toggle Dark Mode Instantly: Open any document and easily switch to Dark Mode from the View tab or interface settings for a comfortable reading experience.

Frequently Asked Questions
Does SharePoint natively support a dark mode toggle for end-users?
No. While the SharePoint mobile app respects the device's system-level dark mode settings, the web version of SharePoint does not provide an out-of-the-box toggle switch for users to manually switch between custom Light and Dark site themes.
How can I apply custom themes to my SharePoint site?
Administrators can generate custom themes using the Microsoft Theme Generator to define specific primary, text, and background colors. These themes are then uploaded via SharePoint Online Management Shell (PowerShell) and applied using the 'Change the look' menu.
Can users change the site theme themselves?
Only users with Site Owner or Administrator permissions can change the global theme of a SharePoint site. Standard end-users cannot change the theme unless a custom, developed solution (like an SPFx toggle) is provided to dynamically alter their local view.
Where can I get specialized help for SharePoint development?
For advanced customizations, including SPFx extensions and custom theme toggles, the best resource is the Microsoft Q&A SharePoint community, where Microsoft engineers and experienced developers share guidance and code snippets.




