# Material for MkDocs changelog

> A documentation theme for MkDocs, with instant navigation and offline search.

- Vendor: Martin Donath
- Category: Developer Tools
- Official site: https://squidfunk.github.io/mkdocs-material/
- Tracked by: What's New (https://whatsnew.fyi/product/mkdocs-material)
- Harvested from: GitHub (squidfunk/mkdocs-material)
- Entries below: 10 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## Releases

### 9.7.7 — mkdocs-material-9.7.7

- Date: 2026-07-17
- Version: 9.7.7
- Original notes: https://github.com/squidfunk/mkdocs-material/releases/tag/9.7.7
- Permalink: https://whatsnew.fyi/product/mkdocs-material/releases/9.7.7

- **security** — Fix a DOM-based XSS vulnerability in search suggestions

> [!WARNING]
>
> __Material for MkDocs is approaching end of life__
>
> Material for MkDocs is scheduled to reach end of life on November 5, 2026. Until then, maintenance is limited to critical bug fixes and security updates. After this date, the project will remain available on PyPI and GitHub, but no further maintenance is planned except in exceptional circumstances.
>
> For users looking for a long-term, actively developed successor, we're building [Zensical] – a next-generation static site generator designed for technical documentation. If you're planning a new documentation project or evaluating your long-term options, we invite you to take a look.
>
> Organizations requiring support beyond this date are welcome to get in touch to discuss available options.
>
> [Read the full announcement on our blog]

