# Dark mode

> The mode of the community's theme (Light, Dark or Automatic, which follows the device), the dark ready-made themes, the logo for dark backgrounds, each person's choice in My Account › Appearance, and what stays light.

The community can show a light background, a dark background, or follow each person's device theme. The choice applies to the whole app, **Administration** included.

## What it is for

For people who spend hours in the community at night, for a brand that is already dark (a music studio, a gaming community), or simply to respect what each person picked on their phone and computer.

## How it works

### The community mode

The mode is part of the community's [theme](/configuracoes/cores): in **Settings › Brand and appearance › Theme**, in the theme editor, **Colors** tab, **Mode** field:

| Mode | What it does |
|---|---|
| **Light** (default) | *"Light background, as always."* |
| **Dark** | *"Dark background on every screen."* |
| **Automatic** | *"Follows each person's device theme."* If the person switches the device theme, the community switches too, without reloading |

The mode changes the community when the theme is **activated** (or when you save the theme that is already active). In the editor, the **Colors of which mode** selector shows the **Dark** colors: they are generated from the light ones, and **Adjust the dark shades** unlocks shade-by-shade adjustment. The **Dark** and **Premium dark** ready-made themes already come in dark mode.

### Enabled by Memberfy

The dark theme is enabled by Memberfy, community by community. Without it, the gallery hides the dark ready-made themes and the editor's **Mode** field leaves only **Light**, with the notice *"The dark theme is not enabled for this community yet. To use it, contact Memberfy support."*

If it is turned off while a dark theme is active, the community goes back to light for everyone; the theme stays saved and applies again when the dark theme is enabled again.

### Logo for dark backgrounds

With the theme enabled, **Settings › Brand and appearance › Images** shows, next to the logo, the **Logo for dark backgrounds**. It belongs to the brand: it doesn't change when you switch themes. It is used instead of the logo when the screen is in the dark theme. Without it, the regular logo sits on a light plate so it stays readable. Best is a **PNG with a transparent background** (JPG and WebP also work). **Upload logo** uploads, **Replace logo** swaps it, and the trash can (**Remove the logo for dark backgrounds**) goes back to the regular logo on the plate. Uploading the dark logo never changes the regular logo (see [Images and SEO](/configuracoes/imagens-e-seo)).

### What stays light

**E-mails**, **certificates** and the **recognition art** stay light in every mode: they are made to be printed, downloaded or opened elsewhere, where the community's background does not apply.

### Each person's choice

With the theme enabled, each person's **My Account › Appearance** section shows the **Theme** field:

| Option | What it does |
|---|---|
| **Follow the community** (default) | The mode the community picked (*"Now: light."*, *"Now: automatic, by device."*) |
| **Light** | *"Always a light background."* |
| **Dark** | *"Always a dark background."* |
| **Device** | *"Light or dark, as your device is set."* |

The choice *"Applies only to this browser and this community."*: it is not sent to the server, so in another browser, on another device or in another community the person sees the community's mode again. Without the dark theme enabled, the **Theme** field does not show.

### Who can

The community's theme and the logo for dark backgrounds: **owner** and **admin**. The choice in **My Account › Appearance**: anyone, for themselves.

## Step by step

*Role: owner or admin.*

1. **Settings › Brand and appearance**, **Theme** card.
2. Use a dark ready-made theme (**Use this theme**), or **Edit** your theme and, in the **Colors** tab, under **Mode**, click **Dark** or **Automatic** and **Save Changes**. If only **Light** shows, contact Memberfy support to enable the dark theme.
3. **Activate** the theme and confirm.
4. In **Images**, **Logo for dark backgrounds**, **Upload logo** and pick a PNG with a transparent background.
5. Open the community on a phone in the dark theme and check the header and the buttons.

*For yourself:* **My Account › Appearance** and pick **Light**, **Dark**, **Device** or **Follow the community**.

## Examples

**Gaming community.** Ready-made theme **Premium dark**, with the white logo as a transparent PNG for the **Logo for dark backgrounds**. Anyone who prefers reading on light picks **Light** in **My Account › Appearance**.

**School with a mixed audience.** Mode **Automatic**: whoever uses their phone in the dark theme sees the school dark; whoever uses light sees it light. Certificates still come out light.

## Tips

- Pick **Automatic** if you are unsure: each person sees it the way they already use their device.
- The logo for dark backgrounds is usually the white or light version of the brand.
- After turning it on, check the community colors in the dark: a very dark primary shade can lose contrast with the background.

## Common errors and how to fix them

| Situation | What to do |
|---|---|
| Only **Light** shows in **Mode**, and the gallery has no dark themes | The dark theme is not enabled for the community yet: contact Memberfy support |
| The logo sits on a light plate in the dark theme | Upload the **Logo for dark backgrounds** |
| I picked **Dark** in **My Account › Appearance** and it is light on my other computer | The choice applies only to that browser: pick it again on the other one |
| I cannot find the **Theme** field in **My Account › Appearance** | The field only shows when the community has the dark theme enabled |

## FAQ

**Do the e-mails the community sends turn dark?**
No. E-mails, certificates and the recognition art stay light.

**Does Administration turn dark too?**
Yes. The mode applies to the whole app.

**Is the dark theme lost if it is turned off?**
No. The community shows light while it is off, and the theme stays saved.

**Can the assistant (MCP) change the mode?**
Yes, through the theme, for the owner and the admin; activating asks for confirmation. See [Through the assistant (MCP)](#through-the-assistant-mcp).

## In the API

- Community reads carry `appearance`: `mode` (the active theme's mode: `light`, `dark` or `auto`), `effectiveMode` (what applies now: `light` while the dark theme is not enabled), `darkLogoUrl`, `darkModeAllowed` and `activeThemeId`.
- The mode is written to the theme: `values.mode` in `/api/community-themes` (see [Theme and colors](/configuracoes/cores#in-the-api)). A dark or automatic theme without the dark theme enabled answers `422`. `mode` in `PATCH /api/communities/appearance` answers `400` (see [Responses and errors](/api/respostas-e-erros#appearance-and-themes)).
- [`PATCH /api/communities/appearance`](/api/referencia/communities/update-community-appearance) (owner and admin) keeps `darkLogoUrl` (`null` removes it); sending the same state again answers `changed: false`. The change goes to the [Logs](/membros/registros-de-atividades).
- [`POST /api/upload/community/logo`](/api/referencia/uploads/post-upload-community-logo) with `variant=dark` uploads the dark logo file and returns only `data.url`, without replacing the regular logo; then save the URL with the `PATCH` above.

## Through the assistant (MCP)

- *"Put the community on the automatic theme"*: the assistant changes the active theme's `mode` with [`update_community_theme`](/mcp/ferramentas-comunidade#themes), or activates a dark theme with `activate_community_theme` (asks for confirmation). Owner and admin.
- *"Use this logo for dark backgrounds"*: [`update_community_appearance`](/mcp/ferramentas-comunidade#update-community-appearance), which now only handles the logo for dark backgrounds, always with confirmation.
- [`get_community_settings`](/mcp/ferramentas-comunidade#get-community-settings) shows the current theme and whether dark is enabled.

## Related

- [Theme and colors](/configuracoes/cores)
- [Side menu](/configuracoes/menu-lateral)
- [Images and SEO](/configuracoes/imagens-e-seo)
- [Account and profile](/conceitos/conta-e-perfil)