---
id: mkdocs-meta-manager
version: "1.1.0"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# mkdocs-meta-manager — MkDocs plugin for managing meta tags across folders and files.

License: permissive · Maintenance: dormant · Downloads: 1.0M/mo

## What it is and what it does

mkdocs-meta-manager is a MkDocs plugin that centralizes meta tag management by reading `.meta.yml` configuration files placed at any level in your docs folder structure. Instead of manually adding meta tags to every markdown file, you define them once in a meta file, and all markdown files in that folder and its subfolders automatically inherit those tags. The plugin supports customizing the meta filename and merging entries from multiple meta files according to the folder hierarchy.

It's designed for documentation sites that need consistent metadata (like SEO tags, author info, or custom attributes) applied across many pages without repetition. The plugin integrates directly into MkDocs' build pipeline and depends only on mkdocs and jinja2, making it lightweight to install and run.

Use it for:

- Apply consistent SEO meta tags (description, keywords, og:image) to all pages in a documentation section without editing each file
- Set author, version, or custom metadata at the folder level so all nested pages inherit the same attributes
- Manage documentation-wide metadata like language, robots directives, or tracking codes from a single configuration point
- Override inherited meta tags at deeper folder levels to customize metadata for specific documentation subsections
- Reduce boilerplate by defining common meta patterns once and reusing them across multiple documentation projects

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A MkDocs plugin that automatically applies meta tags to markdown files based on hierarchical `.meta.yml` configuration files placed in your docs folder structure.

Yes, if you use MkDocs and need to manage meta tags across many pages. The plugin is lightweight, has no security vulnerabilities, and MIT licensing poses no restrictions. However, dormant maintenance (571 days since last release) means you should verify compatibility with your MkDocs version before relying on it for production—test thoroughly and be prepared to fork or maintain it yourself if updates become necessary.

## Install

pip install mkdocs-meta-manager
uv add mkdocs-meta-manager
poetry add mkdocs-meta-manager

## Installing mkdocs-meta-manager

Before you install: Installs cleanly with only mkdocs and jinja2 as runtime dependencies. Dormant maintenance status (last commit 2025-01-20, no activity for 571 days) means bug fixes and compatibility updates are unlikely, though the small scope and stable dependencies reduce risk.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install mkdocs-meta-manager

# In mkdocs.yml:
plugins:
  - search
  - meta-manager

# Create .meta.yml in your docs folder:
# meta:
#   - name: description
#     content: "Page description"

# All markdown files in that folder and subfolders inherit these tags

Verify before relying:

- Whether dormant status (571 days since last release) affects compatibility with recent MkDocs versions
- Performance impact when managing meta tags across large documentation hierarchies
- Behavior when meta files conflict or overlap across nested folder structures

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 1.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

mkdocs meta tags plugin, manage metadata across mkdocs folders, hierarchical meta tags documentation, mkdocs seo meta automation, folder-level metadata inheritance, mkdocs plugin meta management, yaml meta configuration mkdocs, mkdocs-plugin, metadata-management, seo-automation

[View on SkillFed](https://skillfed.io/packages/mkdocs-meta-manager) · [View on PyPI](https://pypi.org/project/mkdocs-meta-manager/)