Changelog

Improvements

Properties

• List property elements can now be edited. Right-click the list item and choose "Edit...".

General

• macOS: The "more options" icon on views will now be horizontal instead of vertical to match OS guidelines.
• The backlinks and word count status bar elements will be hidden if the active view does not support them.
• The icon for bookmarked files has been updated for clarity.
• Pressing Enter or Tab when the file titlebar is focused will not revert the filename if the new name is invalid. Instead, an error message will be shown and the titlebar will stay active.
• Improved layout of "About" settings tab.

No longer broken

Properties

• Fixed "Show file properties" command not working if the Graph view is focused.
• If frontmatter parsing fails, we will now always show a token where the parsing error is.
• Fixed issue where status bar element did not update when closing a file.
• Fixed issue where properties are invisible when dragging a tab.
• List properties will now properly handle empty rows in the frontmatter.

Canvas

• Fixed issue where navigating to files from a canvas would sometimes cause sidebar views to show empty results.

Bookmarks

• The "Bookmark this block" command will now pre-populate the bookmark title with the currently selected text.
• Dragging a bookmark from the bookmarks view to the editor will include the subpath if there is one.

General

• Tag suggestions will now be sorted alphabetically if there is no search query.
• Text selection will no longer be updated when the inline search input (Ctrl/command + F) loses focus.
• "Split right" and "Split down" commands will now copy the scroll position of the current leaf.
• Triggering a command from the macOS Application menu will now un-minimize the vault if the window is minimized.

No longer broken

General

• Formatting commands (e.g. "Toggle bold") will now update the text selection to ignore leading and trailing whitespace.
• The suggest box in the Search view will no longer appear when reselecting the existing search query.

Properties

• Added new indeterminate state to checkboxes.
• Pressing arrow down (↓) from the inline title should focus the note content if no properties exist.
• Fixed issue with inserting templates with properties failing to add new properties if the value is null.
• Right-click on links in properties now opens the link context menu.

Sync

• Fixed a Sync bug that in rare cases could cause file duplication when editing a file and then immediately renaming it.
• Property types will now be counted "Main settings" in the sync preferences.

• Includes all new functionality and bug fixes up to Obsidian Desktop v1.4.14. This includes the new properties editor.
• Fixed drag and drop handler on iOS causing the view to scroll. This affects properties, the mobile toolbar, and the font picker.
• The suggest component is now inline on mobile instead of attached to the keyboard.
• Added a "create" button to menus like the share menu.
• Updated formatting of share menu and fixed bug where it would fail to insert if current file was in reading mode.
• Lots of styling improvements for settings.
• Login screen no longer mentions requiring 2FA if it is not enabled on your account.
• Fixed bug where template properties wouldn't get applied if a value was null.
• Fixed issue where you could sometimes not add text after an image in Live Preview.

Phone-only Improvements

• Closing app settings no longer causes double animation.
• Fixed loading bar when opening the community themes and community plugins directory.

No longer broken

General

• Formatting commands (e.g. "Toggle bold") will now update the text selection to ignore leading and trailing whitespace.
• The suggest box in the Search view will no longer appear when reselecting the existing search query.

Properties

• Added new indeterminate state to checkboxes.
• Pressing arrow down (↓) from the inline title should focus the note content if no properties exist.
• Fixed issue with inserting templates with properties failing to add new properties if the value is null.
• Right-click on links in properties now opens the link context menu.

Sync

• Fixed a Sync bug that in rare cases could cause file duplication when editing a file and then immediately renaming it.
• Property types will now be counted "Main settings" in the sync preferences.

The installer has been updated to Electron v25.8.1 to address several vulnerabilities. To update, you must manually get the latest installer from https://obsidian.md/download.

No longer broken

• Fixed edits from source mode not properly updating the properties editor interface.

No longer broken

• Canvas: Fixed issue preventing Canvas cards from entering edit mode.

Improvements

Editor

• Empty lines before the frontmatter block are no longer allowed. Previously this was supported by some parts of the app and ignored by others.
• Adding inline formatting to text will now ignore whitespace at the start and end of the selection.

Properties

• Date & time fields now include seconds.
• Added command to fold properties.
• When toggling "Properties view" core plugin the core plugin will immediately open the "All properties" view.
• Added a tooltip when hovering over property names in case the property name is too long and gets cut off.
• Sidebar view now indicates if file properties are invalid.
• Right-click on the properties heading to quickly add a property or clear the properties from the file.
• If your file properties cannot be parsed, the exact spot where there YAML is invalid is now highlighted.

No longer broken

General

