Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Portals

samaraliwarsisamaraliwarsi16k downloads

A file browser that lets users add folders & tags as customizable tabs with icons, colors, and folder notes for easier navigation.

Add to Obsidian
Portals screenshot
Portals screenshot
Portals screenshot
  • Overview
  • Scorecard
  • Updates43

Portals enhances your Obsidian file navigation by letting you pin any folder or tag as a customisable tab, a Portal into your selected folder trees. Add icons to Tabs, background colours, gradients and rearrange them to suit your workflow.

Portals_Main

Portals_Side

✨ Features

  • Pin folders & tags as tabs at the top of the file pane.
  • Stacks – group multiple tabs into collapsible stacks.
  • Custom icons, colours & emojis – Use Phosphor, Lucide, or native emojis; picker includes favourites and a custom paste field.
  • Auto collapse folders - Automatically fold and unfold folders or tag summaries that are in use.
  • File preview – Show content snippets below filenames; toggle per file or globally.
  • Sections – Organise folders or tags into collapsible section breaks (by property or extension).
  • Dynamic commands – Every portal tab (folder or tag) is registered as its own command in the command palette for quick switching without leaving the keyboard.
  • Auto backups – Automatically save data.json on Obsidian reload.
  • Six visual styles + compact tree view + bold folder names.
  • Tag grouping & subtag support for tag portals.
  • Multi‑select files, folders, and tags with Alt+Click or Swipe right. Use multi-select toolbar for actions.
  • Command palette support includes many commands that can enhance workflow, especially when coupled with hotkeys.
  • Foldable floating action buttons for note/ folder creation, tag grouping, sections, collapse and sort.
  • Quick-add buttons for folders, tags to quickly create new items inside the target folder or tag.
  • Custom display names for tabs, stacks.
  • Side Portal - A modular, collapsible, resizable view containing, Bookmarks, Recent Files, Context notes, Hidden, Reminders, Properties and Journal.
    • Context Notes - an expansion to the older Folder notes feature. Context notes apply to folder as well as tags.
    • Recents - Shows recent files list from across the vault.
    • Bookmarks - Shows bookmarked files, folders or web links.
    • Journal - A viewing and marking tool for Daily Notes with a quote display feature.
    • Hidden - Place to show files, tags and folders hidden from the main view.
    • Properties - a full database view with multi-property filtering, saved views, grouped lists and much more for property based querying.
    • Trash - A trash explorer for notes and folders based on Obsidian's .trash folder at vault root.
    • Reminders - A side portal view for tracking due dates on notes.
  • Drag & drop reordering for portal tabs and stacks (desktop).
  • Mobile friendly – Responsive design that works on small screens. Tested on Android (more platforms coming).
  • Export/Import settings – Backup your tab configuration or transfer it to another vault using json files from Settings.

For a full featured guide, checkout Portals guide

[!Note]

  • Please back up your data file after preferences setup, colour & icon choices. Copy the file .obsidian/plugins/portals/data.json to a safe location. You can also export the same via Settings and later import it. Make sure to backup before any plugin updates.
  • Portals requires Obsidian 1.13.0 or later. If you're on an older version, update Obsidian please.
  • For best results,
    • On mobile: Works best with Baseline Theme as the theme renders vault on the top side. On other themes, turn off floating navigation in settings, i.e. Settings > Appearance > Floating Navigation.
    • On desktop, you may need to turn off vault hiding if your theme hides the vault selector on the lower side.
    • Auto backups – Enable in settings to save your configuration automatically on Obsidian reload.

⚙️ Installation

Using Community Plugins

  1. Enable community plugins: Go to Settings → Community plugins → Turn on community plugins
  2. Install Portals: Click "Browse" → Search for "Portals" → Install

Using BRAT (Beta Reviewers Auto-update Tester)

  1. Install the BRAT plugin from the Obsidian community plugins (if you haven’t already).
  2. Open BRAT settings and click Add Beta plugin.
  3. Enter the repository URL: https://github.com/samaraliwarsi/obsidian-portals.
  4. Click Add Plugin – BRAT will download and enable the latest release.

Manual installation

  1. Download the latest release from the releases page.
  2. Extract the files into your vault’s .obsidian/plugins/portals/ folder.
  3. Enable the plugin in Obsidian settings.

🚀 Quick start

  • First installation - use Ribbon menu or command palette to open Portals view.
  • Add portal tabs using settings or command palette.
  • Add existing portals to stacks using Right-click context menu on tabs.
  • Drag tabs left/right to reorder.
  • Add Side Portals using settings, command palette.
  • Side Portal can be turned off for mobile devices.
  • Customise tags, stacks and folders.

For detailed walkthroughs and tips, read the Portals Guide.

🧑‍💻 Development

Clone the repository, install dependencies, and build:


git clone https://github.com/samaraliwarsi/obsidian-portals.git

cd obsidian-portals

npm install

npm run build

The built main.js and styles.css will be in the root folder. Copy them into your test vault’s .obsidian/plugins/portals/ directory.

📝 License

This project is licensed under the MIT License. See the LICENSE file for details.


HealthExcellent
ReviewPassed
About
Portals plugin enhances file navigation in Obsidian by enabling users to pin any folder or tag as a customizable tab, a Portal into your selected folder trees. Users can add icons to Tabs, stacks, use background colors, gradients and rearrange Portals to suit their workflow. Portal tabs can be grouped multiple into collapsible stacks. A range of user preferences are available to visually enhance the explorer. Plugin comes with six visual styles and support for custom colors & icons from the Phosphor set packed into the plugin for offline usage. Plugin has features of multi-select, range-select, custom re-ordering of folder, tag spaces, recursive tag trees, tag grouping. Side Portal is a collapsible pane that offers features of context notes, trash, properties, recent files, bookmarks, journal and hidden items. The plugin is made to help single vaults that hold multiple subjects using folders or tags to separate navigation areas. Portals is fully offline, free and will always remain so.
NavigationSidebarFolders
Details
Current version
1.5.3
Last updated
4 days ago
Created
9 months ago
Updates
43 releases
Downloads
16k
Compatible with
Obsidian 1.13.0+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
samaraliwarsisamaraliwarsi
github.com/samaraliwarsi
GitHubsamaraliwarsi
  1. Community
  2. Plugins
  3. Navigation
  4. Portals

Related plugins

Notebook Navigator

A better file browser and calendar inspired by Apple Notes, Bear, Evernote and Day One.

Quick Explorer

Perform file explorer operations (and see your current file path) from the title bar, using the mouse or keyboard.

Vertical Tabs

Offer an alternative view that displays open tabs vertically, allowing users to group and organize tabs for a better navigation experience.

Flexplorer

Enhance the file explorer with custom sorting, pinning, and hiding.

Recent Files

Display a list of recently opened files.

TagFolder

Show tags as folder.

Folder notes

Create notes within folders that can be accessed without collapsing the folder, similar to the functionality offered in Notion.

Reveal Active File Button

Add a button to the top of the File Explorer, to reveal the active file.

Hide Folders

Quickly toggle the visibility of specific folders in the file navigator based on configured names. Useful for hiding attachment folders.

Custom File Explorer sorting

Manual or automatic config-driven reordering and sorting of files and folders in File Explorer.