Strapi v4 to Strapi 5 breaking changes

🚧 Work in progress

This page is a work-in-progress and the list of breaking changes is not 100% final yet.

This page lists all the breaking changes introduced in Strapi 5.

❗️ Warning

It is currently strongly advised that you refrain from migrating from Strapi v4 to Strapi 5, especially in a production environment.

The beta version of Strapi 5 is not meant to be used in production yet.

Configuration

• Some env-only configuration options are handled by the server configuration
• Configuration filenames should meet strict requirements
• Server log level is http
• Model config path uses uid instead of dot notation
• The webhooks.populateRelations server configuration is removed

Content API

• Strapi 5 has a new, flattened response format for API calls
• documentId should be used instead of id in API calls
• The publicationState parameter is not supported and replaced by status
• Sorting by id is no longer possible to sort by chronological order
• There is no findPage() method with the Document Service API
• The localizations field does not exist anymore
• The locale attribute name is reserved by Strapi
• The GraphQL API has been updated

Database

• MySQL v5 is not supported anymore
• Database identifiers can't be longer than 55 characters

Plugins, plugins configuration, and plugins development

• Users & Permissions register.allowedFields defaults to []
• The helper-plugin is deprecated
• injectContentManagerComponent() is removed in favor of getPlugin('content-manager').injectComponent()

Strapi objects, methods, and packages

• strapi.fetch uses the native fetch() API
• strapi factories import have changed
• The isSupportedImage method is removed in Strapi 5
• strapi-utils has been refactored
• Core service methods use the Document Service API

Content Manager

• The ContentManagerAppState redux is modified
• The EditViewLayout and ListViewLayout have been refactored

Dependencies

• Vite is the default bundler in Strapi 5
• Strapi 5 uses react-router-dom v6
• Strapi 5 uses koa-body v6
• Webpack Aliases are removed in Strapi 5
• Apollo Server v3 upgraded to Apollo Server v4

Internal changes

The following changes should only affect users who deeply customize Strapi.

• i18n is now part of the strapi core