Material for MkDocs Insiders – Now free for everyone.
Material for MkDocs Insiders – Now free for everyone
9.7.0, the final version of Material for MkDocs, includes all features that were previously exclusive to sponsors, making Material for MkDocs Insiders available to everyone!
As we're shifting our efforts to Zensical, Material for MkDocs is entering maintenance mode. This means that while we'll continue to fix critical bugs and security issues for 12 month at least, no new features will be added to Material for MkDocs.
We're also discontinuing our sponsorware model, saying goodbye to GitHub Sponsors. If you were a sponsor of our work, you already received an email mentioning that your sponsorship was cancelled. As one of the numerous individuals and organizations sponsoring Material for MkDocs over the past years – thank you! Your continued support has been invaluable.
Now, we want everyone to benefit from all features we have developed for Material for MkDocs, which is why we're making all Insiders features available to everyone!
This is the logical next step in our journey as we focus on Zensical – our next-generation static site generator built from the ground up to overcome MkDocs' technical limitations. Zensical is fully Open Source, licensed under MIT, maintains compatibility with Material for MkDocs, and can build your existing projects with minimal changes.
In the coming months, we'll close the feature parity gap, bringing the expressiveness of Material for MkDocs to Zensical.
You can subscribe to our newsletter to stay in the loop.
This is the third article in a four-part series:
- Transforming Material for MkDocs
- Zensical – A modern static site generator built by the creators of Material for MkDocs
- Material for MkDocs Insiders – Now free for everyone
- Goodbye, GitHub Discussions
Available features⚓︎
Our sponsors have enjoyed exclusive access to the following premium features
for quite some time. With the release of 9.7.0, all these features are now available to everyone:
Available features⚓︎
Our sponsors have enjoyed exclusive access to the following premium features
for quite some time. With the release of, all these features are now available to everyone:
-
Blog Plugin: Pinned Posts
View GuideKeep important blog posts anchored to the top of your index feed page automatically.
-
Instant Previews
View GuideSee content changes render instantly across your pages without full reload cycles.
-
Footnote Tooltips
View GuideDisplay clean non-intrusive text popups directly over reference notes on hover.
-
Tags Plugin: adv. settings
View GuideUnlock deep taxonomy customization features to control cross-referencing indexes.
-
Tags Plugin: Nested Tags
View GuideOrganize hierarchical categorization schemas using multi-level classification layouts.
-
Tags Plugin: Shadow Tags
View GuideLeverage hidden structural taxonomy identifiers for smart internal navigation logic.
-
Stay on page SW Lang
View GuidePreserve reader context completely by hot-swapping matching localized copy files.
-
Blog Plugin Author Profile
View GuideGenerate dedicated bio elements, social resource widgets, custom author grids.
-
Blog Plugin: adv. settings
View GuideFine-tune pagination limitations, dynamic excerpt lengths, and category rulesets.
-
Projects Plugin
View GuideManage multi-repository document sets cleanly under single structural parent frames.
-
Instant Prefetching
View GuideLoad layout resource packets silently on link mouseover for immediate page loads.
-
Social Plugin: Cust. L/O
View GuideDesign unique graphic cards layouts dynamically targeted at specific platform preview bots.
-
Social Plugin: bkg images
View GuideInject rich asset imagery backgrounds automatically behind text card render modules.
-
Code Range Selection
View GuideAllow users to extract high- lighted sub-sections directly inside code blocks.
-
Code annots: Custom SEL
View GuideOverride block comment identifiers with highly targeted identifier hooks.
-
Priv. Plugin: Adv. Settings
View GuideConfigure compliance tracking filters alongside complex localized cookie control modules.
-
Optimize Plugin
View GuideCompress heavy asset pay- loads, minify HTML structures, and optimize document loads.
-
Nav Path (Breadcrumbs)
View GuideRender intuitive location trails to track positions within information depths.
-
Typeset Plugin
View GuideApply sophisticated rule grids to refine formatting patterns and character tracking styles.
-
Priv. Plugin: ext. links
View GuideProcess non-domain hyperlink calls securely by injecting isolation tags automatically.
-
➻ MkDocs-MaterialX
Return toBack to root documentation. © Afridyne Systems™ ➠
mkdocstrings Insiders is now free as well
With Timothée joining the Zensical team, he announced that all features previously reserved to his sponsors as part of mkdocstrings Insiders are now free for everyone as well!
How to Upgrade.⚓︎
How to Upgrade
You can upgrade with the following command:
Switching from Insiders⚓︎
Switching from Insiders
If you've been a user of Insiders, we recommend to switch to the community edition as soon as possible, as it includes all Insiders features. This will make it much easier to handle third-party contributions, since no personal access tokens are necessary.
From now on, bug fixes that we make to Material for MkDocs will only be released to the community edition. Security vulnerabilities will be fixed in both editions.
Thus, please adjust your requirements.txt and GitHub Actions workflows:
- pip install git+https://${GH_TOKEN}@github.com/squidfunk/mkdocs-material-insiders. git
+ pip install mkdocs-material
The Insiders repository itself will remain available for the next 6 months. When you build your project with Insiders, it will now show an informational message pointing to this blog post.
- On February 1, 2026, this message will be turned into a warning.
- On May 1, 2026, the Insiders repository will be deleted.
Sunsetting Preparation⚓︎
Sunsetting Preparation
Entering maintenance mode, we're preparing Material for MkDocs for sunsetting.
Material for MkDocs is now in maintenance mode
-
We want to be transparent about the risks of staying on Material for MkDocs. With MkDocs unmaintained and facing fundamental supply chain concerns, we cannot guarantee Material for MkDocs will continue working reliably in the future.
-
We're aware that transitioning takes time, which is why we commit to support it at least for the next 12 months, fixing critical bugs and security vulnerabilities as needed, but the path forward is with Zensical.
-
If documentation plays a critical role in your organization, and you're worried how this might affect your business, consider joining Zensical Spark, or feel free to schedule a call by reaching out at hello@zensical.org.
Deprecations⚓︎
Deprecations
While we release all features to the general public, at the same time, we're deprecating the Projects plugin and the Typeset plugin due to maintainability issues. This means that these plugins will not receive any further updates, including no more bug fixes.
The reason for this decision is that both plugins rely on too many workarounds to make them work with MkDocs, and subsequently have been key motivators to create Zensical. If you rely on these plugins, and they work for your use case, you can of course continue to use them.
With Zensical, we'll be shipping proper sub-project support, including internationalization and versioning, designing these features together with our professional users in Zensical Spark.
Version Ranges.⚓︎
Version Ranges
Material for MkDocs has used semver version ranges for dependencies to ensure compatibility. With the advent of 9.7.0, we're switching from semver to minimal version ranges. This provides more flexibility in dependency resolution, specifically to allow users to use newer versions of dependencies that include important bug fixes or security patches.
Security⚓︎
security
We will not transfer ownership of the Material for MkDocs repository to another individual or organization. The repository and PyPI package will remain under the ownership of @squidfunk, which preserves the trusted supply chain our users depend on.
Thus, if you wish to take on maintenance of Material for MkDocs, please create a fork.
Looking Ahead⚓︎
Achieving Sustainability⚓︎
Achieving Sustainability
Where Material for MkDocs relied on sponsorware, Zensical takes a new approach, to ensure it evolves to meet the needs of organizations building complex, enterprise-scale documentation.
Zensical Spark is a collaborative space where professional users have a direct voice in shaping Zensical's future. Through a structured design process and together with our Zensical Spark members, we identify opportunities, validate proposals, and define priorities – turning their real-world documentation challenges into features that benefit the entire community.
Reach out at hello@zensical.org to schedule a call to learn more about Zensical Spark, discuss your organization's needs, and how it helps us to make Zensical sustainable.
Our commitment to you.⚓︎
Commitment
If you're currently using Material for MkDocs, there's no need to rush. We're committed to keeping it secure and functional for the next 12 months while we focus our efforts on Zensical.
The 9.7.0 release marks a significant shift – every Insiders feature is now available to everyone, with no sponsorship required. As we build Zensical, each of these features will be rearchitected and improved. Zensical is entirely free and Open Source, ensuring the entire community benefits from our work without barriers.
When you're ready to explore what's next, Zensical is compatible with Material for MkDocs and designed to be a natural evolution of the ideas and principles you already know.
If you loved Material for MkDocs and are excited about Zensical, we'll be providing new methods to support our work in the coming months, with the possibility of getting exclusive goodies.
Subscribe to our newsletter to stay in the loop.