Strapi 5 uses koa-body v6

Strapi 5 uses koa-body v6, which updates formidable to v2. This means uploaded files have new properties.

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

🤖 Is this breaking change automatically handled by a codemod?	No

Breaking change description

In Strapi v4

A user might create custom endpoints and handle files with the ctx object:

const endpoint = (ctx) => {
    ctx.request.files.fileName.path
    ctx.request.files.fileName.name
    ctx.request.files.fileName.type
}

In Strapi 5

A user might still create custom endpoints and handle files with the ctx object, but the property names are different:

const endpoint = (ctx) => {
  ctx.request.files.fileName.filepath
  ctx.request.files.fileName.originalFilename
  ctx.request.files.fileName.mimetype
}

Migration

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

Notes

• The official koa-body documentation lists the changes.
• The official formidable documentation lists the changes.

Manual procedure

Users need to manually update the properties used in their custom code, referring to the official koa-body and formidable documentations.