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

Components and dynamic zones should be populated using the detailed population strategy (on fragments)#

In Strapi 5, components and dynamic zones must be explicitly populated using on fragments instead of the shared population strategy supported in v4.

In Strapi 5, components and dynamic zones should be populated using the detailed population strategy, with on fragments. The shared population strategy possible in Strapi v4 is no longer supported.

Breaking change description#

In Strapi v4

You could use either to populate components and dynamic zones in a REST API call.

In Strapi 5

You must use on fragments to explicitly detail which components and dynamic zones to populate.

Migration#

Notes#

Additional information on population is available in the REST API documentation.

Manual procedure#

Users should ensure that components and dynamic zones are explicitly populated using on fragments, such as in the following example syntax and URL:

• example generic syntax:

  populate[dynamic-zone-name][on][component-category.component-name]=true

• example URL:

  /api/articles?populate[dynamic-zone-name][on][component-category.component-name]=true