Skip to main content

publicationState is removed and replaced by status

In Strapi 5, the Draft & Publish feature has been reworked, and the Content API, including REST API, GraphQL API, and Document Service API accept a new status parameter.

This page is part of the breaking changes database and provides information about the breaking change and additional instructions to migrate from Strapi v4 to Strapi 5.

Is this breaking change affecting plugins?Yes

Breaking change description​

In Strapi v4

publicationState is used and accepts the following values:

  • live returns only published entries,
  • preview returns both draft entries & published entries.

In Strapi 5

status is used and accepts the following values:

  • draft returns the draft version of a document,
  • published returns the published version of a document.

Migration​

This section regroups useful notes and procedures about the introduced breaking change.

Notes​

There are no fallbacks to return by default the published version, and return the draft version if no published version is found.

Migration procedure​

A codemod will automatically handle the change.