# Relay: Light, dark, and auto theme

> Set the Relay theme to light, dark, or auto. Auto follows the device setting and is the default; it is set in your integration, not the Dashboard.

Source: https://help.withpersona.com/articles/C9zRnkipOjmKNO1PL4DnR0/
Section: Relay > Features > Configurations

## Choosing a theme

The [Relay](https://help.withpersona.com/articles/FTAuKBlqXIUaKHv654ng26/) verification experience can render in a light theme, a dark theme, or follow whatever the user's own device is set to. There are three options:

| Theme     | What it does                                                                                                  |
| --------- | ------------------------------------------------------------------------------------------------------------- |
| **auto**  | Follows the browser's color scheme preference, which usually mirrors the device setting. This is the default. |
| **light** | Always renders the light theme, whatever the device prefers.                                                  |
| **dark**  | Always renders the dark theme, whatever the device prefers.                                                   |

## Which one should you pick?

**Leave it on auto** if your own product already follows the device preference. The verification step will match whatever the rest of your interface is doing, and a user who runs their phone in dark mode will not get a bright flash partway through your flow.

**Set it explicitly** if your product is always light or always dark regardless of the device. Locking the theme keeps the verification consistent with your interface rather than with the operating system.

💡

Auto follows the device, not your site. If your site is dark by default but the user's device
is set to light, auto renders the light theme. Set the theme explicitly if you need it to match
your interface.

## Where it is set

The theme is set by your integration when it starts the verification, not in the Persona Dashboard.

- With the [Embedded Widget](https://help.withpersona.com/articles/KdzrTAbJUJCMKwhmPy3WeD/), it is one of the options you pass when you create the widget.
- With [Hosted Flow](https://help.withpersona.com/articles/CMPajCawApr2f359BF9lUb/), it is a query parameter on the hosted URL.

For native apps, theming is not currently documented for the iOS and Android SDKs. See [Relay: iOS and Android](https://help.withpersona.com/articles/wXsJwROMPcovoF1BZXlD9T/).

## Full technical documentation

The developer documentation is the source of truth for the option itself:

- [Relay Widget SDK reference](https://docs.withpersona.com/relay-sdk-reference)
- [Hosted Flow](https://docs.withpersona.com/relay-hosted-flow)

## Plans Explained

### Relay theme by plan

|             | **Startup Program** | **Essential Plan** | **Growth Plan** | **Enterprise Plan** |
| ----------- | ------------------- | ------------------ | --------------- | ------------------- |
| Relay theme | Available           | Available          | Available       | Available           |

[Learn more about pricing and plans](https://withpersona.com/pricing?utm_source=product&utm_medium=referral&utm_audience=a&utm_campaign=cm_gen_ds_hc-plan-table).