• Fixed "Reveal in Finder" hanging for a long time on macOS.
• Files specified in the "Excluded files" setting will no longer be counted in the Tags view or Properties view.
• Fixed "Replace" button in find/replace not highlighting the next match.
• Fix stacked tabs not scroll into view when first activated.

Properties

• Fixed bug where editing properties in reading mode would cause changes made in edit mode to be reverted.
• Fixed the All Properties view sometimes jumping around when editing notes.
• Fixed issue where properties editor would sometimes produce invalid frontmatter when editing.
• Fixed Tag suggest not showing suggestions if the input starts with #.
• Fixed properties status bar item not updating if the properties sidebar was not open.
• Fixed more edge cases where frontmatter would temporarily appear when modifying properties.
• The "Add file property" menu item will no longer be disabled in reading mode.
• Fixed duplicate keys being suggested in property name input fields.
• Fixed "Unassign type" not working for properties with capital letters.
• It is no longer possible to unassign the type for default properties (cssclasses, tags, aliases).
• Fixed issue where the arrow keys would jump from the editor to properties editor even if the cursor isn't on the first line of the file.
• Pressing escape when property name input is focused now properly reverts the changes.
• Renaming a list property will no longer cause a type mismatch warning to appear.
• Clicking outside of the property editor will remove the empty property section for the note if there is one.
• Fixed "type mismatch" tooltip sometimes showing the wrong expected type.
• Fixed cssclasses sometimes staying applied to the current view after switching to a new file.

Search

• Fixed file: queries showing wrong matches when composed with other search operators.
• Fixes results for file: queries highlighting the wrong text.

Other plugins

• Outline: Fixed outline view scroll position getting reset when editing a longer document.
• Note composer: Improved behavior for merging frontmatter if note contains nested YAML properties or invalid frontmatter.
• Sync: Fixed app freezing for very large vaults sometimes.

Fixed since last insider build

• Fixed properties sidebar view not showing "Add properties" button if the active file has no properties yet.

Improvements

• Properties: Added a tooltip when hovering over property names in case the property name is too long and gets cut off.
• Properties: Sidebar view now indicates if file properties are invalid.
• Properties: Right-click on the properties heading to quickly add a property or clear the properties from the file.
• Frontmatter: If your file properties cannot be parsed, the exact spot where there YAML is invalid is now highlighted.
• Editor: Adding inline formatting to text will now ignore whitespace at the start and end of the selection.

No longer broken

• Live Preview: Fixed not being able to edit properties if "Show properties as source" was enabled or if the frontmatter was invalid.
• Live Preview: Fixed issue where the arrow keys would jump from the editor to properties editor even if the cursor isn't on the first line of the file.
• Properties: Pressing 'escape' when property name input is focused now properly reverts the changes.
• Properties: Renaming a list property will no longer cause a type mismatch warning to appear.
• Properties: Clicking outside of the property editor will remove the empty property section for the note if there is one.
• Properties: Fixed "type mismatch" tooltip sometimes showing the wrong expected type.

Improvements

• Properties: New behavior when toggling "Properties view" core plugin. Enabling the core plugin will immediately open the "All properties" view.

No longer broken

• Fixed properties status bar item not updating if the properties sidebar was not open.
• Live Preview: Fixed more edge cases where frontmatter would temporarily appear when modifying properties.
• Live Preview: Fixed issue where sometimes the property editor would insert an extra newline character.
• The "Add file property" menu item will no longer be disabled in reading mode.
• Properties: Fixed duplicate keys being suggested in property name input fields.
• Properties: Fixed "Unassign type" not working for properties with capital letters.
• Properties: It is no longer possible to unassign the type for default properties (cssclasses, tags, aliases).
• Files specified in the "Excluded files" setting will no longer be counted in the Tags view or Properties view.

Improvements

• Live Preview: Notes can no longer include empty lines before the frontmatter block. If the frontmatter block does not start on the first line of the note, we will interpret it as regular text.
• Properties: Date & time fields now include seconds.
• Added command to fold properties.

No longer broken

• Properties: Fixed bug where editing properties in reading mode would cause changes made in edit mode to be reverted.
• Search: Fixed file: queries showing wrong matches when composed with other search operators.
• Search: Fixes results for file: queries highlighting the wrong text.
• Properties: Fixed the All Properties view sometimes jumping around when editing notes.
• Note composer: Improved behavior for merging frontmatter if note contains nested YAML properties or invalid frontmatter.
• Properties: Fixed issue where properties editor would sometimes produce invalid frontmatter when editing.
• Properties: Fixed Tag suggest not showing suggestions if the input starts with '#'.
• macOS: Fixed "Reveal in Finder" hanging for a long time.

