Release notes
This page lists all the Strapi Docs version numbers and their corresponding updates.
๐ง Strapi Docs version numbers explained:
The Strapi Documentation (Strapi Docs) at docs.strapi.io always documents the latest version of Strapi (CMS and Cloud) products.
Since Strapi Docs version 5.0.0, the docs' version number is independent from the Strapi product version. Thus, the version numbers of strapi/documentation
and strapi/strapi
may differ.
Strapi Docs now follow the semantic versioning philosophy, but adapted to docs:
- Major version (6.0.0, 7.0.0โฆ): A significant rewrite of the docs (content or framework). This may impact the user experience, redesign the site, or break old links (redirections are handled, but broken links can be reported).
- Minor version (5.1.0, 5.2.0โฆ): New Strapi features or improvements to the docs (e.g., new components or tools).
- Patch version (5.1.1, 5.1.2โฆ): Content updates, including improvement or extension of existing pages, code examples fixes, and typos.
New versions (minor or patch) are generally released weekly, on Wednesdays.
5.2.2โ
๐งน Chore, fixes, typos, and other improvementsโ
Dev Docsโ
Strapi Cloudโ
- Design system v2 and new header in cloud docs
- Deleted old cloud assets
- Add restoration timestamp to docs and ressources
This release was made possible thanks to the following contributors. Thank you! ๐ซถ
5.2.1โ
๐ Updated contentโ
๐งน Chore, fixes, typos, and other improvementsโ
Dev Docsโ
- Add useTypescriptMigrations
- Fix typo in retro-compatibility flag value
- Fix typo in example code for injectComponent in Admin Panel API docs
- Fix outdated mention of Gold plan in SSO docs
- Fix locale param. example in Interactive Query Builder
- Fix discardDraft() Document Service API example
Strapi Cloudโ
Repositoryโ
This release was made possible thanks to the following contributors. Thank you! ๐ซถ
5.2.0โ
โจ New contentโ
Dev Docsโ
๐ Updated contentโ
Dev Docsโ
User Guideโ
๐งน Chore, fixes, typos, and other improvementโ
Cloudโ
- Minor Cloud Docs changes
- Remove Strapi 5 warning for Cloud in FAQ
- Move custom cloud provider config warnings higher
Dev Docsโ
Repoโ
This release was made possible thanks to the following contributors. Thank you! ๐ซถ
5.1.3โ
๐งน Chore, fixes, typos, and other improvementsโ
- Improve instructions for upgrading to Apollo v4
- Fix code example in breaking change for new response format
- Update names of removed mutations in GraphQL breaking change
- Fix typo in a snippet used in Cloud docs
This release was made possible thanks to the following contributors. Thank you! ๐ซถ
5.1.2โ
๐ Updated contentโ
Dev Docsโ
- Add support for 'latest' parameter in the upgrade tool
- Add example code and resulting screenshot for theme extension
๐งน Chore, fixes, typos, and other improvementsโ
Strapi Cloudโ
Repositoryโ
This release was made possible thanks to the following contributors. Thank you! ๐ซถ
5.1.1โ
๐ Updated contentโ
Strapi Cloudโ
Dev Docsโ
๐งน Chore, fixes, typos, and other improvementsโ
Strapi Cloudโ
Dev Docsโ
- Clarify sorting for relational fields in the Content Manager list view
- Fix typo for
v4CompatibilityMode
flag - Fix step-by-step v4 โ v5 migration (v4CompatibilityMode flag)
- Update environment declaration in Docker guide
- Fix createStrapi method in TypeScript development documentation
- Fix links in the REST API documentation
- Fix CheckPagePermissions code example in helper-plugin deprecation guide
- Fix typo for init command in Plugin SDK
- Add link to ms package for examples for JWT expiresIn
Repositoryโ
This release was made possible thanks to the following contributors. Thank you! ๐ซถ
5.1.0โ
โจ New contentโ
Cloud Docsโ
๐ Updated contentโ
User Guideโ
Dev Docsโ
๐งน Chore, fixes, typos, and other improvementsโ
Dev Docsโ
- Fix creating a custom provider example
- Fix pagination_next for first page of categories
- Fix SEO issues
- Fix links to strapi codebase
- Fix code example in general deployment guidelines
- Fix grammar in TypeScript development docs
This release was made possible thanks to the following contributors. Thank you! ๐ซถ
5.0.0โ
The following is an extensive list of all the pull requests that were merged since we started working on Strapi 5 documentation. For a quicker tour, please refer to the What's new page.
โจ New contentโ
Dev Docsโ
- Breaking change for database columns
- Content Manager APIs
- Breaking change for removing the "shared population strategy" for components & dynamic zones
- Templates
- Upgrade section revamp
- Custom U&P providers
- Breaking change for server.proxy config
- New "Upgrades" section (replaces updates & migration) for Strapi 5
- New proxy configuration feature
- lockIcon โ licenseOnly breaking change
- Breaking change for default input validation
- Entity Service โ Document Service: Breaking change + migration reference
- Plugins migration summary
- Breaking change for better-sqlite3
- Breaking change for Admin RBAC updates
- Breaking change for model config path uses uid
- Breaking change for upgrade from apollo v3 to apollo v4
- Breaking change for removed
localizations
field - Breaking change for server log level configuration
- Breaking change for the removed webpack aliases
- Breaking change for strict requirements on configuration filenames
- Breaking change about removed support for some env-only options
- Breaking change for no findPage() method in Document Service API
- Breaking change for sorting by id
- Breaking change for Vite as default bundler
- Breaking change for U&P register.allowedFields
- Breaking change for CM redux store
- Breaking change for
strapi.container
- Breaking change for i18n CM locale parameter
- Breaking change for strapi exports
- Breaking change for removal of
isSupportedImage
- Breaking change about react-router-dom 6
- Upgrade tool
- Document Service
- Breaking change for fetch
- Breaking change for MySQL v5 support drop
- Init. breaking changes pages for Strapi v4 โ v5 migration
- New v5 Dev Docs structure
User Guideโ
Cloud Docsโ
- Port existing Cloud docs content from v4 website to website
- Make main categories clickable in breadcrumbs
Globalโ
๐ Updated contentโ
Dev Docsโ
- Remove shared population strategy for dynamic zones
- Update breaking change for default server level log
- Update breaking change for reserved attributes and content-types names
- Update breaking change for
is-supported-image
- Update codemods list
- Update some v5 migration and Plugin SDK docs
- Add more before examples for helper plugin migration
- Plugin migration updates
- Update the Quick Start Guide with Cloud CLI and new CLI prompts
- Update sdk-plugin init with new options
- Update helper plugin migration doc
- Update backend customization examples to Document Service API
- Add scope and warning details to the upgrade tool guide
- More examples for middlewares context to Document Service API
- Deprecate integration guides
- Transfer deployment guides to external resources
- Database lifecycles vs. Document Service middlewares
- Admin panel customization section rework
- Update REST API additional resources with new links and call to write
- Updates to the CLI installation guide
- FAQ section for 'Cannot find module @strapi/XXX' build error
- Update upgrade tool documentation with codemods updates
- Plugin CLI update for @strapi/sdk-plugin package
- Updates to relations in API docs
- Update doc service doc to match latest changes being prepared
- GraphQL updates
- REST API updates (incl. i18n and breaking changes)
- (no-)watch-admin and bundler updates
- Turn the TypeScript page into a section
- New Dev Docs introduction
- Update supported databases
User Guideโ
- Make main categories clickable in breadcrumbs
- Update whole content in User Guide
- Update Draft & Publish
Cloud Docsโ
๐งน Chore, fixes, typos, and other improvementsโ
This release was made possible thanks to the following contributors. Thank you! ๐ซถ