CSS color-scheme Property
Indicates the color schemes the element can be rendered in
Syntax
color-scheme: normal | light | dark | light dark;Values
| Value | Description |
|---|---|
| normal | No preference (default) |
| light | Light color scheme |
| dark | Dark color scheme |
| light dark | Supports both, prefer first listed |
Example
:root {
color-scheme: dark;
}Understanding CSS color-scheme
The CSS color-scheme property indicates the color schemes the element can be rendered in. As part of the Misc module in CSS, it is one of the most commonly used properties for controlling the visual presentation of web pages.
You can set color-scheme to values such as normal, light, dark, light dark, among others. Each value changes how the browser renders the affected element, giving you fine-grained control over your page layout and design. Choosing the right value depends on the specific design requirements of your project.
Common use cases for the color-scheme property include responsive web design, component-based layouts, and creating visually consistent interfaces across devices. It works closely with related properties like accent-color, color, background-color to achieve complex styling effects. Understanding how these properties interact helps you write cleaner, more maintainable stylesheets.
Browser support for color-scheme is excellent across all modern browsers including Chrome, Firefox, Safari, and Edge. For older browsers, consider using fallback values or progressive enhancement strategies. The property can also be set dynamically via JavaScript using element.style.colorScheme or the CSS custom properties (variables) approach for theming.
Related Properties
accent-colorSets the accent color for form controls like checkboxes, radio buttons, and range sliders
colorSets the foreground color of an element's text and text decorations
background-colorSets the background color of an element
forced-color-adjustAllows opting out of forced colors mode imposed by the user agent
Explore More CSS Properties
Browse our complete reference of 251 CSS properties with syntax, examples, and tips.