|
| 1 | +--- |
| 2 | +date: 2025-11-05 |
| 3 | +authors: |
| 4 | + - squidfunk |
| 5 | + - alexvoss |
| 6 | + - katharinalisalin |
| 7 | + - pawamoy |
| 8 | +categories: |
| 9 | + - General |
| 10 | +description: > |
| 11 | + tbd |
| 12 | +title: Insiders – Now free for everyone |
| 13 | +slug: insiders-now-free-for-everyone |
| 14 | +--- |
| 15 | + |
| 16 | +# Material for MkDocs Insiders – Now free for everyone |
| 17 | + |
| 18 | +__[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!__ |
| 19 | + |
| 20 | +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. |
| 21 | + |
| 22 | +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. |
| 23 | + |
| 24 | +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! |
| 25 | + |
| 26 | +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. |
| 27 | + |
| 28 | +In the coming months, we'll close the [feature parity] gap, bringing the expressiveness of Material for MkDocs to Zensical. |
| 29 | + |
| 30 | +_You can subscribe to [our newsletter] to stay in the loop_. |
| 31 | + |
| 32 | +<!-- more --> |
| 33 | + |
| 34 | + [9.7.0]: ../../changelog/index.md#9.7.0 |
| 35 | + [Zensical]: https://zensical.org |
| 36 | + [maintenance mode]: https://github.com/squidfunk/mkdocs-material/issues/8523 |
| 37 | + [goodbye to GitHub Sponsors]: zensical.md#goodbye-github-sponsors |
| 38 | + [compatibility with Material for MkDocs]: zensical.md#maximum-compatibility |
| 39 | + [Open Source, licensed under MIT]: https://zensical.org/about/license/ |
| 40 | + [feature parity]: https://zensical.org/compatibility/features/ |
| 41 | + [our newsletter]: https://zensical.org/about/newsletter/ |
| 42 | + |
| 43 | +--- |
| 44 | + |
| 45 | +__This is the third article in a four-part series:__ |
| 46 | + |
| 47 | +1. [Transforming Material for MkDocs] |
| 48 | +2. [Zensical – A modern static site generator built by the creators of Material for MkDocs] |
| 49 | +3. Material for MkDocs Insiders – Now free for everyone |
| 50 | +4. A path forward for our community <small>coming November 18, 2025</small> |
| 51 | + |
| 52 | + [Transforming Material for MkDocs]: transforming-material-for-mkdocs.md |
| 53 | + [Zensical – A modern static site generator built by the creators of Material for MkDocs]: zensical.md |
| 54 | + |
| 55 | +## Available features |
| 56 | + |
| 57 | +Our sponsors have enjoyed exclusive access to the following premium features |
| 58 | +for quite some time. With the release of [9.7.0], all these features are now available to everyone: |
| 59 | + |
| 60 | +<div class="mdx-columns" markdown> |
| 61 | + |
| 62 | +- [x] [Blog plugin: pinned posts] |
| 63 | +- [x] [Instant previews] |
| 64 | +- [x] [Footnote tooltips] |
| 65 | +- [x] [Tags plugin: advanced settings] |
| 66 | +- [x] [Tags plugin: nested tags] |
| 67 | +- [x] [Tags plugin: shadow tags] |
| 68 | +- [x] [Stay on page when switching languages] |
| 69 | +- [x] [Blog plugin: author profiles] |
| 70 | +- [x] [Blog plugin: advanced settings] |
| 71 | +- [x] [Projects plugin] |
| 72 | +- [x] [Instant prefetching] |
| 73 | +- [x] [Social plugin: custom layouts] |
| 74 | +- [x] [Social plugin: background images] |
| 75 | +- [x] [Code range selection] |
| 76 | +- [x] [Code annotations: custom selectors] |
| 77 | +- [x] [Privacy plugin: advanced settings] |
| 78 | +- [x] [Optimize plugin] |
| 79 | +- [x] [Navigation path] (Breadcrumbs) |
| 80 | +- [x] [Typeset plugin] |
| 81 | +- [x] [Privacy plugin: external links] |
| 82 | + |
| 83 | +</div> |
| 84 | + |
| 85 | + [Optimize plugin]: ../../plugins/optimize.md |
| 86 | + [Navigation path]: ../../setup/setting-up-navigation.md#navigation-path |
| 87 | + [Blog plugin: advanced settings]: ../../setup/setting-up-a-blog.md#advanced-settings |
| 88 | + [Blog plugin: author profiles]: ../../setup/setting-up-a-blog.md#adding-author-profiles |
| 89 | + [Blog plugin: pinned posts]: ../../setup/setting-up-a-blog.md#pinning-a-post |
| 90 | + [Instant prefetching]: ../../setup/setting-up-navigation.md#instant-prefetching |
| 91 | + [Typeset plugin]: ../../plugins/typeset.md |
| 92 | + [Footnote tooltips]: ../../reference/footnotes.md#footnote-tooltips |
| 93 | + [Privacy plugin: external links]: ../../plugins/privacy.md#external-links |
| 94 | + [Privacy plugin: advanced settings]: ../../setup/ensuring-data-privacy.md#advanced-settings |
| 95 | + [Instant previews]: ../../setup/setting-up-navigation.md#instant-previews |
| 96 | + [Social plugin: custom layouts]: ../../setup/setting-up-social-cards.md#customization |
| 97 | + [Social plugin: background images]: ../../plugins/social.md#option.background_image |
| 98 | + [Code range selection]: ../../reference/code-blocks.md#code-selection-button |
| 99 | + [Code annotations: custom selectors]: ../../reference/code-blocks.md#custom-selectors |
| 100 | + [Stay on page when switching languages]: ../../setup/changing-the-language.md#stay-on-page |
| 101 | + [Projects plugin]: ../../plugins/projects.md |
| 102 | + [Tags plugin: nested tags]: ../../setup/setting-up-tags.md#nested-tags |
| 103 | + [Tags plugin: shadow tags]: ../../setup/setting-up-tags.md#shadow-tags |
| 104 | + [Tags plugin: advanced settings]: ../../setup/setting-up-tags.md#advanced-settings |
| 105 | + |
| 106 | +!!! tip "[mkdocstrings Insiders is now free] as well" |
| 107 | + |
| 108 | + 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! |
| 109 | + |
| 110 | + [mkdocstrings Insiders is now free]: https://pawamoy.github.io/posts/sunsetting-the-sponsorware-strategy/ |
| 111 | + [Timothée joining the Zensical team]: zensical.md#were-growing-our-team |
| 112 | + [mkdocstrings]: https://mkdocstrings.github.io/ |
| 113 | + |
| 114 | +## How to upgrade |
| 115 | + |
| 116 | +You can upgrade with the following command: |
| 117 | + |
| 118 | +``` |
| 119 | +pip install --upgrade mkdocs-material |
| 120 | +``` |
| 121 | + |
| 122 | +## Switching from Insiders |
| 123 | + |
| 124 | +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. |
| 125 | + |
| 126 | +__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.__ |
| 127 | + |
| 128 | +Thus, please adjust your `requirements.txt` and GitHub Actions workflows: |
| 129 | + |
| 130 | +```diff |
| 131 | +- pip install git+https://${GH_TOKEN}@github.com/squidfunk/mkdocs-material-insiders. git |
| 132 | ++ pip install mkdocs-material |
| 133 | + |
| 134 | +``` |
| 135 | + |
| 136 | +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. |
| 137 | + |
| 138 | +- __On February 1, 2026, this message will be turned into a warning__. |
| 139 | +- __On May 1, 2026, the Insiders repository will be deleted__. |
| 140 | + |
| 141 | +## Sunsetting preparation |
| 142 | + |
| 143 | +Entering [maintenance mode], we're preparing Material for MkDocs for sunsetting. |
| 144 | + |
| 145 | +!!! warning "Material for MkDocs is now in maintenance mode" |
| 146 | + |
| 147 | + 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. |
| 148 | + |
| 149 | + If documentation plays a critical role in your organization, and you're worried how this might affect your business, consider joining [Zensical Spark](https://zensical.org/spark/), or feel free to schedule a call by reaching out at contact@zensical.org. |
| 150 | + |
| 151 | + [MkDocs unmaintained]: https://github.com/squidfunk/mkdocs-material/discussions/8461 |
| 152 | + |
| 153 | +### Deprecations |
| 154 | + |
| 155 | +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. |
| 156 | + |
| 157 | +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. |
| 158 | + |
| 159 | +__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].__ |
| 160 | + |
| 161 | + [Zensical Spark]: https://zensical.org/spark/ |
| 162 | + [sub-project support]: https://zensical.org/about/roadmap/#subprojects |
| 163 | + [internationalization]: https://zensical.org/about/roadmap/#internationalization |
| 164 | + [versioning]: https://zensical.org/about/roadmap/#versioning |
| 165 | + |
| 166 | +### Version ranges |
| 167 | + |
| 168 | +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. |
| 169 | + |
| 170 | +### Security |
| 171 | + |
| 172 | +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. |
| 173 | + |
| 174 | +Thus, if you wish to take on maintenance of Material for MkDocs, please create a fork. |
| 175 | + |
| 176 | +## Looking ahead |
| 177 | + |
| 178 | +### Achieving sustainability |
| 179 | + |
| 180 | +Where Material for MkDocs relied on sponsorware, Zensical takes a new approach, |
| 181 | +to ensure it evolves to meet the needs of organizations building complex, enterprise-scale documentation. |
| 182 | + |
| 183 | +[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. |
| 184 | + |
| 185 | +Reach out at contact@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. |
| 186 | + |
| 187 | + [Zensical Spark]: https://zensical.org/spark/ |
| 188 | + [structured design process]: https://zensical.org/spark/methodology/#our-approach |
| 189 | + |
| 190 | +### Our commitment to you |
| 191 | + |
| 192 | +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]. |
| 193 | + |
| 194 | +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. |
| 195 | + |
| 196 | +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. |
| 197 | + |
| 198 | +_You can subscribe to [our newsletter] to stay in the loop_. |
| 199 | + |
| 200 | + [Zensical is compatible with Material for MkDocs]: zensical.md#maximum-compatibility |
0 commit comments