Home

Custom Views lets an Obsidian note render through a matching HTML, CSS, and optional JavaScript template. Use it when a group of notes should behave like a designed view: movie pages, album pages, dashboards, catalog entries, reading lists, project briefs, and similar structured notes.

This wiki keeps the practical documentation out of the README. Start with the quick path, then open the deeper reference pages when you need filters, logic, Bases queries, or JavaScript.

Start here

1. Quick start: build a tiny working view.
2. Settings and view rules: decide which files a view applies to.
3. Template syntax: insert frontmatter, file data, arrays, and markdown.
4. Template logic: use conditionals, loops, and local variables.
5. Filters and functions: transform values and write expressions.
6. Bases in Custom Views: query Obsidian Bases from inside a template.
7. CSS and JavaScript: style views and add interactivity.
8. Troubleshooting: fix blank views, no rows, link rendering, and JavaScript errors.

Tutorials

• Movie view tutorial explains the saved Movies template from data.json: a poster/backdrop-driven movie page with TMDB cast and trailer loading.
• Album view tutorial explains the saved Albums template from data.json: an album page that queries matching song notes with Bases.

Full example code

• Full Movie view code
• Full Album view code

Helpful Obsidian docs

Custom Views borrows familiar ideas from Obsidian's template-like tools and works especially well with Bases:

• Obsidian Bases
• Bases syntax
• Bases functions
• Web Clipper templates
• Web Clipper filters
• Web Clipper logic
• Web Clipper troubleshooting

Custom Views is similar enough to those pages to feel familiar, but it is not a clone. When this wiki disagrees with the official Obsidian docs, follow this wiki for Custom Views behavior.