Note: Mobile Obsidian is still based on Obsidian Desktop v1.3.7.

• Added support for 2FA login.
• PDF: Fixed text selection.
• There is now a loading screen when loading the Obsidian Sync view.

This update introduces Properties, a simple and durable way to add tags, links, dates, and other metadata to your notes. The core plugins Search, Templates, and Backlinks have all received upgrades to support Properties. Some of the new features in this release:

• A new UI for editing properties, with autocomplete for property names and values
• Properties can have types (e.g. text, list, date, number, checkbox) that make it faster to input data
• Properties can contain internal links to other notes
• New sidebar view lists all properties in your vault, and sort by name or frequency
• Keyboard navigation, commands, and hotkeys
• Search syntax for searching notes by property and value
• Templates automatically merge properties with existing properties in the note
• Data is still stored as YAML frontmatter at the top of each Markdown file. Metadata is automatically formatted as valid YAML.

With this update you can also enable two-factor authentication for your Obsidian account.

Properties

Properties help you organize information about a note. Adding properties to a note helps you track structured data such as text, links, dates and numbers. Properties can also be used in combination with Community plugins that can do useful things with your structured data. Learn more.

Basic usage

To add a property to a note, you have several options:

• Use the Add file property command.
• Use the Cmd/Ctrl+; hotkey.
• Choose Add file property from the More actions menu (three dots icon) or right-clicking the tab.
• Type --- at the very beginning of a file.

Once you add a property, a row will appear at the top of the file with two inputs: the property name and the property value. Once you choose the property name you can give it a value and type.

Advanced usage

In addition to the inline property editor, there is a new Properties view core plugin that adds two new views for managing your properties:

• All properties sidebar view shows a list of all the properties across your vault, and number of uses for each. Click on a property to search for all uses of it across your vault.
• File properties sidebar view shows the properties for the active file. If you prefer to hide the inline property editor, you can choose to edit your file properties from the sidebar, without losing your place in the active file.

Properties are an extremely powerful yet flexible feature that gives you even more ways to organize your information. See the documentation for Properties for even more information.

Two-factor authentication (2FA) for Obsidian accounts

For even more security, you can now enable two-factor authentication on your Obsidian account. To do so, go to obsidian.md/account and enable "2-factor authentication". This will prompt you with setup instructions.

Note: Any devices logging into Obsidian must be running v1.4.5+ to log-in using two-factor authentication.

Core plugin upgrades

• Search: New search syntax for properties.
  • To find notes containing a property, use [property]
  • To find notes with a property and a corresponding value, use [property:value]
  • Both property and value allow complex sub-queries, such as parentheses for grouping, the OR operator, double-quotes for exact matching, and regex.
• Templates: When using the "Insert template" command, properties inside template files will be merged with the current file.
• Backlinks: Properties with links will now properly show in backlink entries.
• Note Composer: Merging notes will now merge their properties.

Misc. improvements

• Search: Search autocomplete will now be shown based on the current input context.
• Live Preview now supports single column tables.
• Tag autocomplete now uses a fuzzy search algorithm.
• PDF: Added “Copy as quote” and “Copy annotation” context menu options
• PDF: Added a button to copy annotations from the annotation popup
• PDF: Added “Copy link to page” to PDF thumbnail context menu
• Editor: Formatting commands for bold, italic, etc are now context-aware. For example, "Toggle bold" inside a bolded sentence will un-bold the sentence.
• Search: Removed the delay between typing and search happening.
• Sync: Always show a visual representation of storage usage.
• Numbers everywhere should now be formatted in the app. For example, word count and character count will have thousands separators.
• The Tags core plugin has been renamed to "Tags view".

No longer broken

• Fixed: PDF Viewer single page view resets to first page.
• Fixed: PDF viewer search settings unclickable when toggling sidebar.
• Fixed bug where closing an pop-out window with an active modal would keep the modal active.
• macOS: In frameless window mode, the top-right buttons no longer shift when creating/closing tab groups.
• File Recovery will now show a loading state when loading large vaults.
• Workspace: fix "follow link under cursor" commands in Canvas.
• Canvas: nudging selection should not cause stacked tabs to scroll.
• Outline: Fixed outline not rendering if the view was opened via the "Show outline" command.
• The "New tab" view will now show the current hotkeys.
• Editor: Scroll bar should no longer affect the position of the text when it appears on long documents.
• Vim: Fix for spellchecker.

Developers

