import Intro from '/docs/snippets/breaking-change-page-intro.md'
import MigrationIntro from '/docs/snippets/breaking-change-page-migration-intro.md'

Some attributes and content types names are reserved#

In Strapi 5, certain attribute names like meta, status, entryId, and anything prefixed with strapi are now reserved and cannot be used. Fields and content types using these names in v4 must be renamed before migrating to Strapi 5.

In Strapi 5, some attributes and content types names are reserved, and all fields or content types in Strapi v4 using these reserved names should be renamed before migrating to Strapi 5 to prevent data loss.

Breaking change description#

In Strapi v4

The following attribute names can be created on a content type:

• meta
• status
• entryId
• strapi
• locale (only for non-localized content types)
• localizations
• strapi_assignee
• strapi_stage
• then
• document
• anything with the prefix strapi, _strapi, or __strapi

Any model name can be prefixed with strapi.

In Strapi 5

The following attribute names can not be created on a content type:

• meta
• status
• entryId
• strapi
• locale
• localizations
• strapi_assignee
• strapi_stage
• then
• document
• anything with the prefix strapi, _strapi, or __strapi

Model names can not be prefixed with strapi, _strapi, or __strapi.

Migration#

Manual procedure#

Rename any custom field or content-type that falls under the restriction list before any migration to prevent data loss or other unexpected issues.