The best Obsidian theme is one that is in the official community catalog, still being maintained, and comfortable to read for hours — not whichever name has the highest lifetime download count. A theme in Obsidian is a CSS package that changes colors, typography, and chrome. It is not a vault template and it does not organize notes. This guide covers how to install, update, and uninstall community themes from inside Obsidian, how that differs from a CSS snippet, and a shortlist of catalog themes whose licenses, last GitHub commits, and official download counts were checked on 17 November 2026.
How this was checked: WOWHOW fetched Obsidian's Themes help, Appearance help, CSS snippets help, and Community directory help; the official catalog file community-css-themes.json in obsidianmd/obsidian-releases; the official download counts at releases.obsidian.md/stats/theme; the developer pages for theme guidelines and submitting a theme; and each shortlisted theme's GitHub repository (license, latest commit, latest release when one exists, and README). Download figures below are those official counts, fetched 17 November 2026. They are cumulative totals, not unique users, and they do not by themselves mean a theme is current.
TL;DR
Install or switch themes in Settings → Appearance → Themes → Manage, then Install and use. The same screen uninstalls a theme. Official help: Themes.
Themes do not update automatically. Use Settings → Appearance → Current community themes → Check for updates, or check one theme at a time under Manage.
On 17 November 2026 the official catalog listed 1,037 community themes, including 15 marked
legacy. Browse them in the app or at community.obsidian.md.A high download count can belong to a theme whose GitHub repo has not been committed to in a year or more. Prefer a recent commit, a license on the listing, and a healthy scorecard over raw totals.
For a small change such as heading colors, a CSS snippet is enough. A full theme is for a consistent look across the app.
A vault starter kit is a different decision. See Best Obsidian Templates 2026 for structure; this page is only about appearance.
How to install, update, and remove an Obsidian theme
Obsidian's Appearance help describes two built-in color schemes, light and dark. By default the scheme follows the operating system. Community themes sit on top of that choice. The official Themes page is the source for the steps below.
Browse and install
Open Settings.
Under Appearance → Themes, select Manage to list community themes. The same catalog is also on the web at community.obsidian.md.
Select a theme, then select Install and use. Obsidian installs it and applies it immediately.
To go back to the default look, select Stop using this theme.
Update (this is manual)
The help page is explicit: themes do not update automatically. That matters on a new Obsidian release, when a stale theme can break layout or typography.
To update every installed community theme:
Open Settings.
Under Appearance → Current community themes, select Check for updates.
If updates are available, select Update all.
To update one theme, open Manage, select that theme, choose Check for updates, then Update if one is offered.
Uninstall
Open Settings → Appearance → Themes → Manage.
Select the theme, then select Uninstall.
A theme's public listing on the community directory shows the author, total downloads, screenshots, a README excerpt, license, last update, and a Scorecard. The Scorecard breaks health into hygiene (README, license, contributing guide), maintenance (recent commits and releases), responsiveness, and adoption (installation and star counts), plus an automated review of the latest release. Official help treats a lower score as a prompt to read the disclosures, not as proof that an entry is unsafe.
Themes vs CSS snippets
A community theme replaces the app's look as a whole. A CSS snippet changes one part of the interface, such as heading colors, without installing a theme. Official help says Obsidian looks for snippets in the vault's configuration folder, under a snippets directory.
On desktop, the documented path is Settings → Appearance → CSS snippets → Open snippets folder, add a .css file, Reload snippets, then enable it with the toggle. Once enabled, Obsidian applies saved changes without a restart. Official help also documents a cssclasses note property that can apply a class to a single note, for example to style images only in that note.
Developer theme guidelines say community themes must not load remote fonts or images that disappear offline, and must not make network calls; assets have to be bundled. That is a reason to prefer catalog themes over a random CSS file copied from a forum thread. The same guidelines ask theme authors to avoid !important, because it blocks users from overriding styles with snippets. If only a font size or a heading color needs to change, start with a snippet on top of the default theme or a simple catalog theme, rather than a large, heavily customized one.
How to choose a theme (without chasing download totals)
Use the official listing plus the GitHub repo, in this order:
Light, dark, or both. The catalog records supported modes for every theme. A dark-only theme will not give a light workspace. Appearance still has a base color scheme setting, and some palettes (for example Catppuccin Latte vs Mocha) depend on that setting, as that theme's README describes.
License. Official submit instructions require a
LICENSEin the repository root. The listing sidebar shows the license. This guide only features themes whose GitHub license metadata was present on 17 November 2026.Last update vs downloads. Official download counts at releases.obsidian.md/stats/theme are useful for popularity, but they accumulate over years. A theme can sit high on that list after the author has stopped shipping releases. The directory Scorecard's maintenance slice, and the date of the latest commit on GitHub, are the better "is this current?" checks.
Compatible app version. Listings show a compatible Obsidian version. Several themes in the shortlist declare a
minAppVersioninmanifest.json(Minimal and Baseline both declare 1.14.0 at HEAD). If a vault is on an older desktop build, check that field before installing.Style Settings, or not. Many themes expose extra palettes or layout toggles through the official Style Settings community plugin (catalog id
obsidian-style-settings, repositoryobsidian-community/obsidian-style-settingsin community-plugins.json on 17 November 2026). That plugin is optional unless a README says a feature is only available with it. Cupertino's README instead emphasizes that the theme is complete without plugins.
Maintained community themes to start with
The table is not a ranked awards list. It is a starting shortlist of official catalog themes that still had 2026 GitHub commits on the check date, a license on GitHub, and a clear README description. Official lifetime download counts are included so popularity is visible, not so the highest number wins. Times below are in IST (UTC+5:30), converted from GitHub timestamps.
| Theme | Modes | License | Official downloads | Latest GitHub commit | Version at check | Best starting point if |
|---|
| Minimal | Dark, light | MIT | 2,770,843 | 12 Nov 2026, 21:43 IST | 9.1.4 (release 7 Oct 2026, 03:37 IST) | A customizable, distraction-free default is the goal |
| Things | Light, dark | MIT | 1,388,992 | 1 Nov 2026, 23:47 IST | 2.2.6 (release 1 Nov 2026, 23:49 IST) | A Cultured Code Things-inspired palette is the goal |
| Blue Topaz | Dark, light | MIT | 1,068,293 | 6 Nov 2026, 07:47 IST | Release tag 2026110301 (3 Nov 2026, 05:57 IST) | A long-running, Style Settings-heavy theme with an example vault is useful |
| Wasp | Dark, light | MIT | 519,374 | 28 Sep 2026, 21:56 IST | 1.0.9 (release 28 Sep 2026, 21:57 IST) | Yellow or amber accents on dark or cream backgrounds are preferred |
| Typewriter | Dark, light | GPL-3.0 | 470,591 | 31 Oct 2026, 17:52 IST | 2.3.4 (release 31 Oct 2026, 17:53 IST) | Focused writing typography matters more than a dense UI |
| ITS Theme | Dark, light | GPL-2.0 | 456,076 | 17 Nov 2026, 06:49 IST | manifest.json at HEAD reports 1.4.30 (no GitHub Releases entry was returned) | Callouts, image controls, and alternate checkboxes should ship with the theme |
| Catppuccin | Dark, light | MIT | 361,955 | 5 Nov 2026, 04:35 IST | 0.4.52 (release 5 Nov 2026, 04:31 IST) | The Catppuccin Latte, Frappé, Macchiato, or Mocha palettes are already familiar |
| Border | Dark, light | MIT | 324,827 | 31 Oct 2026, 00:37 IST | 1.13.9 (release 31 Oct 2026, 00:38 IST) | A clean, highly customizable layout with optional card UI is the goal |
| Cupertino | Dark, light | MIT | 189,406 | 11 Nov 2026, 19:01 IST | 4.1.1 (release 11 Nov 2026, 19:12 IST) | A native, mobile-friendly look with few extra plugins is the goal |
| Dracula Official | Dark only | MIT | 135,003 | 1 Nov 2026, 13:39 IST | 1.1.8 (release 1 Nov 2026, 14:32 IST) | The official Dracula palette is required, and light mode is not |
Three other catalog themes also had 2026 commits, MIT licenses, and clear READMEs, and are easy next stops after the table: Tokyo Night (321,028 downloads; last commit 31 Oct 2026, 02:15 IST; release 1.1.8), whose README maps Night and Light to Obsidian's base scheme and Storm and Moon to Style Settings imports; Baseline (123,695 downloads; last commit 11 Nov 2026, 19:02 IST; release 4.1.1), from the same author as Cupertino, with deep Style Settings integration; and Shimmering Focus (360,775 downloads; last commit 14 Sep 2026, 22:09 IST; release 5.88.0), which the README describes as a minimalistic theme for keyboard-centric use that hides some UI until it is needed.
Minimal — the usual first install
Minimal is the official catalog entry with the highest download count on the check date (2,770,843). The GitHub description calls it "A distraction-free and highly customizable theme for Obsidian." The README says it works on desktop, mobile, and tablet, and that it supports color schemes including Catppuccin, Dracula, Everforest, Gruvbox, macOS, Nord, and Solarized, plus a true-black background option aimed at OLED devices. Official 2020 Gems of the Year results name Minimal, by kepano, as Best theme.
The README "highly recommended" companion is the official Minimal Theme Settings plugin (catalog id obsidian-minimal-settings). Hider (obsidian-hider) is recommended there to hide chrome such as the ribbon. Style Settings is described as optional, for a custom color scheme. manifest.json at HEAD reports version 9.1.4 and minAppVersion 1.14.0. Detailed docs live at minimal.guide.
Things — a task-app palette
Things (1,388,992 downloads) is listed for light and dark modes. The README describes a Things-inspired color palette, tag pills, checkbox styling, and customization of bold, italic, highlighter, and block-quote colors through Style Settings. It also lists bundled JetBrains Mono for code and enhanced code blocks with line numbers. Version 2.2.6 was released on 1 November 2026.
Blue Topaz — still updated, Style Settings recommended
Blue Topaz (1,068,293 downloads) remains in the official catalog and still received GitHub commits in November 2026. GitHub describes it as "A blue theme for Obsidian." The README strongly recommends Style Settings to customize it, and it links English and Chinese TIPS example vaults. Official 2020 Gems of the Year results name Blue Topaz as the Themes runner-up. The README also notes that built-in online background images were removed to follow Obsidian's policy against remote assets — the same rule as the current developer guidelines.
Typewriter — typography first
Typewriter (470,591 downloads, GPL-3.0) is aimed at writing. The README lists a cool dark mode and a warm light mode, faded Markdown markers, a Vim cursor, soft-wrapping of long file-explorer titles, and fonts that are base64-encoded in the theme so they also work on mobile. It recommends the Typewriter Scroll community plugin for a true typewriter scroll, and Style Settings for customization. The 2.3.4 release is dated 31 October 2026.
ITS Theme — extras bundled
ITS Theme (456,076 downloads, GPL-2.0) is documented at the author's Obsidian Publish guide. The README says Style Settings is used to customize it, and that checkboxes, callouts, image adjustments, asides, embed adjustments, Kanban styling, and alternate themes are already included. On the check date, GitHub returned no Releases entry; the last commit was 17 November 2026, 06:49 IST, and manifest.json at HEAD reports version 1.4.30. That is a case where the commit date and the manifest are the available version signals.
Catppuccin — four official palettes
Catppuccin (361,955 downloads) ports the Catppuccin palettes into Obsidian. The README says to set Obsidian's base color scheme to Light for Latte, or Dark for Frappé, Macchiato, or Mocha (Mocha is the default dark flavor), and to install Style Settings to pick flavors and accents. Official 2022 Gems of the Year results name Catppuccin as a Themes runner-up. The latest release on the check date was 0.4.52, on 5 November 2026.
Border — clean layout, optional cards
Border (324,827 downloads) is described in its README as "A clean and highly customisable theme." Auto-hide, card layout, and a hover line indicator are documented as Style Settings options, and the repo also ships presets. Version 1.13.9 was released on 31 October 2026.
Cupertino — 2024 official new-theme winner
Cupertino (189,406 downloads) is the official catalog repo for the theme named Winner under New themes in the 2024 Gems of the Year (the awards post links the earlier repository path aaaaalexis/obsidian-cupertino). The README describes clean typography, native-inspired components, and a mobile-oriented layout, and it says the theme is complete at install without extra plugins, with optional plugins only for fine-tuning. Version 4.1.1 was released on 11 November 2026. The same author publishes Baseline, which takes the opposite stance and leans on Style Settings.
Dracula Official — dark only
Two Dracula-named entries exist in the official catalog. Dracula Official (135,003 downloads) is the dracula/obsidian repository, MIT licensed, dark mode only, last committed 1 November 2026, release 1.1.8. The README points at draculatheme.com/obsidian. A separate catalog entry, "Dracula for Obsidian" (jarodise/Dracula-for-Obsidian.md, 305,570 downloads), also exists; it is MIT licensed and dark-only, but its last GitHub commit on the check date was 1 February 2026 and GitHub returned no Releases entry. If the official Dracula port is the goal, the dracula/obsidian listing is the one that matches that name.
High downloads are not the same as a current theme
Several well-known catalog themes still have large official download totals and a license, but their GitHub repos had not been committed to in 2026 as of 17 November. They are still installable; they just need a closer look at the directory Scorecard and at whether they still render cleanly on the current Obsidian version.
AnuPpuccin — 1,269,978 official downloads, GPL-3.0, dark and light. Official 2022 Gems of the Year results name it the Themes winner. The README fetched on 17 November 2026 states that the project is currently on hiatus. The latest GitHub commit was 1 December 2024, 16:15 IST, and the latest GitHub release was 1.5.0 on 11 May 2024, 02:30 IST.
Obsidian Nord — 759,466 downloads, MIT, dark and light; last GitHub commit 10 June 2024, 20:44 IST. GitHub returned no Releases entry.
Primary — 386,657 downloads, GPL-3.0, light and dark; last GitHub commit 26 September 2024, 17:17 IST; latest release 2.10.0 on 30 September 2024, 06:45 IST.
Sanctum — 296,911 downloads, MIT, dark and light; last GitHub commit 7 February 2023, 16:31 IST; latest release 1.2.0 on 8 August 2022, 23:43 IST.
Those dates are GitHub data, not a takedown request. If one of them still looks right in a vault, keep it, and check for updates the next time Obsidian itself ships a major UI change. The 15 catalog entries marked legacy in community-css-themes.json on the check date are a separate official flag; none of the shortlist themes above carried that flag.
After the theme is installed
Give a new theme a few days before stacking snippets and Style Settings tweaks on top of it. If something looks off after an Obsidian update, run Check for updates first, then temporarily disable snippets to see whether the conflict is the theme or a local override.
A theme does not create folders, daily notes, or dashboards. If the vault itself still feels unstructured, that is a templates problem, not a color problem — start with the vault templates and starter kits guide. If the open question is still whether Obsidian is the right app at all, the comparison of Notion AI vs Obsidian is the better page. For AI-assisted retrieval on top of a local Markdown vault, see Obsidian + AI: Build a Second Brain That Actually Thinks.
Frequently asked questions
Where are official community themes listed?
Inside Obsidian, under Settings → Appearance → Themes → Manage, and on the web at community.obsidian.md. The machine-readable catalog is community-css-themes.json in the official obsidianmd/obsidian-releases repository. That file listed 1,037 themes on 17 November 2026.
Do community themes update by themselves?
No. Official help says they do not update automatically. Use Check for updates under Appearance → Current community themes, or update one theme from Manage.
Is a CSS snippet enough instead of a theme?
Yes, when the change is local: heading colors, a slightly larger font, or a class on one note via the cssclasses property. Official snippet help and the CSS variable docs at docs.obsidian.md cover that path. A full theme is the better starting point when the whole workspace — sidebars, tabs, and editor — should change together.
What do the official download numbers mean?
Obsidian publishes a download total for each theme at releases.obsidian.md/stats/theme, and the community directory help says a listing shows total downloads. This guide uses those official totals from 17 November 2026. They are not unique-user counts, and they are not a maintenance score.
How can a new theme be published to the catalog?
Official instructions are in Submit your theme: a GitHub repo with README.md, LICENSE, a screenshot, and manifest.json; a GitHub release whose tag matches the manifest version and that attaches manifest.json and theme.css; then a submission through community.obsidian.md after linking a GitHub account. Guidelines require bundled assets and no network calls.
Note: Catalog counts, download totals, licenses, and GitHub dates were fetched on 17 November 2026. Themes, releases, and the official stats file change often, so re-check the linked catalog, stats endpoint, and repository before relying on a number. This is not a paid ranking, and it is not an Obsidian endorsement.
Originally published at wowhow.cloud
Top comments (0)