Skip to main content
A base lets you create database-like views of your notes. You can save a base as a standalone .base file, or embed one directly inside a Markdown note.

​
Create a new base

  1. Open the Command palette (Ctrl+P / Cmd+P).
  2. Select one of:
    • Bases: Create new base — creates a .base file in the same folder as the active file.
    • Bases: Insert new base — creates a base and embeds it in the current note as a code block.

​
Embed a base

​
Embed a base file in another file

You can embed an existing .base file into any Markdown note or canvas using the standard embed syntax: 
![[MyBase.base]]
To embed a base and show a specific view by default, append the view name after a #: 
![[MyBase.base#Reading list]]

​
Embed a base as a code block

You can also write a base configuration directly inside a note using a base code block and the Bases syntax: 
```base
filters:
  and:
    - file.hasTag("example")
views:
  - type: table
    name: Table
```
When you open the note, Obsidian renders the code block as a live base view.

​
Configure the source

By default, a base includes every file in your vault. Use filters to narrow the source down to the files you care about.

​
Filter by tag

filters:
  and:
    - file.hasTag("books")

​
Filter by folder

filters:
  and:
    - file.inFolder("Projects")

​
Combine conditions

filters:
  and:
    - file.hasTag("books")
    - file.inFolder("Reading")

filters:
  or:
    - file.hasTag("books")
    - file.hasTag("articles")
You can build complex filters using and, or, and not operators. Filters are also available through the visual Filter menu in the base toolbar — you don’t need to edit the file directly.

​
Add and remove properties

Properties (columns in table view, fields in other views) correspond to the frontmatter properties in your notes. To manage which properties are shown:
  1. Click Properties in the base toolbar.
  2. Toggle properties on or off, or drag them to reorder.
  3. Click Add formula to create a computed column.
You can also rename a property’s display name without changing the underlying frontmatter key — the display name is stored in the base configuration.

Build docs developers (and LLMs) love

Get started for freeTalk to us