Dark mode

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: in Settings › Brand and appearance › Theme, in the theme editor, Colors tab, Mode field:

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).

#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:

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

#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).

#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). A dark or automatic theme without the dark theme enabled answers 422. mode in PATCH /api/communities/appearance answers 400 (see Responses and errors).
• PATCH /api/communities/appearance (owner and admin) keeps darkLogoUrl (null removes it); sending the same state again answers changed: false. The change goes to the Logs.
• POST /api/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, or activates a dark theme with activate_community_theme (asks for confirmation). Owner and admin.
• "Use this logo for dark backgrounds": update_community_appearance, which now only handles the logo for dark backgrounds, always with confirmation.
• get_community_settings shows the current theme and whether dark is enabled.

#Related

• Theme and colors
• Side menu
• Images and SEO
• Account and profile