• The installer has been updated to use Electron v25.8.0 (requires downloading the latest installer).
• Vault: createFolder now return a TFolder.
• Metadata: FrontMatterCache no longer inherits from CacheItem.
• Theming: new CSS variables have been added for Properties that start with --metadata
• Disabled soft line width in stringifyYaml (this was causing some breakages with other plugins reading the YAML).

About Properties

Internal Links

Internal links can be added to frontmatter using the following syntax:

---
link: "[[Link]]"
linklist:
  - "[[Link]]"
  - "[[Link2]]"
---

About tag/alias/cssclass properties

As of 1.4.0, we have deprecated the "tag", "alias", and "cssClass" properties. The property editor will automatically convert these properties to tags, aliases, and cssclasses and the values will automatically be converted to lists.

The old property names will still be identified correctly in the app, but the property editor will always prefer tags, cssClasses, and aliases.

• PDF: Fixed text selection.
• There is now a loading screen when loading the Obsidian Sync view.
• Added support for 2FA login.

Shiny new things

• Obsidian accounts now support two-factor authentication. To enable, go to your account settings at obsidian.md/account. Make sure you've installed the v1.4.5 Insider build before enabling 2FA on your account to avoid getting locked out.

Improvements

• macOS: Added additional formatting commands to the app menu.

No longer broken

• Search: Searching for an exact property match is no longer case sensitive (e.g. [property:value] will also show matches for "Property").
• Properties: Making changes to the casing of a property ("property" vs. "PROPERTY") will now properly save.
• Properties: It is no longer possible to have multiple property types with the same spelling and different casing. Properties with the same spelling will now always resolve to the same property type.
• Properties: It is no longer possible to change the default property type.
• Properties: Pressing Enter on an empty list entry will no longer display an error message.
• Properties can no longer have both 'tag' and '#tag' as entries in the same file.
• Canvas: Frontmatter in canvas text cards will no longer be hidden.
• Properties: Fixed tag dropdown showing briefly in the top-level corner when removing a tag.
• Editor: Fixed "Insert code block" and "Insert match block" working with multiple cursors.
• macOS: Fixed "Date & time" showing as "Date time" in the property menu.

Shiny new things

• Search: New search syntax for properties.
  • To find notes containing a property, use [property]
  • To find notes with a property and a corresponding value, use [property:value]
  • Both property and value allow complex sub-queries, such as parentheses for grouping, the OR operator, double-quotes for exact matching, and regex.
• Search: Search autocomplete will now be shown based on the current input context.

Improvements

• Editor: Formatting commands for bold, italic, etc are now context-aware. For example, "Toggle bold" inside a bolded sentence will un-bold the sentence.
• Backlinks: Properties with links will now properly show in backlink entries.
• Sync: Always show a visual representation of storage usage.
• Note Composer: Merging notes will now merge their properties.
• Properties: Tags can optionally start with a leading '#'.
• Properties: Fixed middle-clicking on links.
• Properties: Renamed the property type 'Time' to 'Date & time' for clarity.

No longer broken

• Live Preview: Fixed frontmatter sometimes appearing under properties for a split second while editing.
• Properties: Clicking on properties will now use the new search syntax for finding properties.
• Properties: Fixed heading links inside list properties always appearing as broken links.
• Properties: Fixed being unable to use up/down arrows when frontmatter is showing.
• Properties: Fixed frequency sort in the properties view.
• Properties: List property now saves when it loses focus.
• Vim: Fix for spellchecker.

Developers

• SearchComponent is now properly exported.
• Theme: New display variables for reading and editing mode:
  • --metadata-display-reading
  • --metadata-display-editing

Improvements

• Settings: Added a new toggle to show properties as source (YAML) in Live Preview.
• Templates: When using the "Insert template" command, properties inside template files will be merged with the current file.
• Added a new status bar item that shows the number of properties in the currently active note.
• The Properties heading can now receive keyboard focus. When focused, use the left and right arrow keys to toggle the section open or closed.
• The Tags core plugin has been renamed to "Tags view."
• The Properties core plugin has been renamed to "Properties view."

No longer broken