[Zensical]: https://zensical.org
[Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

##### Changes

- Fixed a DOM-based XSS vulnerability in search suggestions

> Thanks to @p- for responsibly reporting this issue.

### 9.7.6 — mkdocs-material-9.7.6

- Date: 2026-03-19
- Version: 9.7.6
- Original notes: https://github.com/squidfunk/mkdocs-material/releases/tag/9.7.6
- Permalink: https://whatsnew.fyi/product/mkdocs-material/releases/9.7.6

- **fixed** — Automatically disable MkDocs 2.0 warning for forks of MkDocs

> [!WARNING]
> 
> __Material for MkDocs is in maintenance mode__
>
> Going forward, the Material for MkDocs team focuses on [Zensical], a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.
> 
> [Read the full announcement on our blog]

[Zensical]: https://zensical.org
[Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

##### Changes

- Automatically disable MkDocs 2.0 warning for forks of MkDocs

### 9.7.5 — mkdocs-material-9.7.5

- Date: 2026-03-10
- Version: 9.7.5
- Original notes: https://github.com/squidfunk/mkdocs-material/releases/tag/9.7.5
- Permalink: https://whatsnew.fyi/product/mkdocs-material/releases/9.7.5

- **changed** — Limited version range of mkdocs to <2
- **changed** — Updated MkDocs 2.0 incompatibility warning to clarify relation with MkDocs

> [!WARNING]
> 
> __Material for MkDocs is in maintenance mode__
>
> Going forward, the Material for MkDocs team focuses on [Zensical], a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.
> 
> [Read the full announcement on our blog]

[Zensical]: https://zensical.org
[Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

##### Changes

- Limited version range of mkdocs to <2
- Updated MkDocs 2.0 incompatibility warning (clarify relation with MkDocs)

### 9.7.4 — mkdocs-material-9.7.4

- Date: 2026-03-03
- Version: 9.7.4
- Original notes: https://github.com/squidfunk/mkdocs-material/releases/tag/9.7.4
- Permalink: https://whatsnew.fyi/product/mkdocs-material/releases/9.7.4

- **security** — Hardened social cards plugin by switching to sandboxed environment
- **changed** — Updated MkDocs 2.0 incompatibility warning

> [!WARNING]
> 
> __Material for MkDocs is in maintenance mode__
>
> Going forward, the Material for MkDocs team focuses on [Zensical], a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.
> 
> [Read the full announcement on our blog]

[Zensical]: https://zensical.org
[Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

##### Changes

- Hardened social cards plugin by switching to sandboxed environment (recommended by @caveeroo)
- Updated MkDocs 2.0 incompatibility warning

### 9.7.3 — mkdocs-material-9.7.3

- Date: 2026-02-24
- Version: 9.7.3
- Original notes: https://github.com/squidfunk/mkdocs-material/releases/tag/9.7.3
- Permalink: https://whatsnew.fyi/product/mkdocs-material/releases/9.7.3

- **fixed** — Print MkDocs 2.0 incompatibility warning to stderr

> [!WARNING]
> 
> __Material for MkDocs is in maintenance mode__
>
> Going forward, the Material for MkDocs team focuses on [Zensical], a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.
> 
> [Read the full announcement on our blog]

[Zensical]: https://zensical.org
[Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

##### Changes

- Fixed #8567: Print MkDocs 2.0 incompatibility warning to stderr

### 9.7.2 — mkdocs-material-9.7.2

- Date: 2026-02-18
- Version: 9.7.2
- Original notes: https://github.com/squidfunk/mkdocs-material/releases/tag/9.7.2
- Permalink: https://whatsnew.fyi/product/mkdocs-material/releases/9.7.2

- **changed** — Opened up version ranges of optional dependencies for forward-compatibility
- **added** — Added warning to mkdocs build about impending MkDocs 2.0 incompatibility

> [!WARNING]
> 
> __Material for MkDocs is in maintenance mode__
>
> Going forward, the Material for MkDocs team focuses on [Zensical], a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.
> 
> [Read the full announcement on our blog]

[Zensical]: https://zensical.org
[Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

##### Changes

- Opened up version ranges of optional dependencies for forward-compatibility
- Added warning to `mkdocs build` about impending MkDocs 2.0 incompatibility (doesn't affect strict mode)

### 9.7.1 — mkdocs-material-9.7.1

- Date: 2025-12-18
- Version: 9.7.1
- Original notes: https://github.com/squidfunk/mkdocs-material/releases/tag/9.7.1
- Permalink: https://whatsnew.fyi/product/mkdocs-material/releases/9.7.1

- **security** — Updated requests to 2.30+ to mitigate CVE in urllib
- **fixed** — Fixed privacy plugin not picking up protocol-relative URLs
- **fixed** — Fixed false positives and negatives captured in privacy plugin

> [!WARNING]
> 
> __Material for MkDocs is in maintenance mode__
>
> Going forward, the Material for MkDocs team focuses on [Zensical], a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.
> 
> [Read the full announcement on our blog]

[Zensical]: https://zensical.org
[Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/

##### Changes

- Updated requests to 2.30+ to mitigate CVE in urllib
- Fixed privacy plugin not picking up protocol-relative URLs
- Fixed #8542: false positives and negatives captured in privacy plugin

### 9.7.0 — mkdocs-material-9.7.0

- Date: 2025-11-11
- Version: 9.7.0
- Original notes: https://github.com/squidfunk/mkdocs-material/releases/tag/9.7.0
- Permalink: https://whatsnew.fyi/product/mkdocs-material/releases/9.7.0

- **added** — Support for projects plugin (for compatibility, now deprecated)
- **added** — Support for typeset plugin (for compatibility, now deprecated)
- **added** — Support for pinned blog posts and author profiles
- **added** — Support for customizing pagination for blog index pages
- **added** — Support for customizing blog category sort order
- **added** — Support for staying on page when switching languages
- **added** — Support for disabling tags in table of contents
- **added** — Support for nested tags and shadow tags
- **added** — Support for footnote tooltips
- **added** — Support for instant previews
- **added** — Support for instant prefetching
- **added** — Support for custom social card layouts
- **added** — Support for custom social card background images
- **added** — Support for selectable ranges in code blocks
- **added** — Support for custom selectors for code annotations
- **added** — Support for configurable log level in privacy plugin
- **added** — Support for processing of external links in privacy plugin
- **added** — Support for automatic image optimization via optimize plugin
- **added** — Support for navigation paths (breadcrumbs)
- **fixed** — Vector accents do not render when using KaTeX

> [!WARNING]
> 
> __Material for MkDocs is now in maintenance mode__
>
> This is the last release of Material for MkDocs that will receive new features. Going forward, the Material for MkDocs team focuses on [Zensical], a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs for 12 months at least.
>
> [Read the full announcement on our blog]

This release includes all features that were previously exclusive to the Insiders edition. These features are now freely available to everyone.

__Note on deprecated plugins__: The [projects] and [typeset] plugins are included in this release, but must be considered deprecated. Both plugins proved unsustainable to maintain and represent architectural dead ends. They are provided as-is without ongoing support.

__Changes__:

- Added support for projects plugin (for compat, now deprecated)
- Added support for typeset plugin (for compat, now deprecated)
- Added support for pinned blog posts and author profiles
- Added support for customizing pagination for blog index pages
- Added support for customizing blog category sort order
- Added support for staying on page when switching languages
- Added support for disabling tags in table of contents
- Added support for nested tags and shadow tags
- Added support for footnote tooltips
- Added support for instant previews
- Added support for instant prefetching
- Added support for custom social card layouts
- Added support for custom social card background images
- Added support for selectable rangs in code blocks
- Added support for custom selectors for code annotations
- Added support for configurable log level in privacy plugin
- Added support for processing of external links in privacy plugin
- Added support for automatic image optimization via optimize plugin
- Added support for navigation paths (breadcrumbs)
- Fixed #8519: Vector accents do not render when using KaTeX

  [Zensical]: https://zensical.org
  [Read the full announcement on our blog]: https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/
  [projects]: https://squidfunk.github.io/mkdocs-material/plugins/projects/
  [typeset]: https://squidfunk.github.io/mkdocs-material/plugins/typeset/

### 9.6.23 — mkdocs-material-9.6.23

- Date: 2025-11-01
- Version: 9.6.23
- Original notes: https://github.com/squidfunk/mkdocs-material/releases/tag/9.6.23
- Permalink: https://whatsnew.fyi/product/mkdocs-material/releases/9.6.23

- Updated Burmese translation

### 9.6.22 — mkdocs-material-9.6.22

- Date: 2025-10-15
- Version: 9.6.22
- Original notes: https://github.com/squidfunk/mkdocs-material/releases/tag/9.6.22
- Permalink: https://whatsnew.fyi/product/mkdocs-material/releases/9.6.22

- Updated Georgian translation