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 framework (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.

6.8.0

New content

Repository

• Contextual AI for codeblocks
• Add AI Toolbar
• Add starter questions to Kapa AI modal

Chore, fixes, typos, and other improvements

Repository

• Fix the strapi/strapi contributing link

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.7.0

New content

CMS

• Open API spec generation

Updated content

CMS

• Update Admin Panel and Homepage customization pages with new widgets and new guided tour UI
• Update controller sanitization
• Document flat archive structure for import and export

Chore, fixes, typos, and other improvements

CMS

• Fix no search results for db.query
• Fix typo in lifecycle functions documentation

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.6.6

New content

CMS

• Add experimental firstPublishedAt configuration
• Update admin panel doc to add new 'Reset guided tour' setting

Cloud

• Transfer ownership feature in Strapi Cloud docs
• Download backup on Strapi Cloud

Updated content

CMS

• Clarify database vs. filename usage in database configuration
• Database configuration: callout with information on data.db path
• Expand service docs to mention methods wrap core methods from Document Service API
• Clarify Content Manager API typing
• Note in Server about keep alive configuration
• Improve PostgreSQL database config. example
• Improve environment variables page
• Add advanced queries and policies guides to GraphQL docs

Chore, fixes, typos, and other improvements

CMS

• Fix 'v4CompatibilityMode' typo for Strapi 5 migration in step by step guide
• Fix 'v4CompatibilityMode' typo for Strapi 5 migration

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.6.5

New content

Cloud

• Async project creation on Strapi Cloud

Updated content

CMS

• Improve GraphQL queries explanations (Flat vs. Relay-style)
• Explain there's only one GraphQL endpoint and how to customize its URL
• GraphQL & REST API: more information on operators & more examples
• Update Preview feature docs to mention Desktop/Mobile switch
• Better explain the move to documentId
• Expand and improve Client docs
• Mention that the Document Service API findOne returns null if no document found

Chore, fixes, typos, and other improvements

Repository

• Fix MermaidWithFallback diagram display
• Fix tabs display with long labels

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.6.4

Updated content

CMS

• Add callout about overriding image function in Plugins extension docs
• Extend strapi.console documentation
• Document pluginOptions in Models
• Improve strapi-generate docs further
• Expand strapi generate documentation
• Document release statuses in Releases feature page

Cloud

• Add cancellation section in Cloud docs

Chore, fixes, typos, and other improvements

CMS

• Add mention about building the website in Quick Start Guide

Cloud

• Update Strapi Cloud settings screenshots

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.6.3

Updated content

Cloud

• Canny widget

Chore, fixes, typos, and other improvements

CMS

• Fix incorrect wording in the description of the findOne() method
• Fix broken line breaks in step-by-step file
• Fix strapi network mismatch issues in Docker instructions

Repository

• Fix duplicate footer
• Fix Amplitude tracking experiment CDN

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.6.2

Updated content

CMS

• Conditional Fields (stable release)

Chore, fixes, typos, and other improvements

CMS

• Remove duplicated sections in Preview docs
• Use new notation for accessing plugin config

Repository

• New tooltips in table of content

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.6.1

New content

CMS

• Add repeatable components/Document Service API breaking change

Chore, fixes, typos, and other improvements

CMS

• Add link to blog article about webhooks and Next.js

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.6.0

New content

CMS

• Conditional Fields (beta)

Chore, fixes, typos, and other improvements

Repository

• Add tip about using copy markdown button and LLMs.txt files
• Expandable card docs wrapper
• Add configuration parameter to allow Kapa analytics
• Add inline property to custom Badge component
• Increase "Ask AI" modal width to 720px

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.5.0

New content

Repository

• Add LLMs.txt and LLMs-full.txt generation

We've started adding llms.txt support to the Strapi Docs. You can find the files in the footer or access them directly via the following links:

• llms.txt
• llms-full.txt

Updated content

CMS

• Update app creation flow to include Growth free trial

Chore, fixes, typos, and other improvements

CMS

• Admin Panel API typo in example

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.4.0

This release marks some significant additions and rewrites. We've rethought the dev-related content in the CMS docs, with a clearer table of contents for the development, configuration, and customization aspects of Strapi.

We've also added a handy Copy Markdown button to the navigation bar on the right, so you can easily copy & paste raw Markdown content from the page into your favorite LLM!

Enjoy, and watch out for more AI-related features soon 👀

New content

Repository

• Add "Copy Markdown" button

Updated content

CMS

• Dev-related content rework, iteration #2 (admin panel configuration and customization)
• Dev-related content rework, iteration #1
• Content-type Builder revamp (stable release)

Chore, fixes, typos, and other improvements

Cloud

• Cloud Free plan edits for CMS docs

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.3.1

Updated content

Cloud

• Free Cloud plan

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.3.0

New content

CMS

• Homepage API

Chore, fixes, typos, and other improvements

CMS

• Remove Node 18 support and misc. cleanup
• Remove obsolete version attribute from Docker guide
• Viewable API tokens in the admin panel

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.2.2

Updated content

CMS

• Content-type Builder revamp (beta release)

Chore, fixes, typos, and other improvements

CMS

• Update theme extension (colors) in admin panel customization

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.2.1

Updated content

CMS

• Add Guideflows to feature pages

Chore, fixes, typos, and other improvements

CMS

• Display required version for audit logs, data export and import, and relations reordering
• Add link to external guide about deploying Strapi on Azure
• Fix screenshot description in Cloud projects overview

Cloud

• Fix various Cloud docs typos

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.2.0

Updated content

CMS

• Rewrite Custom fields documentation as a feature page
• Add files to Strapi Client docs

Repository

• Move contribution link to secondary table of contents on larger viewports
• New tabs design

Chore, fixes, typos, and other improvements

CMS

• Fix plugin init command
• Remove unused plugins files
• Update suggested npm production Dockerfile

Cloud

• Add caution about custom domains and Strapi Cloud assets URLs

Repository

• Fix identity cards design

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.1.0

Chore, fixes, typos, and other improvements

CMS

• New design for features & plugins identity cards
• Fix issue #2378
• Update SSO badge style
• Add missing factory method in TypeScript development example

Repository

• Fix key token color in code blocks

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.0.1

Chore, fixes, typos, and other improvements

CMS

• Improve cors documentation
• fix broken link in preview.md
• Update step-by-step.md for Strapi 5 migration
• Add cross links for admin panel configuration and customization
• Unhide Testing page

Cloud

• Adding a small note about Cloud sidegrade and display new ui

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.0.0

New content

CMS

• Add Design System breaking changes summary

Updated content

CMS

• Add custom logo doc in Admin Panel page + link in Admin Panel Customi…
• Preview: Side panel (stable, CMS)

Cloud

• Various Cloud docs updates

Chore, fixes, typos, and other improvements

Repository

• Add support for dark mode to new homepage cards

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.0.0-beta.5

Chore, fixes, typos, and other improvements

Repository

• Fixes AI button blurry box shadow

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.0.0-beta.4

Updated content

CMS

• Update Content Manager to mention editing relations on the fly
• Preview: Side panel

Chore, fixes, typos, and other improvements

Repository

• Improve homepage "Ask AI" button effect
• Third draft of iteration #1 for new homepage
• Second draft of iteration #1 for new homepage

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.0.0-beta.3

Updated content

Strapi Cloud

• New Cloud plans (CMS docs)

Chore, fixes, typos, and other improvements

Repository

• First draft of Iteration #1 for new homepage
• Apply <ExternalLink /> component where necessary
• Fix pagination_next values
• Mention lifecycle hooks blog article
• Mention blog article about lifecycle functions

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.0.0-beta.2

Updated content

CMS

• Add missing TypeScript pages
• Mention codemods on breaking changes pages

Chore, fixes, typos, and other improvements

CMS

• Remove integration guides

Repository

• Mermaid fallback
• Update release notes script
• Add ExternalLink custom component

---

This release was made possible thanks to the following contributors. Thank you! 🫶

6.0.0-beta.1

Version 6.0.0 of Strapi Docs is the biggest rewrite of documentation to date!
This release includes:

• Merge of Dev Docs & User Guide: You now have one documentation per Strapi product: CMS and Cloud.
• New Features section & pages: Everything feature-related is in the new “Features” section of the CMS doc's navigation and each feature is now fully documented in one page.
• Simplified navigation: Many users reported frustration because of the too many levels and inconsistent behaviours in the navigation—both issues have been fixed and the navigation design has been improved for better readability.
• More visuals throughout the docs: We're slowly adding new interactive demos in pages to offer another way to learn about Strapi. Check out Admin Panel, Content Manager, and Content-type Builder pages to try the demos!

Feel free to share your feedback!

New content

CMS Docs

• CMS folder reorganization
• New CMS documentation - More improvements & additions
• Proofread & improve CMS docs pages - pt. 2
• Proofread & improve CMS docs pages - pt. 1
• RBAC & SSO (Dev Docs) rework for CMS Docs
• New Features pages with User Guide content
• New Features pages with Dev Docs content
• CMS Docs (alpha)

Chore, fixes, typos, and other improvements

• 🎨 More design fixes for CMS Docs
• 🎨 Design fixes for the new design
• 🎨 New design

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.8.0

New content

Repository

• Add a guide on how to create components for plugins

Updated content

Cloud

• Project settings: Variables page revamp (pt. 2)

Repository

• Add use case for handling database migrations with TypeScript
• Add Email plugin ratelimiting configuration options

Chore, fixes, typos, and other improvements

Cloud

• Add callout for downgrade/upgrade Cloud plans

Repository

• Fix broken link to Strapi client README
• Fix missing location for content-type generation command in Store and Access Data (plugins dev) guide
• Fix Node versions in installation snippet
• Convert example in Store and Access Data guide from ES to DS

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.7.0

Updated content

Dev Docs & User Guide

• Preview: Side panel

User Guide

• Update Content Manager to mention editing relations on the fly

Strapi Cloud

• Strapi Cloud settings: Environment Variables revamp

Chore, fixes, typos, and other improvements

Strapi Cloud

• Use new Cloud plans screenshot

Repository

• Added disabled option for LiveEditor so that it does not steal focus - Closes issue #2409

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.6.3

Updated content

Dev Docs

• Enhanced webhooks docs

Strapi Cloud

• New Cloud plans

Chore, fixes, typos, and other improvements

Dev Docs

• Fix descriptions for database parameters in CLI installation

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.6.2

Updated content

Dev Docs

• Setting up local plugin in Strapi without the Plugin SDK

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.6.1

Chore, fixes, typos, and other improvements

Dev Docs

• Update admin-panel-api.md

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.6.0

New content

Dev Docs

• Strapi Client library

Updated content

Dev Docs

• Pregenerated API tokens

Chore, fixes, typos, and other improvements

Dev Docs

• Rename SDK to Client in files and diagrams
• Add missing TypeScript version to Admin Panel API code example

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.5.4

Chore, fixes, typos, and other improvements

Dev Docs

• Update Doc Service API middleware example

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.5.3

Chore, fixes, typos, and other improvements

Dev Docs

• Fix incorrect import of unstable_useContentManagerContext in Helper-plugin migration reference
• Fix typo in v4 → v5 step-by-step for GraphQL plugin
• Fix bug in the middlewares example
• Fix populate examples for Document Service API

Strapi Cloud

• Add last successful deployment’s date of the Production environment

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.5.2

Chore, fixes, typos, and other improvements

Dev Docs

• Add graphQL landingPage configuration and update Apollo playground to sandbox
• Add the --verbose option to the data transfer command description
• Removing the note about unmodified fields on the update
• Fix typo in admonition
• Fix Document Service API example typo

Strapi Cloud

• Update Cloud backups (restoration timestamp)
• Add the SSO badge for the new, paid add-on
• Update text for add environment button

Repository

• Add Amplitude's browser SDK and web experiment for future A/B testing

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.5.1

Chore, fixes, typos, and other improvements

User Guide

• Update User Guide intro. for stable new homepage

Dev Docs

• Fix typo in react-router-dom-6.md
• Use yarn/npm tabs in Strapi CLI examples

Strapi Cloud

• Remove account preferences section from cloud docs

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.5.0

The Strapi Docs website now has a brand new design! We hope you like it as much as we loved creating it. Please feel free to share your feedback.

Updated content

User Guide

• Mention new admin panel homepage and update screenshots

Chore, fixes, typos, and other improvements

Dev Docs

• fix locale prerequisites
• fix wrong import
• Fix SDK plugin init command example in the SDK reference
• SDK beta callout

Strapi Cloud

• Add section about importing env vars
• Adding notes about GitLab groups

Repository

• Update docs content for Preview switching from beta to stable

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.4.0

New content

Repository

• First iteration of Growth plan

Chore, fixes, typos, and other improvements

Dev Docs

• Add a cross-link to the "commonly asked questions" about Strapi 5 article from the blog
• Add watchIgnoreFiles demo
• Fix unit testing docs for Strapi 5
• Mention Preview is under a feature flag

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.3.0

New content

Dev Docs

• Setting up the Preview feature

User Guide

• Previewing content in the Content Manager

Updated content

Strapi Cloud

• Rename a project

Chore, fixes, typos, and other improvements

Dev Docs

• Update cross-link to U&P plugin from dev docs routes documentation

Strapi Cloud

• Update Cloud plans screenshot

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.2.2

Chore, fixes, typos, and other improvements

Dev Docs

• Collapse prerequisites and display step 1 in Quick Start Guide

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

• Add strapi cloud environment link to Cloud CLI
• Add new Cloud regions

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

• Update credit cards handling

Repository

• Add release notes script

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.2.0

New content

Dev Docs

• Add WIP API Reference and Guides for TypeScript

Updated content

Dev Docs

• Add Knex Config function support

User Guide

• Integration between the Releases and Review Workflows features

Chore, fixes, typos, and other improvements

Cloud

• Minor Cloud Docs changes
• Remove Strapi 5 warning for Cloud in FAQ
• Move custom cloud provider config warnings higher

Dev Docs

• Fix example request for update method in Document Service API

Repo

• Align navbar search box with 100% width

---

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

• Update cloud deployment logs screen
• Update confirmation modal text in Cloud Update Repository

Repository

• Restore bigger font-size for categories title in sidebar

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.1.1

Updated content

Strapi Cloud

• List environments with Cloud CLI

Dev Docs

• publicationAt breaking change

Chore, fixes, typos, and other improvements

Strapi Cloud

• Update wording on purchasable extra Seats

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

• Update LICENSE

---

This release was made possible thanks to the following contributors. Thank you! 🫶

5.1.0

New content

Cloud Docs

• Multi-Environments

Updated content

User Guide

• Mention Blocked status for Releases

Dev Docs

• Clarify helper-plugin migration guide

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

• Updated screenshots & last updates in User Guide
• Releases settings

Cloud Docs

• Port existing Cloud docs content from v4 website to website
• Make main categories clickable in breadcrumbs

Global

• AI widget
• Tagging system
• New homepage

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

• Make main categories clickable in breadcrumbs

Chore, fixes, typos, and other improvements

• AI bot improvements

---

This release was made possible thanks to the following contributors. Thank you! 🫶