• Live Preview now supports single column tables.
• The Property value autosuggest will no longer return stale values.
• Fixed headings not scaling with base font size.
• Numbers everywhere should now be formatted in the app. For example, word count and character count will have thousands separators.
• Fixed bug where "Show file properties" view would not show the file properties on initial load.
• Canvas: Frontmatter in Canvas cards is no longer hidden.
• Added instructions to suggest boxes in Properties editor.
• Enabled copy/cut/paste in Properties sidebar view.
• Clicking quickly on close-tab button will no longer trigger maximize-window on macOS.
• Added max date to Date and Time properties; so no more referencing dates beyond the year 9,999.
• Fixed bug when selecting an alias from the link suggest causing the heading getting removed from the link.
• Date and Time properties now use Moment.js for parsing meaning it will now be more lax when reading formatted dates in properties.
• Search: The 'Show more context' button can be pressed multiple times in a row.
• Properties: fixed typing accented characters in text properties.
• Properties: fold state is now saved to the note.
• Fixed issue with inserting properties when auto-pairing markdown is disabled.
• Fixed the "Add file property" command not reusing the current file properties view.
• Properties: disabled autosuggest for aliases.
• Properties sidebar view won't show "add properties" button if the active file is not a markdown file.
• Editor Search: Fixed issue where \´ character was treated as space ( ).

Developers

• Disabled soft line width in stringifyYaml (this was causing some breakages with other plugins reading the YAML).

Improvements

• Properties: Date and time properties will now automatically be inferred without needing to assign the property type.
• Properties: Emails will now be recognized as links in text and list properties.
• Properties: External URLs are now clickable inside list properties.
• Properties: "Add new property" command now works with the properties sidebar view.
• Typing --- at the start of the document will now automatically insert the complementary ---.
• Properties: Add support for dragging and dropping links into text and list properties.
• Search: Removed the delay between typing and search happening.

No longer broken

• Properties: Fixed bug causing properties with upper-case characters to not display the correct property type.
• Live Preview: Frontmatter will no longer appear when switching from source mode to Live Preview with the cursor still in the frontmatter section.
• Live Preview: Fixed cursor "dead spots" where text could not be edited at a given selection.
• Properties: Shift-Enter will now accept the current text value without selecting the highlighted suggestion.
• Properties: Property values are now sorted alphabetically when the suggest appears.
• Properties: Switching a text property to a list property will automatically convert the value without warning about a type mismatch.
• Properties: The "add property" row will be removed if you click away without creating a new property.
• Properties: App URIs (such as obsidian://) will now be recognized as external links.
• Properties: Parsing YAML is now much stricter. Unsupported frontmatter types will now properly be recognized as invalid, such as having an array.
• Properties: Tab and Shift-Tab will now properly shift focus if the "Add properties" button is focused.
• Settings: "Show file properties" setting has been renamed to "Show file properties in document."
• Editor: Scroll bar should no longer affect the position of the text when it appears on long documents.

New shiny things

• Added support for deep linking in PDFs. Links can be created by right clicking on a PDF's table of contents, an annotation, or any selected text.
• New "Adapt to theme" menu option for PDFs. Enabling this will override the PDF appearance so its rendered to match the styling of the current theme
• New Appearance setting to apply a custom app icon. Supports .ico and .png files.

Improvements

• Tab close button is now hidden for inactive tabs and will only appear on hover. This creates more space for file names inside the tab.
• Improved how headings are displayed. Headings in Live Preview and Reading mode should now more closely match in appearance. Note this requires installer version 1.1.9 or above.

No longer broken

• Spellcheck setting is now stored app-wide properly, instead of having some vaults overriding others.
• Live Preview: Markdown tables are now allowed to start immediately after headings without a blank line.
• Fixed bug where embedded PDFs and markdown files sometimes lose their scroll position.
• Fixed issue where the initial switch from edit mode to reading mode causes the scroll position to be lost.
• Fixed issue where reading mode scrolls unexpectedly when opening new tabs.
• Fixed styling issue where extra space was being added between lists and sublists.
• Canvas: Allow opening external links in webviews.
• Mermaid: Fixed some color issues.

Developers

New CSS variables:

• --p-spacing defines the spacing between paragraphs (defaults to 1rem).
• --heading-spacing defines the spacing above a heading when it follows a paragraph (defaults to 2.5x paragraph spacing).

Improvements

• New icon for the Properties view.

No longer broken

• Properties: Fixed autocomplete attempting to insert []() style Markdown links if "Use Wikilinks" is disabled in settings.
• Properties: The "All Properties" view will treat properties as case-insensitive. For example, instances of "TAGS" and "tags" will be shown as the same property.
• Properties: Fixed frontmatter inside Canvas text cards generating console errors.
• Properties: Creating a link to a nonexistent note will no longer insert an extra set of "]]" brackets.
• Properties: Fixed copy/pasting text within properties not working.
• Properties: Fixed "Edit file property" command not showing in the command palette.
• Properties: The "Remove" menu item in the context menu of "All Properties" has been renamed to "Unassign type" to avoid confusion.