5.63.0 (2026-11-18)
⚠️ Changes to be aware of
Some filters that used to return every entry now return 400
A plain object as an operator's operand on a scalar or JSON field, id or documentId (for example filters[meta][$eq][a]=1) used to drop the condition and return every entry. It now returns a 400 ValidationError. REST lists longer than the strapi::query middleware's arrayLimit (100 by default), such as filters[id][$in] with 101 ids, now also return this 400. To accept longer lists, replace 'strapi::query' in config/middlewares with { name: 'strapi::query', config: { arrayLimit: 500 } }.
Long $or and $and lists now return 400
A REST $or or $and list longer than arrayLimit (100 by default), or one with an index of 100 or more such as filters[$or][100], used to drop the condition and return every entry. It now returns a 400 ValidationError. Raise arrayLimit as above if you need longer lists. An object operand such as filters[$or][title]=x now returns 400 instead of a server error.
(#28563)
Empty $in and $notIn filters are now applied
A filter such as { id: { $in: [] } } used to be stripped, so the query returned every entry. It now returns none, and $notIn: [] returns every entry. If your code builds $in lists that can be empty, check the results it now gets.
(#27850)
$null and $notNull now accept only boolean values
Content API $null and $notNull now accept only true, t, 1, false, f and 0, in any case. FALSE and no used to be read as true. FALSE now means false, and no, yes, null, an empty value or any other value returns 400. A bare filters[price][$null] still reads as false. In strapi.db.query, { $null: 'false' } now means IS NOT NULL (it meant IS NULL), and unknown values throw InvalidBooleanError. MCP list_* tools now take only true or false for these operators.
(#28513)
TypeScript: component filters are now type-checked like content type filters
Unknown keys, password attributes and documentId in a component filter no longer compile. Inside a component, a relation, media or component attribute takes { id: 5 } or one operator such as { $eq: 5 }, not a bare 5. Reading a component filter with a string key (filters.seo?.[key]) no longer compiles under noImplicitAny, so type the key as a union of the component's attribute names. Runtime behavior is unchanged.
(#28518)
Media connect and disconnect now change the field instead of replacing it
In the Content API, the Document Service and strapi.db.query, { connect: [] }, { disconnect: [] } and {} used to clear a media field. They now leave it unchanged, so to clear a field send null or { set: [] }. connect on a single media field now replaces the file, and creating an entry with { connect: [id] } now attaches it. A bare { set: null } still clears a media field. The admin panel is not affected.
(#27116)
A relation to a disabled plugin's content type now fails boot
An inverse-side (mappedBy) relation to a content type from a disabled or uninstalled plugin used to cause a TypeError at boot, or 500 errors later in the Content Manager and on publish. Boot now fails with Metadata for "<uid>" not found. Enable the plugin again, or remove the relation attribute from the content type's schema.json.
(#28542)
An inverse relation with no owner now fails boot
An inverse-side (mappedBy) relation that no owner points back to used to boot, but it stored nothing. Boot now fails with mappedBy attribute <mappedBy> in <target> must be a relation to <uid> with inversedBy "<attribute>". Add inversedBy: "<attribute>" to the owner relation on the target, or remove the inverse attribute. There is no warning-only step first, so this can also hit third-party plugins.
(#28561)
Content-Type Builder services now reject displayName: null on edit
editContentType, and updateSchema with action: 'update', used to keep the stored name when given displayName: null. They now throw "A content type requires a displayName". Omitting displayName still keeps the stored name. generateAPI and component creation also throw when the name is missing or empty. Only code that calls these services directly is affected, because the admin and the HTTP routes already rejected these values.
(#28598)
TypeScript: editComponent now takes the Content-Type Builder input shape
The editComponent payload is now typed as Content-Type Builder input, with displayName, category and icon at the top level. Passing a loaded Struct.ComponentSchema through @strapi/content-type-builder/strapi-server no longer compiles. That call already wrote a component with no displayName. strapi.plugin('content-type-builder').service('components') is unaffected.
(#28529)
Editor and Author roles on existing projects still have no access to localized content
On a new database, the default Editor and Author roles now get the default locale on localized content types. Projects whose default roles already exist keep them as they are, with no locale and so no access to localized content. Select the locales in Settings > Roles to give these roles access. The boot warning about removed permissions now gives the reason for each removal.
(#28624)
Permissions for every locale are no longer deleted at start
Role permissions saved through the admin API with locales: null (every locale) on localized content types were deleted at every start when locales was the action's only property, as with Content Manager delete and publish. They are now kept. Permissions already deleted are not restored, so grant them again.
(#28629)
AI metadata jobs: a crash now fails the job after about 2 minutes
A running AI metadata generation job is now marked as failed about 2 minutes after its server crashes, once its heartbeat goes stale. Before, it was marked failed when the server restarted. During a rolling upgrade, a server still on the old version fails the running job and drops the new heartbeat_at_ms column. Upgrade while no generation job runs, or start the job again afterwards.
(#28622)
entityService.loadPages now honours start and limit
A loadPages call that passes start or limit, without page or pageSize, used to ignore them and return the first 10 entries. It now returns the requested entries with { start, limit, total }, so pagination.page and pagination.pageCount are undefined. The Content Manager is not affected.
(#28661)
🚀 New feature
- i18n: add Arabic (ar) translations for 8 admin packages (#28011)
- strapi: make develop --open and --no-open control the admin browser (#28521)
- tests: test plugin for the /tests-next apps (8802c6c5e9)
- upload: add read-only folders routes to the content API (1e52b2f4e9)
- upload: validate a folder param for content API uploads (#28500)
🔥 Bug fix
- admin: premature submission on ime confirmation (#28029)
- admin: remove every stale permission in one boot cleanup run (#28585)
- admin: skip the upgrade banner for 0.0.0 prerelease builds (#28594)
- admin: escape token names in cleanup warnings (#28589)
- admin: ?fields naming a field the role cannot use fails with 400 on content manager routes (#28599)
- admin: keep locales: null permissions during the boot cleanup (#28623)
- admin: answer 404 when updating a missing admin user with a password (#28664)
- admin: declare permission getProperty result as unknown (#28666)
- admin: keep locales: null only when no other applicable property is missing (#28629)
- admin: skip unknown ids in admin users batch delete (#28669)
- admin: first boot removes the default Editor and Author permissions on localized types (#28624)
- ci: fail aggregate_test_result when the conditions job fails (7b15e018bf)
- content-manager: show "Untitled" for an empty recent document title (#28551)
- content-manager: routes pass a null or empty locale to the document service (#28555)
- content-manager: live preview fails to hydrate because the preview script rewrites the page (#28112)
- content-manager: fall back on uid generation when the target slugifies to nothing (#28592)
- content-manager: non-localized entries store the body locale (#28600)
- content-manager: keep the block's text when inserting an image in the Blocks editor (#28428)
- content-manager: stop passing a null locale to the preview handler (#28671)
- content-releases: revalidate non-localized entries (#28640)
- content-releases: revalidate non-localized entries (#28640)
- content-releases: clearer schedule sort labels and default (#28642)
- content-releases: release names with control characters split publish log lines (#28633)
- content-type-builder: type the editComponent payload as the admin input (#28529)
- content-type-builder: answer 400 when PUT /components/:uid fails to write (#28559)
- content-type-builder: type validateUpdateComponentInput with the component input type (#28558)
- content-type-builder: reject direct schema edits with a missing or empty displayName (#28598)
- content-type-builder: failed component and category writes answer a success and leave stray files (#28591)
- core: keep media operation overrides when cloning (fe82482098)
- core: keep links owned by the published version when republishing (#28499)
- core: honour offset pagination in entityService.loadPages (#28661)
- core: run document service writes in a savepoint inside a transaction (#28647)
- create-strapi-app: fall back to the default sqlite file when --dbfile is empty (#28590)
- database: fail boot clearly when an inverse relation targets a missing model (#28542)
- database: slow update of documents with thousands of relations (#28546)
- database: make relation connect ordering linear (#28447)
- database: honour connect/disconnect deltas on media morph relations (#27116)
- database: add configurable query timeout to cancel abandoned queries (#27669)
- database: fix Postgres and MySQL bugs and run API tests on their databases (#28431)
- database: fail boot when no owner points back to an inverse relation (#28561)
- database: read $null and $notNull filter operands strictly (#28513)
- database: loadPages type accepts field arrays and returns any (#28130)
- database: publish a draft and publish entry with a morphMany relation (#28471)
- database: update links every inverse morphMany entry and honours connect (#28520)
- database: a bare { set: null } clears an inverse morphMany of a morphToOne again (#28595)
- database: keep loadPages results a list and handle a missing entity (#28659)
- database: throw an explicit error when loadPages gets no params (#28674)
- docs: bump dompurify to 3.4.17 (#28625)
- graphql: disconnected requests keep resolving fields (#28453)
- i18n: narrow the permission subject to a content-type UID (#28665)
- tests: make the test plugin's fake AI provider and its tests match the contract (5d9a370acb)
- tests: fake AI provider follows the content type schema; plugin test fixes (f511b65045)
- tests: let the v4 migration fixture app build sharp and better-sqlite3 (#28657)
- types: declare the koa and lodash type deps of @strapi/types and type the fetch dispatcher (#28516)
- types: filters reject unknown attributes on schemas with only scalar or nested fields (#28518)
- upload: answer 400 when an upload's folder is deleted during the request (#28535)
- upload: answer 4xx instead of 500 when a moved folder or its new parent is missing (#28597)
- upload: fail AI metadata jobs left processing by a server restart (#28581)
- upload: pending-count and create-job contracts declare a { data } envelope never sent (#28593)
- upload: default omitted auto-orientation setting (#28607)
- upload: sort the folder structure once per parent (#28180)
- upload: answer 400 when a parent or move destination folder is deleted mid-request (#28560)
- upload: a restarting server fails an AI metadata job another server still runs (#28622)
- upload: clear skipped markers when retrying a cancelled batch (#28268)
- utils: object operands on scalar filters drop the condition and match every row (#28541)
- utils: object-shaped $or and $and operands drop the condition and match every row (#28563)
- utils: object operands in $not lists and on relation filters match every row (#28613)
- utils: preserve empty $in and $notIn filter operands (#27850)
- utils: $or and $and operands keyed by operators answer 500 or match every row (#28609)
- utils: $or and $and lists on a scalar attribute answer 500 (#28631)
📚 Documentation Changes
- tests: name Vitest as the runner of the api and cli suites (3971f86ec0)
- utils: clarify traverseEntity input types and mutation, pin visitor types (#28550)
⚙️ Chore
- release v5.62.0 update develop (fcc1df0668)
- upgrade yarn to 4.18.1 (#27907)
- replace lodash keys/concat/find with native equivalents (#27457)
- content-manager: drop redundant homepage fields compaction, harden fields query tests (#28634)
- deps: bump hono from 4.13.13 to 4.13.18 (#28621)
- deps: bump minimatch from 10.2.6 to 11.0.1 (#28365)
- deps: bump qs from 6.16.2 to 6.17.0 (#28406)
- deps: bump @graphql-tools/utils from 12.0.3 to 12.0.4 (#28525)
- deps-dev: bump @babel/eslint-parser (#28511)
- eslint: report unused eslint-disable directives (#28129)
- tests: run the /tests-next api and cli suites with Vitest (feb1b2b1e3)
- upload: remove unused prop-types dependency (#27997)
💅 Enhancement
- core: batch component parent lookups in the discard-drafts migration (#27941)
- permissions: build admin abilities without avoidable copies (#28577)
- upload: opt-in pagination for GET /upload/folders (#28181)
- upload: expose read-only folder queries in GraphQL (#28615)
- utils: warn in development when unknown filter keys are dropped (#28540)
❤️ Thank You
- Abdelrahman Kasem @AKasem1
- Adrien L @Adzouz
- Andrea Cappuccio @hood
- Andrei L @unrevised6419
- Arthur Moreau
- Ayesha Waseem @AyeshaWaseemAhmad
- Bassel Kanso
- Ben Irvin
- dmitriy-baltak
- Eryk Baran @gacek1123
- Giulio Montagner @giu1io
- HichamELBSI
- Jamie Howard @jhoward1994
- jasleenkaur-qed42 @jasleenkaur-qed42
- kensukekikuchi-uh
- Maxime Castres @Mcastres
- Nico André
- Paul Bratslavsky @PaulBratslavsky
- Vinay Vinay @Vinay2334