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

Vault Stats

blueheron786blueheron7861k downloads

Provides methods to retrieve statistics about the vault, such as the number of notes, total word count, recently modified notes, and more.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates1

A simple Obsidian plugin that exposes two handy global functions for vault statistics, which you can call from DataviewJS or other scripts:

  • showStats(): Returns markdown summary of vault note count, word count, links, and tags.
  • showLastModifiedNotes(numItems = 10, excludeFolder = "Templates"): Returns markdown list of the most recently modified notes, excluding an optional folder.

Installation

You can grab it from the Obsidian app, Community Plugins section.

  1. Clone or download this repo.

  2. Build the plugin with npm install and npm run build.

  3. Copy the resulting main.js, manifest.json, and optionally styles.css to your vault plugin folder: /.obsidian/plugins/vault-stats/

  4. Enable the plugin in Obsidian's Community Plugins settings.

Usage

Inside any note, create a DataviewJS block like this:

// Show general vault stats
let s = await window.showStats();
dv.paragraph(s);

// Show last modified notes (default 10, excluding "Templates" folder)
let recent = await window.showLastModifiedNotes(10, "Templates");
dv.paragraph("### 🕒 Last Modified Notes:\n\n" + recent);

You can customize numItems and excludeFolder arguments for showLastModifiedNotes.

Development

The main plugin code is in main.ts.

Build with npm run build.

For development, use npm run dev to watch and rebuild on changes.

License

MIT License — feel free to use and modify.

85%
HealthExcellent
ReviewSatisfactory
About
Show vault statistics and recent edits directly inside notes or scripts. Call showStats() to return a markdown summary of note count, word count, links, and tags, or call showLastModifiedNotes(numItems, excludeFolder) to return a markdown list of the most recently modified notes with optional item count and folder exclusion.
DataFilesDates
Details
Current version
1.0.0
Last updated
11 months ago
Created
11 months ago
Updates
1 release
Downloads
1k
Compatible with
Obsidian 1.8.3+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
blueheron786blueheron786
github.com/blueheron786
GitHubblueheron786
  1. Community
  2. Plugins
  3. Data
  4. Vault Stats

Related plugins

Thino

Quickly capture memos and display them in the sidebar with a heatmap. (Closed source)

Meld Encrypt

Hide secrets in your notes.

Mood Tracker

Track your moods & emotions easily. Visualize tracked history and browse the past entries.

Vault Changelog

Maintain a changelog of recently edited notes.

Janitor

Perform cleanup tasks on your vault.

Notebook Navigator

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

Local REST API & MCP Server

Unlock your automation needs by interacting with your notes over a secure REST API.

QuickAdd

Quickly add new notes or content to your vault.

Recent Files

Display a list of recently opened files.

Omnisearch

Intelligent search for your notes, PDFs, and OCR for images.