How do I change the theme in Notesnook?
Notesnook keeps two themes at once — one for light mode and one for dark mode — and switches between them based on your color scheme. You can pick both from the built-in theme store, or load a theme from a theme.json file.
Switch between light and dark
- Go to
Settings. - Open
Customization→Appearance. - Under
Themes, setColor schemetoLight,DarkorAuto.
Auto follows your operating system, so Notesnook flips with it.
Faster switching on desktop
The side menu profile menu has a Toggle dark/light mode item, so you don't have to open settings.
Install a theme from the theme store
Every theme in the store is fetched from themes-api.notesnook.com and installed on your device. The list only shows themes that are compatible with the version of Notesnook you're running.
- Go to
Settings→Customization→Appearance. - Scroll to
Select a theme. - Type in the
Search themesbox to search, or use theAll,DarkandLightfilters to narrow the list. - Click a theme to see its details, then confirm — or hover it and click
Set as dark theme/Set as light themedirectly.
A checkmark marks the themes you currently have applied.
Set separate light and dark themes
There is no separate "which theme goes where" setting — a theme's own color scheme decides it. Applying a dark theme replaces your dark theme; applying a light theme replaces your light theme. Your Color scheme setting then decides which of the two you see.
So to have both: install a light theme, install a dark theme, and set Color scheme to Auto (or Use system theme on mobile).
Load a theme from a file
If you have a theme.json file — one you built with the Theme Builder, or one that isn't published yet — you can apply it directly.
- Open the theme list as above.
- Click or tap
Load from file. - Pick the
.jsonfile. Notesnook validates it and shows the theme's details. - Confirm to apply it.
If the file is missing required fields or isn't a valid theme, the app tells you instead of applying it. Full steps and caveats are on install a theme from file.
Where do the themes come from?
The theme store is an open collection. Themes are submitted as JSON files to the notesnook-themes repository, and once merged they appear in the store for everyone. If you have made a theme you like, you can publish it the same way.
Related pages
- Publish a theme — get your theme into the store
- Create a theme with the Theme Builder — build one without writing JSON
- Install a theme from file — apply a
theme.jsondirectly - Theme engine introduction — how scopes, variants and colors fit together
- Customizing the app — home screen, side menu and list density
