> For the complete documentation index, see [llms.txt](https://doc.orbeon.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.orbeon.com/form-runner/features/dark-mode.md).

# Dark mode

## Availability

* [\[SINCE Orbeon Forms 2025.1\]](https://doc.orbeon.com/release-notes/orbeon-forms-2025.1.md) Dark color scheme support and initial configuration properties.
* [\[SINCE Orbeon Forms 2026.1\]](https://github.com/orbeon/orbeon-forms-doc/tree/master/release-notes/orbeon-forms-2026.1.md) Navigation bar color scheme selector, runtime selection via URL parameter, cookie, and session. Form Builder support.

## Overview

Orbeon Forms provides dark mode support across Form Runner and Form Builder. When enabled, a modern, high-contrast dark theme is applied to form views and administrative pages, making forms more comfortable to view in low-light environments and aligning with system-wide dark mode preferences.

Dark mode is available for the following pages:

* **Detail page**: Form view, edit, and new modes
* **Summary page**: Form data summary table
* **Landing page**: Application landing page
* **Published Forms page**: Listing of published forms
* **Forms Admin page**: Form management and admin operations
* **Form Builder**: Form editor, including its dialogs and toolbox \[SINCE Orbeon Forms 2026.1]

![Detail page in dark mode](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-86bb52bdb2d38c19e719862a209ccdfa5ea3a526%2Fdark-mode-detail.webp?alt=media)

![Landing page in dark mode](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-da14096fc46c3d079a24e84b99191481b0eb2c32%2Fdark-mode-landing.webp?alt=media)

![Summary page in dark mode](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-676ce7e1fab1a98ffd00c6b4810a7286490934e3%2Fdark-mode-summary.webp?alt=media)

## Navigation bar color scheme selector

[\[SINCE Orbeon Forms 2026.1\]](https://github.com/orbeon/orbeon-forms-doc/tree/master/release-notes/orbeon-forms-2026.1.md)

### User interface

Form Runner includes a color scheme selector in the top [navigation bar](https://doc.orbeon.com/form-runner/features/navbar.md) next to the language selector:

* The selector dropdown displays an icon matching the active mode:
  * Sun icon: Light mode
  * Moon icon: Dark mode
  * Half-circle icon: Auto (system preference)
* The dropdown menu allows users to switch between three options:
  * **Light**: Forces the light color scheme.
  * **Dark**: Forces the dark color scheme.
  * **Auto**: Automatically follows the user's operating system or browser preference (`prefers-color-scheme`).

Selecting an option switches the color scheme dynamically without reloading the page.

### Persistence

When a user selects a color scheme from the navigation bar, their choice is saved to a cookie named `orbeon-color-scheme`.

This preference is remembered across page navigations, form submissions, and subsequent visits.

### Configuration

The navigation bar color scheme selector is enabled by default for all Form Runner forms:

```xml
<property
    as="xs:boolean"
    name="oxf.fr.navbar.color-scheme-selector.enable.*.*"
    value="true"/>
```

You can disable the selector globally or per application/form by setting the property to `false`:

```xml
<property
    as="xs:boolean"
    name="oxf.fr.navbar.color-scheme-selector.enable.*.*"
    value="false"/>
```

The selector also appears in the Form Builder navigation bar. To hide it there only, set the property for the `orbeon`/`builder` application and form names:

```xml
<property
    as="xs:boolean"
    name="oxf.fr.navbar.color-scheme-selector.enable.orbeon.builder"
    value="false"/>
```

The selector is automatically hidden in the following situations:

* When running in `test` mode (`fr:mode() = 'test'`)
* When the form is [embedded](https://doc.orbeon.com/form-runner/link-embed.md) into another page or application (`fr:is-embedded()`)

## Color scheme determination at runtime

[\[SINCE Orbeon Forms 2026.1\]](https://github.com/orbeon/orbeon-forms-doc/tree/master/release-notes/orbeon-forms-2026.1.md)

When Form Runner renders a page, the effective color scheme (`light`, `dark`, or `system`) is determined according to the following order of precedence:

1. **URL parameter**: If the `fr-color-scheme` query parameter is present in the request URL (e.g. `?fr-color-scheme=dark` or `?fr-color-scheme=system`), its value is used. This allows external applications or portal links to explicitly request a specific scheme.
2. **Cookie**: If the `orbeon-color-scheme` cookie is present (such as when set by the navigation bar selector), its value is used.
3. **Session attribute**: If the `fr-color-scheme` attribute is set on the HTTP servlet session, its value is used.
4. **Configuration properties**: If none of the above are set, the value of the `oxf.fr.style.color-scheme` property is used (see below).
5. **Default**: If no property is configured, Form Runner defaults to `light`.

## Configuration properties

### Default color scheme

[\[SINCE Orbeon Forms 2025.1\]](https://doc.orbeon.com/release-notes/orbeon-forms-2025.1.md)

You can set the default color scheme used when no user selection, cookie, or URL parameter is present.

Supported values:

* `light` (default): Light color scheme.
* `dark`: Dark color scheme.
* `system`: Automatically selects between light and dark schemes based on the user's browser or operating system preference.

For Form Runner Detail pages, configure `oxf.fr.style.color-scheme.*.*`:

```xml
<property
    as="xs:string"
    name="oxf.fr.style.color-scheme.*.*"
    value="system"/>
```

You can customize this per application and form name using the standard property wildcards (e.g., `oxf.fr.style.color-scheme.acme.order`).

For other pages (Summary, Landing, Published Forms, and Forms Admin pages), use the property without wildcards:

```xml
<property
    as="xs:string"
    name="oxf.fr.style.color-scheme"
    value="system"/>
```

### Navigation bar selector enable

[\[SINCE Orbeon Forms 2026.1\]](https://github.com/orbeon/orbeon-forms-doc/tree/master/release-notes/orbeon-forms-2026.1.md)

Controls whether the color scheme selector appears in the navigation bar.

```xml
<property
    as="xs:boolean"
    name="oxf.fr.navbar.color-scheme-selector.enable.*.*"
    value="true"/>
```

## See also

* [Form Runner navigation bar](https://doc.orbeon.com/form-runner/features/navbar.md)
* [Color scheme property](https://doc.orbeon.com/configuration/properties/form-runner/form-runner-detail-page.md#color-scheme)
* [CSS customization and CSS variables](https://doc.orbeon.com/form-runner/styling/css.md#overriding-css-variables)
* [Release notes for Orbeon Forms 2025.1](https://doc.orbeon.com/release-notes/orbeon-forms-2025.1.md)
* [Release notes for Orbeon Forms 2026.1](https://github.com/orbeon/orbeon-forms-doc/tree/master/release-notes/orbeon-forms-2026.1.md)
* Blog post: [User interface dark mode](https://www.orbeon.com/2026/05/dark-mode)
