PayloadCMS Releases Filter

Jul 3, 2025
v3.45.0 (2025-07-03)

🚀 Features
- mount live preview to document root (#12860) (f2213e5)
- drizzle: support half-precision, binary, and sparse vectors column types (#12491) (583a733)
🐛 Bug Fixes
- disable graphql introspection queries when disableIntrospectionInProduction is true (#12982) (a9580e0)
- strict custom view paths (#12968) (cfc7adc)
- appropriately throw unverified email error (#12933) (9f60306)
- db-mongodb: nested sorting by ID (#13016) (81532cb)
- db-mongodb: add ability to disable fallback sort and no longer adds a fallback for unique fields (#12961) (c902f14)
- db-postgres: joins with hasMany: true relationships nested to an array (#12980) (0e8ac0b)
- drizzle: ensure updateOne does not create new document if where query has no results (#12991) (fafaa04)
- examples: only allow super admins to create users with super admin role (#13015) (6e5ddc8)
- examples: checks requested tenant matches user tenant permissions (#13012) (5002953)
- plugin-import-export: pre-scan columns before streaming CSV export (#13009) (34c3a51)
- plugin-import-export: preview table to include all selected columns regardless of populated data (#12985) (335af1b)
- plugin-multi-tenant: unnecessary modal appearing (#12854) (16f5538)
- templates: wrong link in demo content (custom components) (#13024) (f70c6fe)
- ui: save nested richtext inside inlineBlock (#12773) (babcd59)
- ui: autosave infinite loop within document drawer (#13007) (b40c581)
- ui: field bulk upload showing stale data (#13006) (9ba740e)
- ui: prevent document drawer from remounting on save (#13005) (c80b6e9)
- ui: bulk upload redirecting to relationship documents when added (#13001) (a9ad7c7)
- ui: skip disabled fields when adding OR filter conditions in list view (#13004) (7a40a9f)
- ui: render preview sizes button when adjustments are disabled but image sizes are defined (#12999) (b1ae749)
- ui: block rows unexpectedly collapse and array rows not collapsed on init (#12987) (3f30a2e)
- ui: prevent error if rows is undefined in mergeServerFormState (#12962) (6f6d305)
🎨 Styles
- richtext-lexical: ensure error state is shown at small-break (#12827) (ac19b78)
🧪 Tests
- reduce queue test amount (#13008) (57d00ad)
- fix multi-tenant flakes (#12983) (c07187d)
📝 Templates
- fix pnpm 10 ignored build scripts warning (#12974) (463c975)
⚙️ CI
- template errors not being caught due. fix: error due to updated generated-types User type (#12973) (4458f74)
🏡 Chores
- fix payload bundle script (#13022) (e6b6642)
🤝 Contributors
- Patrik (@PatrikKozak)
- Sasha (@r1tsuu)
- Sebastian Blank (@blankse)
- Alessio Gravili (@AlessioGr)
- Germán Jabloñski (@GermanJablo)
- Jessica Rynkar (@jessrynkar)
- Jacob Fletcher (@jacobsfletch)
- Jarrod Flesch (@JarrodMFlesch)
- Said Akhrarov (@akhrarovsaid)
- Paul (@paulpopus)
Jun 27, 2025
v3.44.0 (2025-06-27)

🚨 Notice 🚨

If your project uses the local auth strategy with db-postgres or db-sqlite, a migration is required. This is due to a new security feature (enabled by default) that stores a unique auth session identifier in the database.

To opt out and continue using the previous behavior, you can disable the feature by setting auth.useSessions: false in your users collection config.

For example:
```
// payload.config.ts
collections: [
  {
    slug: 'users',
    auth: {
      useSessions: false,
    },
    fields: [],
  },
],
```
🚀 Features
- auth sessions (#12483) (26d709d)
- collection-level preferences (#12909) (c8b7214)
- collection-level disableBulkEdit (#12850) (a5ec55c)
- plugin-import-export: preview displays CSV and JSON data accurately (#12948) (3830d71)
- templates: added int and e2e tests to blank and website templates (#12866) (87c7952)
🐛 Bug Fixes
- richTextField supports beforeInput/afterInput, but these were missing from types.ts (#12889) (e769550)
- validate "null" value for point field as true when its not required (#12908) (2da6d92)
- get external resource blocked (#12927) (a7ad573)
- restore missing properties to live preview client config (#12904) (bcb10b5)
- uses valid fractional index for test (#12942) (8900a38)
- querying virtual fields deeply with draft: true (#12868) (bc9b501)
- use small pill size when viewing version information (#12844) (6c4dfe4)
- db-mongodb: strip deleted from the config blocks from the result (#12869) (54afaf9)
- db-postgres: joins with custom schema (#12937) (c1f6297)
- db-postgres: querying on hasMany: true select field in a relationship (#12916) (b74969d)
- drizzle: skip column if undefined in findMany (#12902) (605c993)
- live-preview: client-side live preview cannot populate more than 10 relationships at once (#12929) (7472798)
- live-preview: foreign postMessage events reset client-side state (#12925) (67fa5a0)
- next: live preview popup triggers leave without saving modal (#12947) (141133a)
- next: prevent errors in globals version view (#12920) (39e9519)
- next: remove error handling from next auth functions (#12897) (1b5e3fe)
- next: remove console.error from next auth functions (#12881) (fe58f03)
- plugin-import-export: duplicated rows and headers in CSV export when streaming paginated results (#12941) (5cf9287)
- plugin-import-export: csv export for polymorphic relationship fields (#12926) (6d76874)
- plugin-import-export: omit CSV columns when toCSV returns undefined (#12923) (751691a)
- plugin-multi-tenant: updates tenant selector upon tenant creation (#12936) (c76d839)
- richtext-lexical: consistent html converter inline padding (#12848) (11ac230)
- ui: usePreventLeave should not show alert for exceptions (#12722) (c3c1614)
- ui: vertically align table headers to the middle (#12699) (0e9865c)
- ui: properly render create new button in polymorphic joins (#12930) (a1822d2)
- ui: render DateTime label as <label> instead of <span> (#12949) (4b9566f)
- ui: bulk upload losing state when adding additional files (#12946) (d62d9b4)
- ui: unreachable custom views when admin route set to '/' (#12812) (379fc12)
- ui: toggle list selections off on successful bulk action (#12861) (9f17db8)
- ui: align caret on error tooltip for checkbox field (#12917) (c094b0e)
- ui: updates auth fields UI to reflect access control (#12745) (1845669)
- ui: folder server function must reference exports dir (#12898) (0d50799)
- ui: custom row labels on arrays should not be removed on field duplication (#12895) (37c945b)
- ui: date format of useAsTitle lost after changing value (#12928) (20bbbcf)
- ui: properly differentiate between DOM events and raw values in setValue (#12892) (c03e9c1)
- ui: should select document after creation from relationship field (#12842) (25e3902)
- ui: support react node content in ConfirmationModal heading and body (#12841) (dffdee8)
🛠 Refactors
- changed default exports to named exports in payload package (#12871) (053192c)
- remove unused assets, move remaining assets out of payload packages (#12874) (bb17cc3)
- simplify job queue error handling (#12845) (59f536c)
- simplify job type (#12816) (84cb2b5)
📚 Documentation
- remove group from list of default field validations (#12921) (e5e0ec8)
- filterOptions anchor link fix (#12883) (fcaf989)
- fix typo on authentication overview page (#12891) (7a0308f)
- plugin-sentry: add pg query instrumentation guide (#12229) (dede3a4)
🧪 Tests
- bulk edit flaky selectors (#12950) (86e48ae)
- adds test for skipSafeFetch allowList (#12954) (7ebac63)
- guard against null values in custom toCSV functions (#12938) (1cdec86)
- fix database/int.spec.ts with postgres custom schema (#12922) (cf87871)
- fix database integration tests with postgres (#12919) (886c07e)
📝 Templates
- bump for v3.43.0 (#12831) (d1826c6)
📓 Examples
- fix broken navigation to post in localization example (#12810) (6a935d4)
⚙️ CI
- bring back CODEOWNERS file for reviews, approval not required [skip ci] (1db0619)
- revert bump pnpm to v10 (#12840) (#12906) (ca0d036)
- add timeout-minutes for int and e2e (#12903) (c7dc1b4)
- adjust neverBuiltDependencies in test/package.json (#12896) (a44e4c4)
- bump pnpm to v10 (#12840) (85e0e0e)
🏡 Chores
- fix jest global teardown incorrectly always returning process exit status 0 (#12907) (5368440)
- set trimTrailingWhitespace and insertFinalNewline in vscode settings (#12939) (b1a57fa)
- fix withPayload helper jsdoc (#12503) (57f4fb6)
- remove neverBuiltDependencies from test/package.json (4831f66)
- add eslint rule to ignore default exports in test suite configs (#12655) (9c5adba)
🤝 Contributors
- James Mikrut (@jmikrut)
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
- Roman (@spielerx)
- Jesper We (@JesperWe)
- ThijsAtFreave (@ThijsAtFreave)
- Sam Wheeler (@swheeler7)
- Chandler Gonzales (@jcgsville)
- Jessica Rynkar (@jessrynkar)
- Said Akhrarov (@akhrarovsaid)
- Dani Calero 🚀 (@danicaleroo)
- Sasha (@r1tsuu)
- Dan Ribbens (@DanRibbens)
- Patrik (@PatrikKozak)
- Dave Ryan (@dave-wwg)
- Jarrod Flesch (@JarrodMFlesch)
- Kendell (@kendelljoseph)
- Ondřej Závodný (@ozavodny)
- Paul (@paulpopus)
- Ruby Jasmin (@rubyjasmin)
- Anatoly Kopyl (@anatolykopyl)
- Alessio Gravili (@AlessioGr)
- Andrea Ghidini (@ghidosoft)
- Adler Weber (@adlrwbr)
- Marcus Michaels (@marcusmichaels)
- Philip (@stuckinsnow)
Jun 16, 2025
v3.43.0 (2025-06-16)

🚀 Features
- admin upload controls (#11615) (f2e0422)
- expose data argument in afterChange hook for collections and globals (#12756) (458a04b)
- db-postgres: allow to store blocks in a JSON column (#12750) (215f49e)
- db-postgres: support read replicas (#12728) (0a35737)
- version diff view overhaul (#12027) (4e2e4d2)
- next: reorder document view tabs (#12288) (65309b1)
- storage-s3: dynamic presigned URL downloads (#12706) (865a9cd)
- ui: adds constructorOptions to upload config (#12766) (b372a34)
- ui: moves folder rendering from the client to the server (#12710) (a43d1a6)
🐛 Bug Fixes
- ensure job autoruns are not triggered if jobs collection not enabled (#12808) (769ca03)
- filtering joins in where by ID (#12804) (9943b35)
- change payload.jobs.run and bin script to only run jobs from default queue by default, adds support for allQueues argument (#12799) (06ad171)
- remove unsupported path property from default document view configs (#12774) (f64a0ae)
- field inside an unnamed group field erroring when used as a title (#12771) (143aff5)
- error when saving global with versioning enabled (#12778) (cf43c5c)
- reduce global DOM/Node type conflicts in server-only packages (#12737) (67fb29b)
- orderable has incorrect sort results depending on capitalization (#12758) (37afbe6)
- ensure redirect route is correctly formatted for "Copy to locale" (#12560) (9d2817e)
- db-mongodb: 4x and more level deep relationships querying (#12800) (245a2de)
- db-mongodb: bump mongoose to 8.15.1 (#12755) (860e0b4)
- db-postgres: reordering of enum values, bump drizzle-kit@0.31.0 and drizzle-orm@0.43.1 (#12256) (7045182)
- db-postgres: x3 and more nested blocks regression (#12770) (df8be92)
- db-sqlite: sqlite unique validation messages (#12740) (254ffec)
- plugin-import-export: download button in collection edit view (#12805) (8235fe1)
- plugin-import-export: incorrect custom type on toCSVFunction changed to toCSV (#12796) (3edcc40)
- plugin-import-export: export all available fields by default (#12731) (c4e5831)
- plugin-nested-docs: check error name that is changed at compile time (#12798) (729b676)
- plugin-redirects: add missing optional chaining (#12753) (d0e647a)
- storage-azure: return error status 404 when file is not found instead of 500 (#11734) (018317d)
- storage-gcs: return 404 on file not found instead of 500 (#11746) (d8626ad)
- storage-s3: return error status 404 when file is not found instead of 500 (#11733) (a19921d)
- translations: reformats bnBD and bnIN translation imports to camelCase (#12736) (08fbcb5)
- ui: reordering with a join field inside a group (#12803) (e60db07)
- ui: adjust alignment of list header actions (#12793) (77f3805)
- ui: not showing hyphenated field values in table (#12791) (e7b5884)
- ui: inconsistent pill sizes across admin panel (#12788) (9364d51)
⚡ Performance
- ui: do not re-animate drawer on re-render, reduce useEffects (#12743) (cb3f9bb)
🛠 Refactors
- next: simplify document tab rendering logic (#12795) (53835f2)
- next: simplify document view routing (#12777) (b556fe3)
📚 Documentation
- fix header custom component example (#12801) (7fef589)
- remove outdated buildPath property (#12741) (38652d7)
- add info about localized/built-in validation error messages (#12718) (96f417b)
- fix invalid code block language (#12734) (ebe7fde)
🏡 Chores
- adds filters (#12622) (c04c257)
- remove invalid colon from workspaces key in package.json (#12757) (08d5b2b)
- migrate to TypeScript strict in Payload package - #4/4 (#12733) (53f8838)
- scripts: fix tsconfig.base.json reset (3313ab7)
🤝 Contributors
- Sasha (@r1tsuu)
- Jessica Rynkar (@jessrynkar)
- Alessio Gravili (@AlessioGr)
- Dan Ribbens (@DanRibbens)
- Kendell Joseph (@kendelljoseph)
- Paul (@paulpopus)
- Jacob Fletcher (@jacobsfletch)
- Jayce Pulsipher (@jaycetde)
- Patrik (@PatrikKozak)
- Jarrod Flesch (@JarrodMFlesch)
- Patrick Roelofs (@Patrickroelofs)
- Anders Semb Hermansen (@andershermansen)
- Said Akhrarov (@akhrarovsaid)
- Elliot DeNolf (@denolfe)
- Anyu Jiang (@anyuj)
- Germán Jabloñski (@GermanJablo)
- codeflorist (@codeflorist)
Jun 9, 2025
v3.42.0 (2025-06-09)

🚀 Features
- create the importmap file if missing and the location can be found (#12727) (c6659db)
- plugin-import-export: add custom toCSV function on fields (#12533) (8f4c442)
- plugin-import-export: add debug logging option (#12705) (678bfc7)
- translations: add Bangla translations (#12696) (3f670ca)
🐛 Bug Fixes
- proper globals max versions clean up (#12611) (9fbc3f6)
- adds routeParams to the req on views (#12711) (773e4ad)
- plugin-form-builder: export DateField type (#12695) (8d7dbe6)
- plugin-import-export: incorrect config extension of jobs (#12730) (ff615d3)
- plugin-import-export: revise zhTw translations (#12685) (afbdf3d)
- richtext-lexical: text state css not applied if 2+ text state groups present (#12726) (3d177fd)
- richtext-lexical: prevent runtime error if using TextStateFeature without props (#12668) (6f82154)
- richtext-slate: add 'li' string literal to RichTextElement type (#12693) (e10e445)
- translations: correct i18n dynamic variable name for 'movingFromFolder' (#12642) (6f76d72)
⚡ Performance
- richtext-lexical: improve typing performance while toolbars are enabled (#12669) (aef4f77)
📚 Documentation
- document how to expose the jobs collection in Admin UI (#12707) (34fe36b)
- fix formatting in custom components > edit view paragraph (#12697) (6466684)
- improve jobs autorun docs, adds e2e test (#12196) (7c05c77)
- enhance drafts documentation with examples for REST, Local, and GraphQL APIs (#12575) (629e74d)
- removes duplicate headline in building without a db connection (#12694) (4ee4aa7)
- plugin-form-builder: add warning about GraphQL type name collis… (#12720) (7b21270)
🏡 Chores
- enable turbopack by default in monorepo (#12684) (f80dc5b)
🤝 Contributors
- Dan Ribbens (@DanRibbens)
- Sasha (@r1tsuu)
- sonny.you (@SonnyYou)
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
- Germán Jabloñski (@GermanJablo)
- Gordon Westerman (@gwesterman)
- Willian de Souza (@WillFelisberto)
- Anyu Jiang (@anyuj)
- SHOMRIDDHO'S WORLD (@shomriddho)
- Jessica Rynkar (@jessrynkar)
- Paul (@paulpopus)
- Sean Zubrickas (@zubricks)
Jun 5, 2025
v3.41.0 (2025-06-05)

🚀 Features
- optionally exclude collection documents from appearing in browse-by-folder (#12654) (337f618)
- improve turbopack compatibility (#11376) (319d335)
- polymorphic join querying by fields that don't exist in every collection (#12648) (2b40e0f)
- ui: use document drawers for folder edit/create (#12676) (9581092)
- ui: adds new editMenuItems custom component (#12649) (625d8d9)
🐛 Bug Fixes
- correctly detect glb & gltf mimetypes during upload (#12623) (05eeddb)
- allow unnamed group fields to not set a label at all (#12580) (d561195)
- cpa: generate .env when using the --example flag (#12572) (836fd86)
- db-postgres: ensure deletion of numbers and texts in upsertRow (#11787) (bd512f1)
- db-postgres: in query with null (#12661) (c08cdff)
- live-preview: correct type inference (#12619) (c83e791)
- next: cannot override tab of default views (#11789) (c639c5f)
- plugin-seo: thread allowCreate to meta image component (#12624) (ede5c67)
- richtext-lexical: export defaultColors for use in client components (#12627) (8199a7d)
- richtext-lexical: enable select inputs with ctrl+a or cmd+a (#12453) (89ced5e)
- translations: add missing import for lv locale from date-fns (#12577) (cbc37d8)
- ui: adjusts margin spacing on upload actions (#12692) (1dd4a12)
- ui: safely extract text from React nodes (#12419) (48e5ee6)
- ui: formatDate and formatTimeToNow utility type error on i18n arg to support I18nClient too (#12576) (76bf459)
- ui: correctly thread through the autoComplete attribute from admin config to the text input (#12473) (08ec837)
- ui: clear miliseconds in date fields unless theyre explicitly provided in the display format (#12650) (a9ff375)
- ui: reset columns state throwing errors (#11903) (08a6f88)
- ui: upload action button styles (#12592) (6119d89)
⚡ Performance
- ui: prevent unnecessary client config sanitization (#12665) (2bd098c)
🛠 Refactors
- translations: correct i18n translation for Mandarin (#12561) (6f8cff7)
- ui: improve relationship field option loading reliability using queues (#12653) (30dd9a2)
📚 Documentation
- add Content-Type header for JWT authentication (#12513) (3f7debd)
- fix import statements for plugin-nested-docs (#12494) (5635ec5)
- improve rich-text documentation with hasText usage tip (#12645) (53de775)
- fix beforeHook documentation to reflect actual behaviour (#12651) (fd5cd1a)
- improve module augmentation docs for request context (#12681) (0c3ff88)
- update seo plugin tabbedUI docs to mention potential pitfalls with the config option (#12549) (505eaa2)
- missing dash (#12644) (684c436)
- building without a db connection (#12607) (7c094dc)
📝 Templates
- do not expose users in example custom routes (#12677) (be52a20)
- bump for v3.40.0 (#12613) (71df378)
⚙️ CI
- skip flaky test on supabase (#12667) (30bb749)
- ability to test against turbopack (#12652) (0ceb96b)
🏡 Chores
- fix various e2e test setup issues (#12670) (545d870)
- fix lint warnings for default exports, unused imports, unused err in catch (#12666) (48218bc)
- migrate to TypeScript strict in Payload package (enable strictNullChecks) - #3 (#12586) (6ec21a5)
- update CONTRIBUTING.md (#12511) (5e3a94b)
🤝 Contributors
- Patrik (@PatrikKozak)
- Kamil Troczewski (@kamiloox)
- codeflorist (@codeflorist)
- Rot4tion (@Rot4tion)
- iamacup (@iamacup)
- Jacob Fletcher (@jacobsfletch)
- Alessio Gravili (@AlessioGr)
- Jarrod Flesch (@JarrodMFlesch)
- Elliot DeNolf (@denolfe)
- Said Akhrarov (@akhrarovsaid)
- Sasha (@r1tsuu)
- Paul (@paulpopus)
- Germán Jabloñski (@GermanJablo)
- Jessica Rynkar (@jessrynkar)
- Jacob (@chmielulu)
- Tobias Odendahl (@tak-amboss)
- Anyu Jiang (@anyuj)
May 29, 2025
v3.40.0 (2025-05-29)

🚀 Features
- adds new canSetHeaders prop to auth strategies (#12591) (ca6f849)
- moves getSafeRedirect into payload package (#12593) (7e873a9)
- adds calling of before and after operation hooks to resetPassword (#12581) (54a0484)
- show nested fields in named tabs as separate columns in the list view (#12530) (20f7017)
- filter query preset constraints (#12485) (0204f0d)
- select field filter options (#12487) (f75d62c)
- ui: export FieldAction type (#12589) (699af8d)
🐛 Bug Fixes
- parseCookies ignore invalid encoded values (#12515) (bfdcb51)
- improve translation script prompt and fix some incorrectly used terms in spanish and dutch (#12548) (1731dd7)
- browseByFolder route should be optional (#12527) (c010d51)
- thread req into interal folder payload operations (#12523) (64443d8)
- infinite loop in findUp utility when a result is not found (#12457) (842d184)
- delete subfolders hook with relational databases (#12507) (45f4c5c)
- db-*: disable DB connection for payload migrate:create (#12596) (12395e4)
- db-*: migrate:reset executes in a wrong order (#12445) (1b1e36e)
- db-mongodb: exists query on checkbox fields (#12567) (f2b6c4a)
- db-postgres: properly escape the ' character (#12590) (6888f13)
- examples: update live-preview example to ESM (#12570) (d6f6b05)
- next: folder redirects not working (#12509) (bc43982)
- richtext-lexical: respect disableBlockName (#12597) (ca26402)
- richtext-lexical, ui: opening relationship field with appearance: "drawer" inside rich text inline block (#12529) (f2b54b5)
- storage-vercel-blob: client uploads with a prefix (#12559) (b61ef13)
- templates: update template/plugin and fix import map issue (#12305) (68ba24d)
- translations: improve Spanish translations (#12555) (8a7ac78)
- translations: correct Norwegian terms for “locale” and language labels (#12557) (bd2571c)
- ui: reduces pill sizing in autosave cells (#12606) (a17d84e)
- ui: oversized column selector pills (#12583) (3022cab)
- ui: filtering on hasMany fields (#12579) (166dafe)
- ui: prevent textarea description overlapping fields and not honoring rows attribute (#12406) (032375b)
- ui: cloudfront removing X-HTTP-Method-Override header (#12571) (8448e5b)
- ui: live-preview-tab should show beforeDocumentControls (#12568) (dfa0974)
- ui: safari css rendering issues with table and folder cards (#12531) (293cdc1)
- ui: only and files/folders to the grid/list if they were added to the current folder (#12525) (5a75881)
- ui: replaces css fn with css calc (#12520) (feeee19)
- ui: index based ids without useAsTitle breaks folders (#12519) (e9cda1e)
⚡ Performance
- folder views download only images and get best fit from image sizes (#12514) (11a4a20)
🛠 Refactors
- use parseCookies method from Next.js (#12599) (d85909e)
📚 Documentation
- autoLogin codeblock was not nested under 'admin' (#12573) (0c0b0fe)
- typos and links (#12484) (7fa879c)
- fix typos, duplicated words, wrong property names etc. (#12480) (e2f7889)
📝 Templates
- bump for v3.39.1 (#12504) (6b6948f)
🏡 Chores
- updates bug template (#12587) (4a41369)
- fixes monorepo dev plugin-import-export (#12528) (06fbc07)
- moves collections folders property to the top level (#12508) (d83b2bf)
- examples: remove unused imports from custom server example (#12467) (071c61f)
- examples: fix read permission in auth example (#12403) (cceb793)
- ui: finish adding folders e2e tests (#12524) (feb7e08)
🤝 Contributors
- Sasha (@r1tsuu)
- Jarrod Flesch (@JarrodMFlesch)
- James Mikrut (@jmikrut)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Jordy (@jordanlambrecht)
- Alessandro Stoppato (@alexrah)
- Germán Jabloñski (@GermanJablo)
- Sean Zubrickas (@zubricks)
- Jessica Rynkar (@jessrynkar)
- Patrik (@PatrikKozak)
- Said Akhrarov (@akhrarovsaid)
- Paul (@paulpopus)
- Anders Semb Hermansen (@andershermansen)
- Anyu Jiang (@anyuj)
- Dan Ribbens (@DanRibbens)
- Ricardo Tavares (@rjgtav)
- Jake Grella (@jakegrella)
- Rémy (@rrelmy)
- Elliot DeNolf (@denolfe)
May 22, 2025
v3.39.1 (2025-05-22)

🐛 Bug Fixes
- update folders export paths (#12501) (0f7dc38)
📚 Documentation
- folders beta (#12500) (c720ce3)
📝 Templates
- include ui package (#12499) (3a73a67)
- bump for v3.39.0 (#12498) (4c6fde0)
🤝 Contributors
- Elliot DeNolf (@denolfe)
- Dan Ribbens (@DanRibbens)
May 22, 2025
v3.39.0 (2025-05-22)

🚀 Features

📁 Folders (#10030) (00667fa)

Folders allow you to organize your documents in a more manageable way. Now you can enable folders on a per-collection basis and from there start adding folders from within the admin panel (or via the API). Once you have folders enabled you can then start organizing. You can create folders and store documents across multiple collection types and then view them either in the collection "By Folder" or in the global "Browse by Folder" view.

https://github.com/user-attachments/assets/da1e0dec-abc7-4e5c-9241-3a733b2bfa0c
- show fields inside groups as separate columns in the list view (#7355) (2a41d3f)
- plugin-form-builder: add new date field (#12416) (4dfb2d2)
- richtext-lexical: add TextStateFeature (allows applying styles such as color and background color to text) (#9667) (fc83823)
- ui: extracts relationship input for external use (#12339) (88769c8)
🐛 Bug Fixes
- auto inject req.user into query preset constraints (#12461) (22b1858)
- telemetry in opennext cloudflare (#12327) (2ab8e2e)
- prevent resizing of original file with withoutEnlargement on update (#12291) (1235a18)
- incorrect environment file loading (#12360) (1425269)
- sanitize duplicate blocks (#12440) (5855f3a)
- orderable with groups and tabs requires migration (#12422) (529bfe1)
- respect hidden: true for virtual fields that have reference to a relationship field (#12219) (1f6efe9)
- cpa: ensure it always installs the latest version of the templates (#12488) (898e97e)
- db-*: ensure consistent sorting even when sorting on non-unique fields or no sort parameters at all (#12447) (72ab319)
- db-mongodb: remove limit from nested querying (#12464) (230128b)
- db-postgres: allow the same block slug in different places with a different localized value (#12414) (219fd01)
- plugin-import-export: add translations for all UI elements and fields (#12449) (3127d6a)
- plugin-multi-tenant: multi-locale tenant select label (#12444) (4fe3423)
- plugin-multi-tenant: add missing translation for Assigned Tenant field (#12448) (e8c2b15)
- plugin-seo: fix genImageResponse result parsing (#12301) (cead312)
- richtext-lexical: support inline block types in strict mode for JSXConvertersFunction type (#12478) (8596ac5)
- templates: make images visible in live preview if it is not running on port 3000 (#12432) (d4899b8)
- ui: set gap to 0 in sort column buttons to remove unneeded spacing (#12481) (c772a32)
- ui: render missing group children fields for unnamed group (#12433) (6fb2beb)
- ui: req not being threaded through to views (#12213) (bd6ee31)
⚡ Performance
- ui: useAsTitle field lags on slow cpu (#12436) (18f2f89)
📚 Documentation
- update rich text to HTML conversion documentation (#12465) (c701dd4)
- fix API capitalization typo in virtual fields documentation (#12477) (324daff)
🧪 Tests
- add test for sorting by a virtual field with a reference (#12351) (81d333f)
📝 Templates
- bump for v3.38.0 (#12434) (4166621)
🏡 Chores
- simplifies buildColumnState functions (#12496) (8142a00)
- ignore .idea run configuration templates (#12439) (23f4204)
- fix all lint errors and add mechanisms to prevent them from appearing again (#12401) (2a929cf)
- add ignores .next folder in eslint config for templates template (#12423) (e395a0a)
- drizzle: fix lint errors in @payloadcms/drizzle (#12428) (38029cd)
- live-preview: load schemaJSON from proper client config in integration tests (#12167) (08a3dfb)
🤝 Contributors
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
- Anders Semb Hermansen (@andershermansen)
- Germán Jabloñski (@GermanJablo)
- Patrik (@PatrikKozak)
- Sasha (@r1tsuu)
- Dan Ribbens (@DanRibbens)
- Alessio Gravili (@AlessioGr)
- Keisuke Ikeda (@ksk1kd)
- Jacob Fletcher (@jacobsfletch)
- conico974 (@conico974)
- Femi Oladipo (@femioladipo)
- Anyu Jiang (@anyuj)
- Elliot DeNolf (@denolfe)
- ch-jwoo (@ch-jwoo)
May 15, 2025
v3.38.0 (2025-05-15)

🚀 Features
- add latvian language support (#12363) (77bb7e3)
- allow group fields to have an optional name (#12318) (e258cd7)
- prevent query preset lockout (#12322) (9779cf7)
- thread overrideAccess through field validations (#12399) (7130834)
- plugin-multi-tenant: prompt the user to confirm the change of tenant before actually updating (#12382) (faa7794)
- storage-s3: presigned URLs for file downloads (#12307) (800c424)
- ui: fixed toolbar group customization (#12108) (b7b2b39)
- ui: display the actual error message on unpublish if available (#11898) (b3cac75)
🐛 Bug Fixes
- db-mongodb: sort by fields in relationships with draft: true (#12387) (fd67d46)
- db-mongodb: localized dates being returned as date objects instead of strings (#12354) (c43891b)
- db-postgres: build near sort query properly for point fields (#12240) (58fc2f9)
- db-postgres: dbName in arrays regression with long generated drizzle relation names (#12237) (5fce501)
- db-postgres: v2-v3 migration errors with relation already exists (#12310) (3edfd7c)
- db-postgres: ensure module augmentation for generated schema is picked up correctly in turborepo (#12312) (98283ca)
- db-postgres: selectDistinct might remove expected rows when querying with nested fields or relations (#12365) (8219c04)
- drizzle: improve db push schema comparison (#12193) (7266225)
- next: tells webpack not to bundle the require-in-the-middle pkg (#12417) (7498d09)
- plugin-cloud: ensure scheduled publishing works if no custom jobs are defined (#12410) (d63c8ba)
- richtext-lexical: newTab not being able to be checked to true by default (#12389) (3e7db30)
- ui: respect filterOptions: { id: { in: [] } } (#12408) (8ebadd4)
- ui: passes value to server component args (#12352) (d9c0c43)
⚡ Performance
- remove duplicative deep loops during field sanitization (#12402) (93d79b9)
- actually debounce rich text editor field value updates to only process latest state (#12086) (1d5d96d)
📚 Documentation
- remove link to outdated ecommerce template from stripe plugin docs (#12353) (cd45574)
- add local api instructions for vercel content link (#12385) (a9cc747)
- add pagination and limit: 0 information in pagination for API docs (#12243) (05ae957)
📝 Templates
- fix categories search sync (#12359) (3701de5)
- add eslint ignore rule for '.next/' (#12332) (09f15ff)
- fix Media component failing when setting a custom serverURL (#12214) (1869377)
🏡 Chores
- add NODE_OPTIONS to vscode settings by default in the repo for playwright extension (#12390) (e93d0ba)
- add no-frozen-lockfile flag for templates script (#12394) (735d699)
- bump node version in monorepo and add new flag for node 23.6+ (#12328) (021932c)
- plugin-stripe: enable TypeScript strict (#12303) (edeb381)
🤝 Contributors
- Sasha (@r1tsuu)
- Paul (@paulpopus)
- Jarrod Flesch (@JarrodMFlesch)
- Dan Ribbens (@DanRibbens)
- Dmitrijs Trifonovs (@dt-globelaxy)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Ruslan (@ruslan-amboss)
- Philipp Schneider (@philipp-tailor)
- Anyu Jiang (@anyuj)
- Jessica Rynkar (@jessrynkar)
- Germán Jabloñski (@GermanJablo)
- Rot4tion (@Rot4tion)
- jeepman32 (@jeepman32)
- Tobias Odendahl (@tak-amboss)
May 5, 2025
v3.37.0 (2025-05-05)

🚀 Features
- exports additional login helper utils (#12309) (dcd4e37)
- live-preview: expose requestHandler to subscribe.ts (#10947) (35c0404)
- ui: update RelationshipFilter if only filterOptions are changed (#11985) (446938b)
- ui: add document link to drawer (#12036) (292b462)
- ui: add option to open related documents in a new tab (#11939) (1ef1c55)
- ui: make select and relationship field placeholder configurable (#12253) (e568391)
- ui: allow array fields to be filtered in list view (#11925) (78d3af7)
🐛 Bug Fixes
- allow custom admin user collection in query presets constraints (#12202) (b9868c4)
- cpa: overwrites existing env variables (#10636) (e5b28c9)
- db-*: migration batch not incrementing past 1 (#12215) (3c9ee5d)
- db-postgres: start transaction in v2-v3 migration only after drizzle prompts to avoid timeout (#12302) (2628b43)
- graphql: nextPage and prevPage are non nullable even though they can be null sometimes (#12201) (3fb81ef)
- graphql: population of joins that target relationship fields that have relationTo as an array (#12289) (c08c707)
- plugin-cloud-storage: missing 'prefix' in cloud storage plugin (#11970) (0d10f43)
- plugin-multi-tenant: make tenant selector respect order if orderable enabled for tenant collection (#12314) (a6d76d6)
- richtext-lexical: add missing line-breaks to plaintext conversion (#11951) (ddf40d5)
- ui: unable to search for nested fields in WhereBuilder field selection (#11986) (3818634)
- ui: blockType ignored when merging server form state (#12207) (a62cdc8)
- ui: fix version list status for unpublished documents (#11983) (b6b02ac)
📚 Documentation
- fix typo in fields/relationship.mdx (#12306) (055a263)
- repair blank template markdown link in installation docs (#12297) (5365d4f)
🏡 Chores
- live-preview: enable TypeScript strict (live-preview-vue) (#12299) (b480f81)
- live-preview-react: enable TypeScript strict (#12298) (11018eb)
- storage-uploadthing: enable TypeScript strict (#12304) (d7d3744)
🤝 Contributors
- Ruslan (@ruslan-amboss)
- Anyu Jiang (@anyuj)
- Florian Beeres (@cideM)
- James Mikrut (@jmikrut)
- Tobias Odendahl (@tak-amboss)
- Sasha (@r1tsuu)
- Dan Ribbens (@DanRibbens)
- Germán Jabloñski (@GermanJablo)
- Bamsi (@francescoamici)
- Philipp Schneider (@philipp-tailor)
- qoheleth-tech (@qoheleth-tech)
- Samuel Gabriel (@sam-gab)
- Jessica Rynkar (@jessrynkar)
- Janus Reith (@janus-reith)
Apr 30, 2025
v3.36.1 (2025-04-30)

🐛 Bug Fixes
- duplicate with orderable (#12274) (710fe09)
- virtual relationship fields with select (#12266) (564fdb0)
- update email regex to support special characters (#12181) (8fee016)
- db-postgres: count crashes when query contains subqueries and doesn't return any rows (#12273) (4a56597)
- plugin-import-export: csv export column order (#12258) (47a1eee)
- richtext-lexical: ensure state is up-to-date on inline-block restore (#12128) (1b17df9)
⚡ Performance
- optimize file access promises (#12275) (6133a1d)
- db-postgres: skip pagination overhead if limit: 0 is passed (#12261) (27d644f)
🤝 Contributors
- Dan Ribbens (@DanRibbens)
- Sasha (@r1tsuu)
- Mattias Grenhall (@grenhall)
- Tobias Odendahl (@tak-amboss)
Apr 29, 2025
v3.36.0 (2025-04-29)

🚀 Features
- add beforeDocumentControls slot to allow custom component injection next to document controls (#12104) (d553069)
- add showSaveDraftButton option to show draft button with autosave enabled (#12150) (34ea6ec)
🐛 Bug Fixes
- user validation error inside the forgotPassword operation in the cases where user had localised fields (#12034) (c85fb80)
- db-mongodb: fallback version when not selected (#12158) (6dc61ae)
- db-postgres: sort by distance when the near operator is used (#12185) (9955818)
- examples: incorrect documentation links for Live Preview example (#12233) (ab03f4f)
- next: pg-cloudflare build issue (#12242) (2157450)
- plugin-search: delete does not also delete the search doc (#12148) (df7a369)
- richtext-lexical: prevent extra paragraph when inserting blocks or uploadNodes. Add preemptive selection normalization (#12077) (5492542)
- richtext-lexical: allow to indent and outdent if at least one selected node allows it (#12182) (9b1dd2a)
- richtext-lexical: reset indent on node transforms (#12183) (2c20051)
- ui: copyToLocale should not pass any id's to avoid duplicates (#11887) (34ead72)
- ui: relationship using list drawer correctly updates when hasMany is true (#12176) (5bd852c)
- ui: reflect default sort in join tables (#12084) (b750ba4)
⚡ Performance
- optimize virtual fields that reference ID (#12159) (fdff587)
- graphql: skip count query for join field using simple pagination (#12223) (6b83086)
- plugin-nested-docs: remove extra find call (#12224) (2f21d46)
- plugin-search: reduce query depth in hooks (#12225) (caae598)
- ui: only select necessary data for relationship options (#12251) (9948040)
🛠 Refactors
- translations: improvements for german translations (#11807) (92380bf)
📚 Documentation
- adds warning about handling different environments with migrations (#12249) (b7ae4ee)
- fix query preset config link (#12156) (034a267)
- virtual fields linking with relationship fields (#12145) (d91478c)
🤝 Contributors
- Germán Jabloñski (@GermanJablo)
- Tobias Odendahl (@tak-amboss)
- Jessica Rynkar (@jessrynkar)
- Bjørn Nyborg (@Bjornnyborg)
- Dan Ribbens (@DanRibbens)
- Sam Wheeler (@swheeler7)
- Adrian Maj (@AdrianMaj)
- Tylan Davis (@tylandavis)
- Elliot DeNolf (@denolfe)
- Said Akhrarov (@akhrarovsaid)
- Silas Krause (@krsilas)
- Sasha (@r1tsuu)
- Corey Larson (@coreyleelarson)
- Patrik (@PatrikKozak)
Apr 17, 2025
v3.35.1 (2025-04-17)

🐛 Bug Fixes
- next: missing @payloadcms/next/auth export (#12144) (ed50a79)
🏡 Chores
- db-postgres: improve table name length exceeded error message (#12142) (0a59707)
🤝 Contributors
- Jessica Chowdhury (@JessChowdhury)
- Sasha (@r1tsuu)
Apr 16, 2025
v3.35.0 (2025-04-16)

🚀 Features
- queriable / sortable / useAsTitle virtual fields linked with a relationship field (#11805) (1c99f46)
- threads operation through field condition function (#12132) (c877b1a)
- adds and exports reusable auth server functions (#11900) (6b34937)
- db-postgres: dependency inject pg to allow Sentry instrumentation (#11478) (da7be35)
- ui: add option for rendering the relationship field as list drawer (#11553) (55d00e2)
- ui: use defaultDepth in API view (#11950) (b354d00)
🐛 Bug Fixes
- respects boolean query preset constraints (#12124) (a675c04)
- ensures cors headers are run against custom endpoints (#12091) (e79b203)
- reordering draft documents causes data loss (#12109) (e90ff72)
- correct typo in error message and remove console.log (#12082) (a9eca3a)
- db-postgres: use correct export path for codegen in createSchemaGenerator (#12043) (71e3c78)
- db-sqlite: text field converts to floating point number (#12107) (6572bf4)
- richtext-lexical: allow to indent children even if their parents are not indentable (#12042) (babf4f9)
- templates: missing default value in select field (#11715) (5b554e5)
- translations: add missing Catalan translations (#10682) (85e6edf)
- ui: stale paths on custom components within rows (#11973) (21599b8)
- ui: issue with schedule publish disappearing on autosave collections (#12078) (3a7cd71)
- ui: use route.api from config in OrderableTable (#12081) (3287f70)
⚡ Performance
- ui: prevent blockType: "$undefined" from being sent through the network (#12131) (4426625)
📚 Documentation
- fix syntax issue in blocks field (#11855) (b9832f4)
- minor formatting tweaks to server function examples (#12102) (c661d33)
🏡 Chores
- adjusts ChevronIcon styling to match other icons (#12133) (2362899)
- assign available port to env variable in dev suite (#12092) (39462bc)
- separate Lexical tests into dedicated suite (#12047) (a66f90e)
🤝 Contributors
- Sasha (@r1tsuu)
- Patrik (@PatrikKozak)
- Philipp Schneider (@philipp-tailor)
- Tylan Davis (@tylandavis)
- Kristian Djaković (@kristian240)
- Jacob Fletcher (@jacobsfletch)
- James Mikrut (@jmikrut)
- Dan Ribbens (@DanRibbens)
- Tobias Odendahl (@tak-amboss)
- Adler Weber (@adlrwbr)
- Sam Wheeler (@swheeler7)
- AoiYamada (@AoiYamada)
- Edgar Guerra (@edguerrade)
- Jessica Chowdhury (@JessChowdhury)
- Paul (@paulpopus)
- Slava Nossar (@slavanossar)
- Corey Larson (@coreyleelarson)
- alexrah (@alexrah)
- Germán Jabloñski (@GermanJablo)
Apr 10, 2025
v3.34.0 (2025-04-10)

🚀 Features
- support where querying by join fields (#12075) (466dcd7)
- add support for time format config on scheduled publish (#12073) (eab9770)
🐛 Bug Fixes
- cannot define a join field when the target relationship is nested to a second or higher tab (#12041) (7aa3c5e)
- image previews getting stuck in list view when paginating (#12062) (a0fb335)
- array minRow validation should not show when non-required with no rows (#12037) (f079ece)
- querying by polymorphic join field relationTo with overrideAccess: false (#11999) (b9ffbc6)
- db-postgres: long array field table aliases cause error even when dbName is used (#11995) (09782be)
- richtext-lexical: diff component css was not included in css bundle (#12028) (f1d9b44)
- ui: ensure file field is only serialized at top-level for upload-enabled collections (#12074) (112e081)
- ui: form state race conditions (#12026) (4d7c1d4)
- ui: adds multi select inputs for text fields in where builder (#12054) (18ff9cb)
- ui: orderable table rendering (#12066) (9853f27)
- ui: adds multi select inputs for number fields in where builder (#12053) (09916ad)
- ui: resets value in where builder when operator changes (#11136) (ec34e64)
- ui: upload edits handling for bulk uploads (#12001) (c7b14bd)
- ui: prefer adminThumbnail even if file is non-image (#11948) (7721025)
⚡ Performance
- richtext-lexical: debounce field onChange handler (#12046) (101f765)
📚 Documentation
- formatting tweaks for local api docs (#12064) (a90ae9d)
- adjust formatting on Local API - Server Functions documentation (#12058) (d19412f)
- adds server function and access control sections to local API docs (#11902) (b809c98)
- clarify file upload example with _payload & field explanation (#12025) (83319be)
- fix and normalize links (#11993) (e109491)
- fix a typo (#12012) (dee9abd)
- fix markdown link (#12000) (5c54d9a)
🧪 Tests
- optimistic form state rows (#12055) (bd557a9)
- temp skip blocks e2e (#11988) (750210f)
📝 Templates
- update readme on blank template and blank template variations for Vercel (#12070) (3523c2c)
- bump for v3.33.0 (#12003) (6d83147)
⚙️ CI
- add sort and hooks suites to the e2e tests matrix (#12023) (ae9e5e1)
🏡 Chores
- run dev:generate-types (#11994) (97e2e77)
- add logging templates script and fix engines for pnpm v10 (#12021) (b270901)
- deps: bump image-size to 2.0.2 version (#12063) (37bfc63)
- deps: bump next.js to 15.3.0 and related dependencies (#12067) (e0046bb)
- deps: bump image-size package for security update (#12040) (acae547)
- plugin-seo: enable TypeScript strict (#11933) (a72fa86)
🤝 Contributors
- Sasha (@r1tsuu)
- Germán Jabloñski (@GermanJablo)
- Paul (@paulpopus)
- Patrik (@PatrikKozak)
- Jacob Fletcher (@jacobsfletch)
- Jessica Chowdhury (@JessChowdhury)
- Philipp Schneider (@philipp-tailor)
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
- Tylan Davis (@tylandavis)
- Said Akhrarov (@akhrarovsaid)
- Elliot DeNolf (@denolfe)
- Omar (@oasaleh)
- zy1p (@zy1p)
Apr 4, 2025
v3.33.0 (2025-04-04)

🚀 Features
- drizzle: export buildQuery and parseParams (#11935) (f34eb22)
- graphql: improve non-nullability in query result types (#11952) (018bdad)
- next: improved lexical richText diffing in version view (#11760) (d29bdfc)
- storage-uploadthing: configurable upload router input config (#11954) (f9c73ad)
- ui: use drag overlay in orderable table (#11959) (816fb28)
🐛 Bug Fixes
- postgres null value breaks orderable hook (#11997) (9adbbde)
- allow custom password field when using disableLocalStrategy: true (#11893) (8ad22eb)
- ValidationError error message when label is a function (#11904) (dc793d1)
- do not append doc input for scheduled publish job if it's enabled only for globals (#11892) (760cfad)
- db-mongodb: querying relationships with where clause as an object with several conditions (#11953) (857e984)
- db-postgres: deleteOne fails when the where query does not resolve to any document (#11632) (4ebd3ce)
- db-postgres: down migration fails because migrationTableExists doesn't check in the current transaction (#11910) (f310c90)
- graphql: respect draft: true when querying joins (#11869) (e5690fc)
- storage-uploadthing: pass clientUploads.routerInputConfig to the handler (#11962) (8e93ad8)
- ui: optimistic rows disappear while form state requests are pending (#11961) (8880d70)
⚡ Performance
- ui: significantly optimize form state component rendering, up to 96% smaller and 75% faster (#11946) (e87521a)
📚 Documentation
- fix invalid markdown (#11996) (f7ed8e9)
- add missing comma (#11976) (e6aad5a)
- fix variable names for lexical markdown conversion (#11963) (06d937e)
📝 Templates
- set packageManager pnpm version for vercel templates (#11992) (b76844d)
🏡 Chores
- fix flake (fae113b)
- plugin-cloud-storage: enable TypeScript strict (#11850) (d47b753)
- plugin-form-builder: enable TypeScript strict (#11929) (a58ff57)
- plugin-nested-docs: enable TypeScript strict (#11930) (fd42ad5)
- plugin-redirects: enable TypeScript strict (#11931) (6c735ef)
- richtext-lexical: add DebugJsxConverterFeature (#10856) (308cb64)
🤝 Contributors
- Dan Ribbens (@DanRibbens)
- Sasha (@r1tsuu)
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
- Tony Tkachenko (@tonytkachenko)
- James (@jmikrut)
- Jacob Fletcher (@jacobsfletch)
- reiv (@reiv)
- Said Akhrarov (@akhrarovsaid)
- Germán Jabloñski (@GermanJablo)
Apr 1, 2025
v3.32.0 (2025-04-01)

🚀 Features
- orderable collections (#11452) (d963e6a)
- configurable job queue processing order (LIFO/FIFO), allow sequential execution of jobs (#11897) (c844b4c)
- change version view modifiedOnly default to true (#11794) (21f7ba7)
- db-*: return database name to unsanitized config (#11913) (a083d47)
- db-*: export types from main export (#11914) (a6f7ef8)
🐛 Bug Fixes
- typescriptSchema override required to false (#11941) (968a066)
- support parallel job queue tasks (#11917) (9a1c3cf)
- next: block encoded and escaped open redirects in getSafeRedirect (#11907) (96289bf)
- plugin-cloud-storage: ensure client handlers are added to import map regardless of enabled state (#11880) (98e4db0)
- richtext-lexical: incorrectly hidden fields in drawers due to incorrect permissions handling (#11883) (f34cc63)
- translations: improve Swedish translations for query presets (#11937) (5b0e0ab)
- ui: nested fields disappear when manipulating rows in form state (#11906) (373f6d1)
- ui: switching languages does not update cached client config (#11725) (4a0bc86)
- ui: query presets are available for unrelated collections (#11872) (4fc2eec)
- ui: nested custom components sometimes disappear when queued in form state (#11867) (10ac989)
⚡ Performance
- prefer async fs calls (#11918) (d1c0989)
- ui: download only images and optimize image selection for document edit view, prioritize best-fit size (#11844) (5ae5255)
🛠 Refactors
- drizzle: replace query chaining with dynamic query building (#11923) (9c88af4)
- ui: replace autosave queue pattern with useQueues hook (#11884) (62c4e81)
📚 Documentation
- capitalization error (#11912) (af8c786)
- fix invalid react-hooks docs (#11895) (2b6313e)
- correct spelling of "it" (#11889) (b863fd0)
- fix links in custom components and custom features (#11881) (6b56343)
🧪 Tests
- deflake versions with autosave e2e (#11919) (03d4c5b)
- deflake indexed e2e (#11911) (70b9cab)
📝 Templates
- pin all payload packages, improve gen-templates script (#11841) (59c9fee)
🏡 Chores
- deps: bump mongodb-github-action (#10921) (329cd0b)
- live-preview: enable TypeScript strict (#11840) (6badb5f)
- ui: added selected option as a class to list table cell (#11750) (1578cd2)
🤝 Contributors
- Germán Jabloñski (@GermanJablo)
- Dan Ribbens (@DanRibbens)
- Jacob Fletcher (@jacobsfletch)
- Marcus Forsberg (@marcusforsberg)
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Said Akhrarov (@akhrarovsaid)
- Nate Schneider (@nate-at-keen)
- Maxim Seshuk (@maximseshuk)
- Philipp Schneider (@philipp-tailor)
- Pranav (@pranav-vaniya)
- Paul (@paulpopus)
Mar 25, 2025
v3.31.0 (2025-03-25)

🚀 Features

Query presets (#11330) (998181b)

Query Presets allow you to save and share filters, columns, and sort orders for your collections. This is useful for reusing common or complex filtering patterns and column configurations across your team. Query Presets are defined on the fly by the users of your app, rather than being hard coded into the Payload Config.

https://github.com/user-attachments/assets/1fe1155e-ae78-4f59-9138-af352762a1d5
- add Armenian translation (#11857) (f61f6b7)
🐛 Bug Fixes
- auth fields distrupt field paths within the field schema map (#11861) (74f935b)
- add uuid fallback for non-secure contexts in JSON fields (#11839) (1081b4a)
- next: adds safe redirect utility and apply to login redirects (#11814) (234df54)
- next: version view breaking for deeply nested tabs, rows and collapsibles (#11808) (3c4b3ee)
- plugin-seo: translation correction (#11817) (6174708)
- richtext-lexical: ensure initial state for nested lexical fields (#11837) (fb01b40)
⚡ Performance
- reduce job queue db calls (#11846) (a5c3aa0)
- drizzle: remove unnecessary db.select call in updateOne operation (#11847) (73fc3c6)
🛠 Refactors
- richtext-lexical: ensure field can be rendered outside EntityVisibilityProvider (#11842) (eb1434e)
🧪 Tests
- rearrange relationships test blocks properly (#11858) (93cc66d)
⚙️ CI
- add license-check script (#11860) (7fb4b13)
🏡 Chores
- admin-bar: enable TypeScript strict (#11834) (8d374cb)
- db-sqlite: enable TypeScript strict (#11831) (fe9317a)
- db-vercel-postgres: enable TypeScript strict (#11833) (de0aaf6)
🤝 Contributors
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
- Diego Satelier (@SatelierDiego)
- Sasha (@r1tsuu)
- Dan Ribbens (@DanRibbens)
- Patrik (@PatrikKozak)
- Germán Jabloñski (@GermanJablo)
Mar 24, 2025
v3.30.0 (2025-03-24)

⚠️ Next.js Peer Dependency Bump

This release bumps the peer dependency version of Next.js to 15.2.3 to address a security vulnerability. Next.js Blog post here for more detail. (PR #11823).

NOTE: This vulnerability does not affect any of the functionality of Payload, as the framework does not leverage anything affected in the vulnerability. This would only affect you if you've built additional functionality on top of Payload using additional Next.js middleware.

🚀 Features
- bump minimum next version to 15.2.3 (#11823) (5f6bb92)
- db-mongodb: support sorting by fields in other collections through a relationship field (#11803) (4081953)
- next: add support for custom props on the html element (#11738) (f9f53a6)
🐛 Bug Fixes
- respect draft: true when querying docs for the join field (#11763) (1b2b6a1)
- ui: exclude fields lacking permissions from bulk edit (#11776) (7532c4a)
📚 Documentation
- fix afterErrorHook export name in collection hooks (#11821) (d20f06e)
- fix links to locked document docs (#11770) (85db8ff)
- payload proper nouns (#11792) (5f7202b)
🧪 Tests
- deflakes conditional logic e2e (#11785) (90a08c4)
⚙️ CI
- sanitize breaking section in release notes (b1469ea)
🤝 Contributors
- Elliot DeNolf (@denolfe)
- Sasha (@r1tsuu)
- Alessio Gravili (@AlessioGr)
- Matthew Crutchfield (@mtcrutch)
- Philipp Schneider (@philipp-tailor)
- Jacob Fletcher (@jacobsfletch)
- Ivica Batinić (@isBatak)
Mar 20, 2025
v3.29.0 (2025-03-20)

Important

This release upgrades the lexical dependency from 0.27.1 to 0.28.0.

If you installed lexical manually, update it to 0.28.0. Installing lexical manually is not recommended, as it may break between updates, and our re-exported versions should be used. See the yellow banner box for details.

If you still encounter richtext-lexical errors, do the following, in this order:
1. Delete node_modules
2. Delete your lockfile (e.g. pnpm-lock.json)
3. Reinstall your dependencies (e.g. pnpm install)
🚀 Features
- pass i18n through field label and description functions (#11802) (31211e9)
- sort support for payload.update operation (#11769) (20e975b)
- add find to payloadDataLoader to cache local API queries (#11685) (975bbb7)
- distinct error for unverified email login (#11647) (fd99a30)
- aligns user _strategy returned from API (#11701) (8a51fe1)
- form state select (#11689) (9ea8a7a)
- add forceSelect collection / global config property (#11627) (5e3d07b)
- added support for conditional tabs (#8720) (878dc54)
- db-*: support sort in db.updateMany (#11768) (e96d3c8)
- db-*: allow to thread id to create operation data without custom IDs (#11709) (f442d22)
- db-postgres: add vector raw column type (#10422) (11d7487)
- plugin-form-builder: radio field (#11716) (427a5f1)
- richtext-lexical: support escaping markdown characters (#11784) (43cdccd)
- richtext-lexical: upgrade lexical from 0.27.2 to 0.28.0 (#11764) (240730f)
- richtext-lexical: allow disabling TabNode (#11656) (013b515)
- richtext-lexical: upgrade lexical from 0.27.1 to 0.27.2 (#11706) (adb42cb)
- ui: don't trigger preventLeave when opening a new tab (#11683) (398607f)
🐛 Bug Fixes
- add locale support to relationship filter options in WhereBuilder (#11783) (90f2491)
- add locale support to relationship filter options in WhereBuilder (#11783) (39ad31a)
- save button styles in edit-many modal (#11780) (7bc75e2)
- wrap login redirect routes with encodeURIComponent (#11778) (a02e476)
- email format validation with hyphens (#11761) (afe4432)
- improves email validation format rules (#11757) (875afcc)
- field appending on duplicate should ignore non string values (#11621) (74996fd)
- passes id and data to read access func when accessing upload URLs (#11684) (4a712e1)
- bulk upload validation when files are missing (#11744) (ea66e21)
- ensures select & radio field option labels accept JSX elements (#11658) (3c92fbd)
- add classes for picture tag in media component (#11605) (d66cdbd)
- db-mongodb: spread version schema options correctly (#11793) (1d25b16)
- plugin-cloud-storage: s3Storage client uploads working with more than 2 instances of the plugin (#11732) (bb39c87)
- plugin-import-export: export with draft true (#11762) (67a7358)
- plugin-import-export: translated preview labels (#11758) (e83f452)
- plugin-multi-tenant: ensures redirect route is correctly formatted (#11753) (06aa940)
- plugin-multi-tenant: missing key console message (#11693) (3d129e8)
- richtext-lexical: error in admin panel when block collapsed preference is not an array (#11771) (b857273)
- richtext-lexical: error in admin panel when setting a richtext field in useAsTitle (#11707) (ef527fe)
- richtext-lexical: make the toolbar indent button consider the disabledNodes property on IndentFeature (#11739) (dd80f52)
- richtext-lexical: unchecked list items were rendered as checked in html converter (#11747) (3f23160)
- richtext-lexical: remove undefined rel and target attributes in link HTML converter (#11754) (aa3737c)
- ui: adding guard check for populate docs in upload field (#11800) (7d9d067)
- ui: bulk edit subfields (#10035) (b5fc8c6)
- ui: excess error css coming from group fields (#11700) (0fe922e)
- ui: fallback localization data was appearing in document (#11743) (ebfb0eb)
- ui: scheduled publish not displaying the timezone's label and timezones being reset when scheduling a publish, brisbane is now a default timezone (#11699) (e0bf505)
- ui: processing and initializing form does not disable standalone fields (#11714) (0b1a1b5)
⚡ Performance
- use direct db calls in job-queue system (#11489) (032c424)
- download only images and optimize image selection for upload list view, prioritize best-fit size (#11696) (6270d73)
- ui: implements select in bulk edit (#11708) (d8bfb22)
🛠 Refactors
- richtext-lexical: new plaintext and markdown converters, restructure converter docs (#11675) (82840aa)
📚 Documentation
- mention correct --disable-transpile flag (#11788) (6640b1c)
- updates docs for useDocumentInfo (#11686) (ff2df62)
🧪 Tests
- dedicated bulk edit test suite (#11756) (a44a252)
🏡 Chores
- export type FieldAccessArgs (#11749) (f31e5e6)
- bump prettier, re-enable prettier for docs (#11695) (9f9db3f)
- deps: bump next.js from 15.2.2 to 15.2.3 in monorepo (#11748) (95821c6)
- examples: add locale to revalidatePath in Pages hook (#11775) (68f2582)
🤝 Contributors
- Jacob Fletcher (@jacobsfletch)
- Alessio Gravili (@AlessioGr)
- Ainsley Clark (@ainsleyclark)
- Anders Semb Hermansen (@andershermansen)
- Nacho Martin (@nachomglz)
- Jarrod Flesch (@JarrodMFlesch)
- Patrik (@PatrikKozak)
- Terry Yuen (@tyuen)
- Germán Jabloñski (@GermanJablo)
- Dan Ribbens (@DanRibbens)
- Said Akhrarov (@akhrarovsaid)
- Jessica Chowdhury (@JessChowdhury)
- Sasha (@r1tsuu)
- Paul (@paulpopus)
- DriesCruyskens (@DriesCruyskens)
- AoiYamada (@AoiYamada)
- Md. Tajmirul Islam Akhand (@Tajmirul)
- Philipp Schneider (@philipp-tailor)
- Tobias Odendahl (@tak-amboss)
Mar 12, 2025
v3.28.1 (2025-03-12)

🐛 Bug Fixes
- exclude plugin-cloud-storage, plugin-sentry and plugin-stripe from bundling optimization (#11673) (0fc70e0)
- incorrect height rounding when resizing images with sharp (#11634) (9d6583d)
- incorrect types for field Label, Description and Error server components (#11642) (88eeeaa)
- storage-s3: ensure s3 sockets are cleaned up (#11626) (3f6699f)
- translations: improve Swedish translations (#11654) (7be0219)
- ui: form state infinite render (#11665) (b81358c)
- ui: add RowLabelProvider context for blocks row labels (#11664) (4defa33)
- ui: prevent fieldErrorsToast from showing empty errors list (#11643) (b44603b)
📚 Documentation
- fix invalid ```txt language (#11638) (d14bc44)
🧪 Tests
- deflakes blocks e2e (#11640) (f2abc80)
📝 Templates
- bump Payload and Next.js dependencies (#11641) (c4fd27d)
🏡 Chores
- fix typo (rename mognoose to mongoose) (#11653) (885f580)
- infer React context providers and prefer use (#11669) (355bd12)
- deps: bump next.js from 15.2.1 to 15.2.2 in monorepo (#11636) (9c53a62)
- plugin-multi-tenant: remove SELECT_ALL constant (#11660) (39d783a)
- release: eslint/3.28.0 (bc79608)
- translations: polish Swedish (#11353) (1da50f5)
🤝 Contributors
- Germán Jabloñski (@GermanJablo)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Jarrod Flesch (@JarrodMFlesch)
- Elliot DeNolf (@denolfe)
- Said Akhrarov (@akhrarovsaid)
- Patrik (@PatrikKozak)
- Marcus Forsberg (@marcusforsberg)
- Jesper We (@JesperWe)
Mar 11, 2025
v3.28.0 (2025-03-11)

Important

Compilation Performance Improvements

We’ve introduced a new opt-in flag that can cut Payload’s compile times in half during development. To enable it, add the following to your next.config.js:
```
const nextConfig = {
  // ...
}

-export default withPayload(nextConfig)
+export default withPayload(nextConfig, { devBundleServerPackages: false })
```
In some rare cases, you may see unexpected behavior if your project relies on server-only Payload dependencies being bundled during development. Because of this, we’ve made the feature opt-in for existing projects.

Lexical Version Bump

This release upgrades the lexical dependency from 0.21.0 to 0.27.1. Alongside table improvements and bug fixes, this version bump lays the groundwork for frequently requested features like color pickers.

If you installed lexical manually, update it to 0.27.1. Installing lexical manually is not recommended, as it may break between updates, and our re-exported versions should be used. See the yellow banner box for details.

If you still encounter richtext-lexical errors, do the following, in this order:
1. Delete node_modules
2. Delete your lockfile (e.g. pnpm-lock.json)
3. Reinstall your dependencies (e.g. pnpm install)
🚀 Features
- defaults to noindex nofollow (#11623) (5285518)
- threads path through field validate function (#11591) (3ede7ab)
- allow specification of which JWT extraction methods are supported, and in which order (#10794) (8f6d2e7)
- db-mongodb: strip keys from the data that don't exist in the schema from read results (#11558) (2ad035f)
- next: fully expose Next.js metadata (#11593) (397c1f1)
- richtext-lexical: allow disabling indentation for specific nodes (#11631) (eb09ce9)
- richtext-lexical: upgrade lexical from 0.21.0 to 0.27.1 (#11564) (557ac99)
- richtext-lexical: adds ability to disable auto link creation (#11563) (1e708bd)
- richtext-lexical: new HTML converter (#11370) (36921bd)
- ui: form state queues (#11579) (ac1e3cf)
- ui: adds disable copy to locale option to collection config (#11546) (657ad20)
🐛 Bug Fixes
- ensure only authenticated users can access the payload-locked-documents collection (#11624) (8f3d1bd)
- upload imageSizes forces original file uploads to be compressed (#11612) (6d0924e)
- add missing auth property to new defaults function (#11561) (3af0468)
- db-mongodb: properly sanitize updateVersion read result (#11589) (e9afb36)
- graphql: sanitize graphql field names for schema generation (#11556) (029cac3)
- plugin-import-export: plugin breaks i18n configuration (#11590) (5d65cb0)
- translations: update translation placeholders to not be translated for lithuanian (#11622) (85f88a0)
- ui: adds fallback locale when defaultLocale is unavailable (#11614) (9ac7a3e)
- ui: stale list thumbnails when navigating (#11609) (fc5876a)
- ui: logic for showing copyToLocale button and adds test (#11584) (a53876d)
- ui: upload.displayPreview should affect all previews in the admin panel (#11496) (6f90d62)
- ui: apply consistent styling to custom & default block thumbnails (#11555) (8378654)
- ui: incorrect error states (#11574) (4811531)
⚡ Performance
- 50% faster compilation speed by skipping bundling of server-only packages during dev (#11594) (c7bb694)
🛠 Refactors
- more reliable import map generation, supporting turbopack and tsconfig basePath (#11618) (243cdb1)
📚 Documentation
- fix documentation about custom i18n types (#11386) (38f61e9)
- document payload migrate:create flags (#11592) (3de1636)
📝 Templates
- fix issue with populateAuthors hook breaking live-preview on website template (#11608) (72efc84)
- allow displaying dynamic error message on forms created via Form Builder plugin (#11275) (814ced4)
⚙️ CI
- adjust paths filter for workflows, only look at main.yml (#11572) (9f7e8f4)
- add canary nightly cron, adjust lock and stale crons (259ea6a)
- use GITHUB_OUTPUT instead of set-output [skip ci] (1ad1de7)
- canary and internal releases [skip ci] (#11565) (1797782)
🏡 Chores
- set all licenses for internal tooling (30af889)
- db-postgres: enable TypeScript strict (#11560) (c8f01e3)
- deps: bump all eslint packages (#11629) (f2da72b)
- deps: bump next.js from 15.2.0 to 15.2.1 in monorepo (#11576) (b0da85d)
- deps: bumps @payloadcms/admin-bar in templates and examples (#11566) (7cef890)
- ui: code/json field full height should include any padding added (#11607) (051c1fe)
- ui: removes margin when row is empty and passes style from props (#11504) (6699844)
🤝 Contributors
- Germán Jabloñski (@GermanJablo)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Patrik (@PatrikKozak)
- Rokas Puzonas (@RokasPuzonas)
- Jessica Chowdhury (@JessChowdhury)
- Dan Ribbens (@DanRibbens)
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
- Sasha (@r1tsuu)
- Md. Tajmirul Islam Akhand (@Tajmirul)
- Elliot DeNolf (@denolfe)
- James Mikrut (@jmikrut)
Mar 5, 2025
v3.27.0 (2025-03-05)

🚀 Features
- payload admin bar (#3684) (9724067)
- allow hiding the blockName field visible in blocks' headers via admin.disableBlockName (#11301) (143b6e3)
- threads path through field condition functions (#11528) (ba30d76)
- compound indexes (#11512) (bacc0f0)
- allows overriding import map location (#11532) (f01cfbc)
- plugin-import-export initial work (#10795) (4f822a4)
- ui: improves field error toast messages (#11521) (2163b0f)
🐛 Bug Fixes
- safe auth strategy execution (#11515) (312aa63)
- beforeValidate deleting value when access returns false (#11549) (6939a83)
- collection config deep merge during sanitization causing unpredictable behavior (#11524) (5adb764)
- format admin url inside forgot pw email (#11509) (56dec13)
- next: admin panel fails compiling when fullySpecified is set in next config (#11531) (cc05937)
- richtext-lexical: fix bug in $createAutoLinkNode when the link is preceded by a textnode (#11551) (4ebe673)
- storage-*: client uploads with disablePayloadAccessControl: true (#11530) (5cc0e74)
- storage-gcs: client uploads are enabled even if clientUploads is not set (#11527) (e36ab6a)
- ui: views rendered in drawers can update step nav (#11548) (04b0468)
- ui: execute client upload handler only when file exists (#11538) (31e2179)
📚 Documentation
- remove dead links from client live-preview (#11552) (bbfff30)
🧪 Tests
- add unit tests for getFieldByPath (#11533) (62c0872)
⚙️ CI
- cache mongodb image to avoid rate limiting (#11529) (64b63f6)
🏡 Chores
- cleanup generated configs (#11536) (8f203bb)
- indexes are not iterable, corrects indexes default value sanitization (#11534) (f0ea918)
- add plugin-import-export to publishList release tool (#11535) (672dace)
🤝 Contributors
- Sasha (@r1tsuu)
- Jarrod Flesch (@JarrodMFlesch)
- Jacob Fletcher (@jacobsfletch)
- Paul (@paulpopus)
- Germán Jabloñski (@GermanJablo)
- Said Akhrarov (@akhrarovsaid)
- Patrik (@PatrikKozak)
- Dan Ribbens (@DanRibbens)
- Alessio Gravili (@AlessioGr)
- Elliot DeNolf (@denolfe)
Mar 4, 2025
v3.26.0 (2025-03-04)

🚀 Features
- ability to cancel jobs (#11409) (38131ed)
- maintains column state in url (#11387) (3709950)
- db-*: support limit in db.updateMany (#11488) (6a3d58b)
- db-*: add updateMany method to database adapter (#11441) (41c7413)
- richtext-lexical: add htmlToLexical helper (#11479) (cd29978)
- richtext-lexical: add editorConfigFactory helper to streamline getting the editor config (#11467) (e1b3084)
- ui: close the nav when the user navigates away on small screens (#10932) (9bb89b7)
🐛 Bug Fixes
- avif images not converting to upload.formatOptions set file types (#11505) (c417e3a)
- excludes index files from migration files filtering (#10722) (c828e33)
- response headers from authstrategies are now merged together, even if no user was returned (#10883) (45a7c8b)
- ensures req.origin includes port on localhost (#11454) (a65289c)
- ensure errors returned from tasks are properly logged (#11443) (d53f166)
- incorrect value inside beforeValidate field hooks (#11433) (b3e7a9d)
- examples: ensure working multi-tenant example with pg (#11501) (4ddf965)
- examples: replace depreciated 'mergeHeaders' import in the MultiTenant example (#11306) (48e613b)
- next: incorrect active state for partial matches of collection names in sidebar (#11511) (7d2480a)
- next: active nav item not clickable in edit view (#11457) (83b4548)
- next: properly instantiates req.url on localhost (#11455) (67c4a20)
- next: email verification not working due to incorrect token url parsing (#11439) (f3844ee)
- next: disables active nav item (#11434) (c4bc0ae)
- plugin-multi-tenant: scope access constraint to admin collection (#11430) (9c25e7b)
- richtext-lexical: ensure nested forms do not use form element (#11462) (6d8aca5)
- storage-*: ensure client handler is always added to the import map, even if the plugin is disabled (#11438) (dfddee2)
- storage-s3, storage-azure, storage-gcs: client uploads when a collection has prefix configured (#11436) (fc42c40)
- storage-uploadthing: files are duplicated to the storage via client uploads (#11518) (f143d25)
- templates: handle enableLink condition safely (#10728) (f7f5651)
- ui: uses query provider as single source of truth for where builder (#11476) (927078c)
- ui: remove stale thumbnails in bulkUpload after partial success (#10651) (e75d38c)
- ui: bulk editing users throws client-side exception (#11461) (6cbda9e)
- ui: scope rah-static and progress-bar styles to payload-default layer (#11442) (bef98c8)
- ui: use full image url for upload previews instead of thumbnail url (#11435) (96d1d90)
- ui: locale selector in versions view should remove filtered locales (#11447) (9e97319)
- ui: copyToLocale should not pass id in data, throws error in postgres (#11402) (428c133)
- ui: duplicate basePath in Logout Button Link (#11432) (f7b1cd9)
- ui: disable publish button if form is autosaving (#11343) (7118b64)
⚡ Performance
- automatically add index on a relationship field when used as target for a join field (#11463) (90d3c65)
- disable returning of db operations that don't need the return value (#11437) (6ce5e8b)
- db-*: add option to disable returning modified documents in db methods (#11393) (c21dac1)
- db-mongodb: faster join field aggregation by replacing mongoose-aggregate-paginate-v2 with a custom implementation (#10936) (d4d2bf4)
- next: reduce initReq calls from 3 to 1 per page load (#11312) (c8c578f)
📚 Documentation
- clarify that image resizing/cropping require sharp to be specified in payload config (#11470) (d57a786)
- fix documentation "CheckListFeature" (#11480) (b9108b4)
- add few notes about DocumentDB and Azure Cosmos DB (#11336) (25e8799)
- fix method useAllFormFields on admin/hooks.mdx (#10935) (8b5bc3d)
- use local API to upload a local file (#10839) (19b4ec2)
- adds info and example for headersWithCors (#11141) (77395b6)
- custom auth strategy requires the collection slug in return value (#11327) (fcaf591)
- broken ' char entity instead of ' in plugins/build-your-own (#11363) (206b4b9)
- replace HTML entity ' with literal apostrophe (#11321) (8b55e7b)
📝 Templates
- fix vercel website template importmap error caused by missing import (#11500) (562acb7)
- bump payload versions, upgrade next.js to 15.2.0, fix eslint errors (#11486) (f03d450)
- improve naming of richtext component import, add 'payload-richtext' classname (#11485) (398d48a)
⚙️ CI
- change custom github actions target back to es5 (fd1a4f6)
- clarify version reporting in issue templates (#11498) (a15c38f)
- repro guide to use create-payload-app@latest instead of @beta (#11451) (e055565)
🏡 Chores
- add docker volume directories to gitignore (#10902) (fa8a2f8)
- temporarily disables flaky "should execute a custom script" test (#11487) (1929644)
- db-mongodb: tsconfig uses strict: true and noUncheckedIndexedAccess: true (#11444) (79a7b4a)
- deps: bumps payload-admin-bar to v1.0.7 to suppress react 19 warnings (#11499) (bf4fa59)
- eslint: speed up no-imports-from-self rule by ensuring cache is used (#11483) (3774544)
- examples: update multi-tenant example (#11459) (81e8a9d)
- plugin-search: enable TypeScript strict mode (#11508) (efce154)
- richtext-lexical: export LexicalFieldAdminProps (#11464) (dda17f0)
- richtext-lexical: improve UploadData jsdocs (#11292) (4a1b749)
- translations: enable TypeScript strict mode (#11494) (a3fe607)
🤝 Contributors
- Sasha (@r1tsuu)
- Patrik (@PatrikKozak)
- Germán Jabloñski (@GermanJablo)
- Ondřej Nývlt (@onvlt)
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
- Vincent Vu (@rubixvi)
- Alessio Gravili (@AlessioGr)
- Dmitrii Kuzmin (@ApplY3D)
- Said Akhrarov (@akhrarovsaid)
- Michael Bykovski (@bykof)
- Mike Newberry (@MikeNewXYZ)
- nomad-dev (@n0mad-d3v)
- Liège Arthur (@Thisisjuke)
- Violet Rosenzweig (@6TELOIV)
- Adrian Maj (@AdrianMaj)
- Jessica Chowdhury (@JessChowdhury)
- Martijn Luyckx (@martijnckx)
- Roy Barber (@roybarber)
- Philipp Meyer (@Quppi)
Feb 27, 2025
v3.25.0 (2025-02-27)

🚀 Features
- storage-*: large file uploads on Vercel (#11382) (b540da5)
- allow to count related docs for join fields (#11395) (3436fb1)
- add support for not_like operation (#11326) (b014416)
- plugin-multi-tenant: allow customization of selector label (#11418) (958e195)
- plugin-multi-tenant: filter users list and tenants lists (#11417) (45cee23)
- plugin-multi-tenant: export useTenantSelection hook for public usage (#11364) (f477e0e)
- richtext-lexical: allows client features to access components added to the import map by the server feature (#11414) (7e713a4)
- richtext-lexical: support single-quoted jsx property values in mdx converter (#11290) (563c21b)
- ui: threads row data through list drawer onSelect callback (#11339) (d766b19)
- ui: adds support for block groups (#11239) (22f61ad)
🐛 Bug Fixes
- ensure custom IDs are returned to the result when select query exists (#11400) (526e535)
- ensure generated types for config.blocks are not undefined if no blocks defined (#11377) (820a6ec)
- safely access config.blocks during type generation (#11320) (3ffc268)
- working bin configuration for custom scripts (#11294) (f779e48)
- db transaction errors caused by checkDocumentLockStatus (#11287) (9728d80)
- db-mongodb: hasNextPage with polymorphic joins (#11394) (6b6c289)
- deps: ensure Next.js 15.2.0 compatibility, upgrade nextjs and @types/react versions in monorepo (#11419) (2a3682f)
- next: nested relationship filter options (#11375) (0a1af45)
- next: use correct hmr url if assetPrefix is set in next config (#10859) (1725af5)
- next: uses assetPrefix from next config in webpack-hmr URL (#11229) (26163a7)
- plugin-multi-tenant: user access, thread field names through (#11365) (3778180)
- plugin-nested-docs: fallback to empty string if useAsTitle field is undefined (#11338) (09ca514)
- plugin-nested-docs: corrects data shape of breadcrumbs returned in hooks (#10866) (d92c000)
- richtext-lexical: incorrect UploadData types (#11288) (2612756)
- ui: skip bulk upload thumbnail generation on non-image files (#11378) (81fd42e)
- ui: allow json fields to be updated externally (#11371) (36e152d)
- ui: bulk upload DiscardWithoutSaving modal styles (#11381) (7bb1c9d)
- ui: object type field labels not displaying in search filter (#11366) (f1b005c)
- ui: custom block labels stale when reordering blocks (#11367) (2477fc6)
- ui: link element triggering clicks twice (#11362) (f9121c1)
- ui: only show bulk select all when count is less than total (#11329) (a8bec9a)
- ui: confirmation modal should build off of drawerDepth, instead … (#11305) (460d50b)
⚡ Performance
- remove deep copy of the entire sanitized entity config in configToJSONSchema (#11342) (a13d4fe)
- add limit: 1 and pagination: false to various payload queries (#11319) (0058f82)
- ensure fetching and updating preferences doesn't cause transaction errors and is done correctly (#11311) (845c647)
- db-mongodb: remove JSON.parse(JSON.stringify) copying of results (#11293) (1dc748d)
- drizzle: use faster, direct db query for getting id to update in updateOne (#11391) (e4712a8)
- next: reduce getNavPrefs calls from 3 to 1 per page load (#11318) (c7c5018)
- next: avoid unnecessary upsertPreferences call on page load (#11302) (76bd05c)
🛠 Refactors
- simplify collection, global and auth operations (#11374) (4410a49)
- simplify running field hooks (#11372) (dc9e8fa)
- ui: moves bulk edit controls (#11332) (f31568c)
📚 Documentation
- adds Reserved Field Names section to migration guide (#11308) (bcc6857)
- improve lexical code block documentation (#11416) (67b7a73)
- add lexical docs for configuring jsx converters for internal links and overriding them (#11415) (88a2841)
- add info about changes in localized fields to v2 -> v3 migration guide (#11244) (d326086)
- fix links to react hooks (#11344) (4224c68)
- update outdated docs/rich-text/overview feature names (#11324) (6ff380c)
- fix formatting in field hooks table (#11300) (af92c15)
- removes outdated rateLimit option (#11291) (c517e7e)
- fix invalid jsx in banner block (#11289) (b1e9aa5)
🧪 Tests
- removes all unnecessary page.waitForURL methods (#11412) (b975858)
📝 Templates
- update docker-compose to use postgres by default in postgres specific templates (#11328) (5d7be15)
⚙️ CI
- remove codeowners file (#11385) (48f183b)
🏡 Chores
- cleanup queues test suite (#11410) (c6ab312)
- add JSDoc for globals Local API operations (#11313) (0594701)
- cut down logging noise when file was not found on the disk (#11295) (f6f6a1d)
- add JSDoc for collection Local API operations properties (#11265) (ee5e96a)
- passes allowCreate into list drawer and adds test (#11284) (c05f10a)
- plugin-cloud: refresh session on ExpiredToken error code (#8904) (1e698c2)
- translations: adds missing client keys and removes translated validation errors (#10841) (6fad5d7)
🤝 Contributors
- Sasha (@r1tsuu)
- Patrik (@PatrikKozak)
- Jacob Fletcher (@jacobsfletch)
- Alessio Gravili (@AlessioGr)
- Jarrod Flesch (@JarrodMFlesch)
- Elliot DeNolf (@denolfe)
- Kendell Joseph (@kendelljoseph)
- Jessica Chowdhury (@JessChowdhury)
- Rafal Sypien (@inuue)
- Paul (@paulpopus)
- Tib (@T1l3)
- Said Akhrarov (@akhrarovsaid)
- Boyan Bratvanov (@bratvanov)
Feb 19, 2025
v3.24.0 (2025-02-19)

🚀 Features
- add support for interfaceName on radio and select fields to create reusable top level types (#11277) (acead10)
- join field across many collections (#10919) (6d36a28)
- add page query parameter for joins (#10998) (847d8d8)
- view component types (#11126) (b80010b)
- route transitions (#9275) (3f550bc)
- add siblingFields arg to field hooks (#11117) (155f9f8)
- richtext-lexical: export INSERT_BLOCK_COMMAND and INSERT_INLINE_BLOCK_COMMAND (#11193) (dc36572)
- translations: add support for lithuanian (#11243) (8bbe7bc)
- ui: enable specific css selectors on the localizer per locale (80b33ad)
- ui: confirmation modal (#11271) (bd8ced1)
- ui: adds admin.components.listMenuItems option (#11230) (8a2b712)
- ui: add hideFileInputOnCreate and hideRemoveFile to collection upload config (#11217) (daaaa5f)
- ui: refines progress bar animation curve (#11167) (16d75a7)
🐛 Bug Fixes
- versions not loading properly (#11256) (0651ae0)
- db transaction errors caused by checkDocumentLockStatus (#11273) (9b8f8d7)
- localized fields within block references were not handled properly if any parent is localized (#11207) (e6fea1d)
- upload and auth endpoints are mounted for all collections (#11231) (749962a)
- populate is ignored for nested relationships (#11227) (938472b)
- ensure leavesFirst option works correctly in traverseFields utility (#11219) (6b9d81a)
- join field does not show validation error (#11170) (dd28959)
- db-mongodb: properly handle document notfound cases for update and delete operations (#11267) (7922d66)
- db-mongodb: remove duplicative indexing of timestamps (#11028) (12f51ba)
- db-postgres: querying other collections via relationships inside blocks (#11255) (88548fc)
- db-postgres: ensure countDistinct works correctly and achieve better performance when the query has table joins (#11208) (513ba63)
- next: imports toast from @payloadcms/ui (#11279) (cd48904)
- next: document header padding on tablet sized screens (#11192) (70db44f)
- next: pre-flight OPTIONS request errors from the graphql endpoint (#11103) (ececa65)
- plugin-multi-tenant: corrects default value for tenantsArrayTenantFieldName (#11189) (b65ae07)
- plugin-seo: add missing supported languages (#11254) (74ce889)
- richtext-lexical: add container div to table element to allow horizontal scroll in HTML and JSX converters (#11119) (9068bda)
- richtext-lexical: reliably install exact lexical version by removing it from peerDeps (#11122) (2056e9b)
- richtext-lexical: unindent button in toolbar is never active (#11089) (7a400a7)
- ui: minor issues with tabs and publish buttons when in RTL (#11282) (e83318b)
- ui: turbopack with the latest next.js canary [skip lint] (#11280) (009e908)
- ui: disabledLocalStrategy.enableFields missing email/username fields (#11232) (9fc1cd0)
- ui: unsaved changes allows for scheduled publish missing changes (#11001) (618624e)
- ui: timezone issue related to date only fields in Pacific timezones (#11203) (8b0ae90)
- ui: database errors when running autosave and ensure autosave doesn't run unnecessarily (#11270) (1328522)
- ui: do not pass req in handleFormStateLocking (#11269) (7f5aaad)
- ui: issues with prevent leave and autosave when the form is submitted but invalid (#11233) (06debf5)
- ui: allow selectinputs to reset to their initial values if theres no provided value (#11252) (1c4eba4)
- ui: selection status not updating after toggleAll in useSelection hook (#11218) (5817b81)
- ui: properly handle singular and plural bulk edit labels (#11198) (779f511)
- ui: hide edit button on deleted relationship options (#11005) (cba5c7b)
- ui: respect locale in buildTableState (#11147) (077fb3a)
- ui: hide array field "add" button if admin.readOnly: true is set (#11184) (b1734b0)
- ui: unable to use browser back navigation after visiting list view (#11172) (0a3820a)
- ui: url encode imageCacheTag for media on dashboard (#11164) (d47c980)
- ui: json schema (#11123) (7f124cf)
- ui: prevent omitting fileSize from non-images (#11146) (6901b26)
- ui: adds delay to progress bar for fast networks (#11157) (de68ef4)
- ui: safe call within useEffect teardown (#11135) (30c77d8)
- ui: relationship filterOptions not applied within the list view (#11008) (2a0094d)
⚡ Performance
- optimize permissions calculation with lots of blocks (#11236) (313ff04)
- do not populate globals when calculating permissions, cleanup getEntityPolicies (#11237) (d49de7b)
- deduplicate blocks used in multiple places using new config.blocks property (#10905) (4c8cafd)
🛠 Refactors
- ui: simplifies confirmation modal callback (#11278) (af55549)
- ui: deprecates Link props (#11155) (cd11175)
📚 Documentation
- fix variable name typo in usePayloadAPI (error → isError) (#11249) (7024da8)
- fix typo in cors (#11266) (bf103cc)
- remove outdated res parameter in login and resetPassword operations (#11268) (38c1c11)
- update join field docs (#11264) (0d7cf3f)
- add missing jsdocs to version config (#11258) (ede7bd7)
- dedicated custom components docs (#10987) (3229b9a)
- adds onInit to payload config options (#11069) (b646485)
- fix typo in readme (#11196) (35d845c)
- remove file extension from import statement in useLexicalComposerContext (#11188) (480113a)
- fix importMap.baseDir path (#11076) (84c838c)
- fix invalid link (#11174) (152a9b6)
- add inlineBlock converter example to the converters configuration in Converters.mdx (#11158) (24da30a)
- filterAvailableLocales (#11031) (3131dba)
- explains i18n language changing (#10964) (3098f35)
- explains i18n installation (#10963) (d7dee22)
- fixes misc grammar and spelling errors (#10996) (c31bff7)
🧪 Tests
- blocks field helpers (#11259) (8166784)
- regenerate payload-types.ts for all test suites (#11238) (117949b)
- resolves select type errors (#11235) (e78500f)
- resolves locked-documents type errors (#11223) (ee0ac7f)
- add types testing for select and joins (#11138) (4be410c)
- db-mongodb: unit test assertion for relationship sanitization inside blockReferences (#11195) (2ae670e)
📝 Templates
- allow to pass resource={null} to Media component (#11228) (64d0217)
- add new readme for quick start on vercel platform (#11131) (707e85e)
- add packageManager to website template instead of engines.pnpm (#11121) (44be433)
- bump for v3.23.0 (#11115) (5d19958)
🏡 Chores
- move dequal to devDependencies (#11220) (d126c2b)
- update codeowners (#11151) (706410e)
- typo in migrate:fresh command (#11140) (6bfa66c)
- add typescript-strict-plugin to the payload package for incremental file-by-file migration [skip lint] (#11133) (6eee787)
- tsconfig.base.json reset (48471b7)
- deps: bumps @monaco-editor/react to v4.7.0 to suppress react 19 warnings (#11161) (f4639c4)
- richtext-lexical: fix unchecked indexed access, make richtext-lexical full ts strict (part 5/5) (#11132) (09ada20)
- richtext-lexical: improve types of UploadData (#10982) (002e921)
🤝 Contributors
- Paul (@paulpopus)
- Sasha (@r1tsuu)
- Dan Ribbens (@DanRibbens)
- Jarrod Flesch (@JarrodMFlesch)
- felismargarita (@felismargarita)
- Fredrik (@Livog)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Germán Jabloñski (@GermanJablo)
- Tib (@T1l3)
- Said Akhrarov (@akhrarovsaid)
- Patrik (@PatrikKozak)
- Jessica Chowdhury (@JessChowdhury)
- Riley Langbein (@rilrom)
- annes (@annesnour03)
- Max Malm (@benjick)
- lucasbajoua (@lucasbajoua)
- Kendell Joseph (@kendelljoseph)
- Adit (@ioExpander)
- Hulpoi George-Valentin (@GeorgeHulpoi)
- David Hu (@davidhu2000)
- Alejandro Martinez (@ja-martinez)
- Cody Stallings (@ydocsgnillats)
- Elliot DeNolf (@denolfe)
Feb 11, 2025
v3.23.0 (2025-02-11)

🚀 Features
- adds new jobs.shouldAutoRun property (#11092) (5dadcce)
- add timezone support on date fields (#10896) (430ebd4)
- richtext-lexical: expose client config to client features (#11054) (d7a7fbf)
- ui: add timezone support to scheduled publish (#11090) (c18c58e)
🐛 Bug Fixes
- set initialValues alongside values during onSuccess (#10825) (fde526e)
- unhelpful "cannot overwrite model once compiled" errors swallowing actual error (#11057) (6a99677)
- error when passing functions to array or block fields labels property (#11056) (6d48cf9)
- db-mongodb: ensures same level operators are respected (#11087) (d2fe9b0)
- db-postgres: incorrect pagination results when querying hasMany relationships multiple times (#11096) (98fec35)
- next: allows relative live preview urls (#11083) (91a0f90)
- payload-cloud: handle socket closures (#11113) (da77f99)
- richtext-lexical: improve keyboard navigation on DecoratorNodes (#11022) (fa18923)
- richtext-lexical: toggling between internal and custom links does not update fields (#11074) (9fb7160)
- richtext-lexical: fixed the positioning of the button to add columns or rows in tables (#11050) (886bd94)
- storage-s3: sockets not closing (#11015) (95ec575)
- ui: relationship filter renders stale values when changing fields (#11080) (da6511e)
- ui: incorrectly incrementing version counts if maxPerDoc is set to 0 (#11097) (3616818)
📚 Documentation
- update custom endpoints docs, handler does not accept array of functions anymore (#11110) (1f3ccb8)
- adds options table to payload-wide upload options (#10904) (d6a03ee)
- fixing 3 dead internal links (#11100) (3f80c59)
- adds usePayloadAPI hook to React Hooks documentation (#11079) (d56de79)
- fix typo in BlockquoteFeature name (#11078) (87ba7f7)
- typo in jobs queue workflows (#11063) (dc56acb)
- plugin-multi-tenant: update tenantsArrayField config options (#11045) (ac6f4e2)
📝 Templates
- bump engines pnpm version to support 10 (#11112) (ae4a78b)
🏡 Chores
- updates CODEOWNERS (#11088) (3415ba8)
- ensure jest respects PAYLOAD_DATABASE env variable (#11065) (c6c65ac)
- richtext-lexical: add test converage for internal links (#11075) (b15a7e3)
- richtext-lexical: fix unchecked indexed access (part 4) (#11048) (5a53854)
🤝 Contributors
- Elliot DeNolf (@denolfe)
- Paul (@paulpopus)
- Jacob Fletcher (@jacobsfletch)
- Sasha (@r1tsuu)
- Said Akhrarov (@akhrarovsaid)
- Jonathan Bredo (@Bredo)
- Jarrod Flesch (@JarrodMFlesch)
- James Mikrut (@jmikrut)
- Markus (@Ma-Kas)
- Germán Jabloñski (@GermanJablo)
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Nathan Clevenger (@nathanclevenger)
- Boyan Bratvanov (@bratvanov)
Feb 7, 2025
v3.22.0 (2025-02-07)

🚀 Features
- ui: adds filtering config option and implementation for filtering a… (#11007) (a63a3d0)
- ui: improve hasMany TextField UX (#10976) (d8cfdc7)
🐛 Bug Fixes
- db-postgres: ensure globals have createdAt, updatedAt and globalType fields (#10938) (57143b3)
- db-postgres: select hasMany: true with autosave doesn't work properly (#11012) (3ad56cd)
- next: viewing modified-only diff view containing localized arrays throws error (#11006) (09721d4)
- plugin-multi-tenant: correctly set doc default value on load (#11018) (f25acb8)
- richtext-lexical: duplicative error paths in validation (#11025) (2b76a04)
- richtext-lexical: ensure sub-fields have access to full document data in form state (#9869) (ae32c55)
- ui: removing final condition closes where builder (#11032) (b820a75)
- ui: clearing value from relationship filter leaves stale query (#11023) (7a73265)
- ui: relationship filter clearing on blur (#11021) (8940726)
- ui: improve useIgnoredEffect hook (#10961) (8ed4104)
- ui: allow schedule publish to be accessed without changes (#10999) (bdbb999)
- ui: apply cacheTags upload config property to other admin panel image components (#10801) (e29ac52)
🛠 Refactors
- do not use description functions for generated types JSDocs (#11027) (8b6ba62)
🧪 Tests
- addListFilter helper (#11026) (05e6f33)
- cleans up fields-relationship test suite (#11003) (694c76d)
🏡 Chores
- pnpm dev defaults to the _community test suite (#11044) (49d94d5)
- find and use an available port in tests (#11043) (feea444)
- fix eslint wasn't running in test dir (#11036) (257cad7)
- fix flaky lexical test (#11035) (04dad9d)
- deflake joins e2e tests (#11034) (098fe10)
- fix lexical tests that are failing on main branch (#11024) (6631869)
- cpa: add ts strict mode (#10914) (824f9a7)
- plugin-multi-tenant: add better defaults for imported components (#11030) (ec593b4)
- richtext-lexical: fix unchecked indexed access (part 3) (#11014) (5f58daf)
- richtext-lexical: fix unchecked indexed acess in lexical blocks feature (#11013) (e413e1d)
🤝 Contributors
- Dan Ribbens (@DanRibbens)
- Jacob Fletcher (@jacobsfletch)
- Germán Jabloñski (@GermanJablo)
- Alessio Gravili (@AlessioGr)
- Jessica Chowdhury (@JessChowdhury)
- Jarrod Flesch (@JarrodMFlesch)
- Sasha (@r1tsuu)
- Simon Vreman (@SimonVreman)
- Tobias Odendahl (@tak-amboss)
Feb 5, 2025
v3.21.0 (2025-02-05)

🚀 Features
- exposes helpful args to ts schema gen (#10984) (2118c6c)
- adds auto resize feature to textarea (#10786) (7d429f8)
- plugin-multi-tenant: allow opting out of tenant access control merge (#10888) (be790a9)
🐛 Bug Fixes
- allow public errors to thread through on response (#10419) (ea9abfd)
- db-postgres: select hasMany inside arrays and blocks with versions (#10829) (68a7de2)
- db-postgres: write operations on polymorphic joined collections throw error (#10854) (e1dcb95)
- plugin-multi-tenant: incorrect tenant selection with postgres (#10992) (2a1ddf1)
- plugin-multi-tenant: fixed hardcoded user tenants field (#10782) (9638dbe)
- plugin-search: deleting docs even when there's a published version (#10993) (42da87b)
- plugin-search: generates full docURL with basePath from next config (#10910) (0f85a6e)
- plugin-search: gets api route from useConfig (#10632) (6353cf8)
- richtext-lexical: removes css from jsx converter (#10997) (45913e4)
- richtext-lexical: link drawer has no fields if parent document create access control is false (#10954) (136c90c)
- ui: client should add back default values for valid and passesCondition form field properties (#10709) (35e5be8)
- ui: revert unrelated code (#10897) (3985893)
- ui: error in version view if document contains localized arrays or blocks (#10893) (85c0842)
- ui: create-first-user crashes when users collection has join field (#10871) (2f66bdc)
📚 Documentation
- fixes dynamic, fully qualified live preview url args (#10985) (a07fd9e)
- correct broken NPM badge images on plugin documentation (#10959) (1a68fa1)
- correct grammar and improve clarity on preventing-abuse.mdx (#10937) (8ace0ca)
- fix typo on overview.mdx (#10877) (8f27f85)
- admin preview and draft preview (#10875) (d7c3b4e)
🧪 Tests
- admin list view custom components (#10956) (b337499)
📝 Templates
- set pnpm engines to version 9 (#10979) (b671fd5)
- use typed functions in website template seed endpoint (#10420) (0a1cc6a)
- add @ts-ignore in seed to allow initial build on vercel (#10889) (2043b4a)
- remove unknown CSS values (#10891) (ebb5173)
📓 Examples
- multi-tenant seed script, readme and other improvements (#10702) (ae0736b)
- added missing sharp dependency to the remix website package (#10931) (58666fb)
⚙️ CI
- increase closed issue lock for inactivity to 7 days (8af8bef)
🏡 Chores
- deps: bump packages used to build payload (#10950) (109de8c)
- deps: bumps @faceless-ui/window-info to v3.0.1 and @faceless-ui/scroll-info to 2.0.0 (#10913) (2f787a9)
- deps: deprecates body-scroll-lock (c7ad46c)
- examples: misc improvements to the draft preview example (#10876) (2b9ee62)
- plugin-search: improves types (#10955) (1771271)
- plugin-search: deprecates apiBasePath from config (#10953) (4a4e90a)
- templates: improves and simplifies draft preview (#10895) (8a79e59)
🤝 Contributors
- Elliot DeNolf (@denolfe)
- James Mikrut (@jmikrut)
- Paul (@paulpopus)
- Jarrod Flesch (@JarrodMFlesch)
- Jacob Fletcher (@jacobsfletch)
- Boyan Bratvanov (@bratvanov)
- Tylan Davis (@tylandavis)
- Said Akhrarov (@akhrarovsaid)
- Jessica Chowdhury (@JessChowdhury)
- Steve Kuznetsov (@stevekuznetsov)
- Alessio Gravili (@AlessioGr)
- Suphon T. (@suphon-t)
- Alexander Cato (@alexander-cato)
- Marwin Hormiz (@marwinhormiz)
- Sasha (@r1tsuu)
- Franco D'Agostino (@francodgstn)
- David Murdoch (@dsm23)
- Pavel B. (@inlinecoder)
- Amelia (@LimChorngUan)
- Robert Clancy (Robbo) (@robclancy)
Jan 29, 2025
v3.20.0 (2025-01-29)

🚀 Features
- allow publish and publish specific locale buttons to be swapped (#9438) (9b49741)
- allows fields to be collapsed in the version view diff (#8054) (828b3b7)
- ui: allows customizing version diff components, render versions ui on the server (#10815) (c562fbf)
- ui: toggle showing only modified fields in version diff view (#10807) (33ac13d)
🐛 Bug Fixes
- checks for localization to prevent publish button breaking (#10844) (9c31a52)
- field paths within hooks (#10638) (0acaf8a)
- next: remove toString coercion inside getDocumentPermissions (#10828) (9f9919d)
- plugin-form-builder: type of MessageField to object (#10792) (92e6beb)
- plugin-form-builder: type of MessageField to SerializedEditorState (#10789) (5603c1c)
- plugin-multi-tenant: issue #10740 - "The following field is invalid: Assigned Tenant" (#10764) (c1c64a0)
- plugin-multi-tenant: remove tenant cookie on logout (#10761) (22633a6)
- plugin-nested-docs: update draft and published child docs on resave (#10454) (7a39870)
- richtext-lexical: preserve selection in Firefox when using LexicalMenu (#10867) (0e5ff24)
- richtext-lexical: afterRead hooks were not awaited (#10747) (9f2bca1)
- translations: adds et to import file (#10823) (ffe8020)
- ui: adds title attribute to Logout button for tooltip (#10851) (989140b)
- ui: correctly reset blocksDrawer search state after close (#10847) (8a6d995)
- ui: adds prev value on form state validat functions (#10832) (a835518)
- ui: hide the restore button's empty submenu in a draft version (#10756) (0d81ff2)
- ui: include check for parent permissions in renderField (#10729) (8289588)
⚡ Performance
- skips field validations until the form is submitted (#10580) (82f1bb9)
- only validate filter options on submit (#10738) (a05240a)
📚 Documentation
- add missing full stop, fix SlateNodeConverter import (#10860) (a47139a)
- fix links and formatting (#10835) (8952662)
- fix typo (#10824) (95e81d8)
- improvements in rich text section (#9954) (6a39279)
- adds limit, page, sort, where, and joins to list of rest query params (#10751) (ec1a441)
📝 Templates
- fix compatibility with pnpm 10 (#10830) (3094c92)
- fix website template not building (#10858) (219a369)
- adds landing page to blank template (#10769) (e65a04a)
- ensure lexical link validation does not break for internal links (#10771) (59545b5)
⚙️ CI
- remove docker login, not functional for external contributors (eca4f47)
- update CODEOWNERS (d6ae07d)
- fix run e2e command (#10779) (344b231)
🏡 Chores
- improves routeError log safety (#10793) (ace7557)
- uncomment collectionSlugs array in fields test suite, for resetDB to work properly (#10778) (72a5c02)
- migrate outdated @payloadcms/next/utilities imports (#10777) (b9d3250)
- disable bun run test buttons if bun extension is installed (#10775) (03f7bdf)
- cpa: re-pin template versions (#10857) (c08f012)
- deps: upgrades react-diff-viewer-continued to v4.0.4 to suppress react 19 warnings and use ESM imports (#10834) (57f7218)
- templates: update missing changes in vercel website template (#10827) (c75c6ce)
- templates: fix eslint errors in vercel templates (#10768) (52f86c7)
- templates: fix: the contact page of the website template throws an error in live preview (#10785) (d6658b5)
- templates: fix eslint errors in plugin template (#10770) (b76401c)
🤝 Contributors
- Germán Jabloñski (@GermanJablo)
- Sasha (@r1tsuu)
- Elliot DeNolf (@denolfe)
- Seno (@s-en-o)
- Alessio Gravili (@AlessioGr)
- Tsemach Hadad (@tsemachh)
- Dan Ribbens (@DanRibbens)
- Patrik (@PatrikKozak)
- Said Akhrarov (@akhrarovsaid)
- Jacob Fletcher (@jacobsfletch)
- Jessica Chowdhury (@JessChowdhury)
- Jarrod Flesch (@JarrodMFlesch)
- Tib (@T1l3)
- felismargarita (@felismargarita)
- Wallerand Delevacq (@wallforfry)
- James Mikrut (@jmikrut)
- Francisco Lourenço (@franciscolourenco)
Jan 23, 2025
v3.19.0 (2025-01-23)

🚀 Features
- richtext-lexical: make decoratorNodes and blocks selectable. Centralize selection and deletion logic (#10735) (4aaef5e)
- ui: adds edit many option for bulk uploads (#10646) (be2c482)
🐛 Bug Fixes
- next.js rewrites were not respected for rest api (#10759) (c0ae994)
- browser validation error when visiting account page (#10717) (c1b912d)
- custom blocks field label component missing from config (#10692) (a5695ba)
- apply CORS response headers without headersWithCors (#10597) (be98eda)
- rest api with ?locale=* doesn't return full localized data (#10619) (7f8f2f0)
- join field with the target relationship inside localized array (#10621) (25a70ab)
- properly handle nullable minDistance and maxDistance in near query (#10622) (46c1b37)
- db-mongodb: v2-v3 migration versions docs of collections and globals without relationship fields (#10755) (2d8ff72)
- db-mongodb: querying polymorphic relationships with the all operator (#10704) (d601300)
- db-mongodb: beginTransaction invalid type without replicaset (#10690) (90f88f8)
- next: admin panel UI not rendering custom upload components (#9925) (e4fa171)
- plugin-multi-tenant: selected tenant could become incorrect when navigating out of doc (#10723) (e6d0260)
- plugin-multi-tenant: corrects user type in userHasAccessToAllTenants fn (#10707) (2a98c84)
- plugin-multi-tenant: prevent throwing when no user exists (#10699) (a9c0832)
- plugin-nested-docs: cannot update more than 10 child docs (#10737) (3501d47)
- richtext-lexical: improved regex matchers for absolute and relative URLs to make autolinking more reliable (#10725) (9bb27af)
- richtext-lexical: incorrect table action menu placement (#10627) (9684d31)
- ui: filters out upload specific fields for bulk editing (#10726) (f181f97)
- ui: admin description not being respected on tabs and padding issues with tab descriptions (#10710) (67f7c95)
- ui: issue with thumbnail component crashing the UI if the image didnt exist (#10689) (ddeb29f)
📚 Documentation
- moves collection and globals admin docs to their respective config overviews (#10743) (e5b3da9)
- moves customizing fields doc to fields overview (#10742) (0ca3736)
- adds examples of typed custom field components (#10741) (8b3e2ff)
- adds info on useSelection and useStepNav hooks (#10683) (d8682f2)
- multi-tenant plugin - remove @beta and fix npm url (#10697) (6d43910)
📝 Templates
- update website readmes for additional information on jobs and revalidation (#10758) (61a2a9c)
- fix potential error in the initial form state caused by type mismatch (#10713) (5e4a1d4)
⚙️ CI
- dockerhub login to increase rate-limit (#10727) (7010d93)
- release notes emoji fix (4bde09a)
🏡 Chores
- temporarily revert 10597 (#10718) (0c5321e)
- adds plugin-multi-tenant scope for pr title (#10706) (3e0baf5)
- examples: change to useClickableCard to use AbortController (#10680) (b55342d)
- plugin-multi-tenant: test suite enhancements (#10732) (9a87699)
- templates: fix eslint errors in website template (#10752) (5689c65)
🤝 Contributors
- Sasha (@r1tsuu)
- Germán Jabloñski (@GermanJablo)
- Paul (@paulpopus)
- Jacob Fletcher (@jacobsfletch)
- Dan Ribbens (@DanRibbens)
- Patrik (@PatrikKozak)
- Alessio Gravili (@AlessioGr)
- Jarrod Flesch (@JarrodMFlesch)
- Elliot DeNolf (@denolfe)
- Said Akhrarov (@akhrarovsaid)
- Boyan Bratvanov (@bratvanov)
- David Murdoch (@dsm23)
- Riley Langbein (@rilrom)
Jan 20, 2025
v3.18.0 (2025-01-20)

🚀 Features
- adds support for both client-side and server-side remote URL uploads fetching (#10004) (38a06e7)
- support JPEG XL image size calculation (#10624) (6ebcbe4)
- adds multi-tenant plugin (#10447) (813e70b)
- examples: add example with Remix + Payload Local API (#10171) (5a9cf89)
- richtext-lexical: add jsx and html converters for tab nodes (#10565) (2e09da8)
- ui: exposes context of the view being rendered on the server (#10620) (e80d679)
🐛 Bug Fixes
- updates field validation error messages to use labels if applicable (#10601) (ad553e9)
- delete scheduled publish jobs when deleting documents (#10584) (05b9d94)
- UpsertArgs is not exported in payload (#9347) (7a392dd)
- form state read access control args (#10576) (05b03b2)
- missing find collection versions REST endpoint (#10573) (120735c)
- basePath was not passed through if method was overriden (#10562) (90e1843)
- db-mongodb: incorrect errors logging due to invalid logic in handleError (#10575) (9043b10)
- payload-cloud: add ts strict mode and fix a couple of wrong runtime behaviors (#10570) (16ad7a6)
- plugin-seo: loosen some types to restore compatibility between minor versions (#10670) (9c29541)
- plugin-stripe: hooks did not use api key from plugin config (#10671) (d2f63dc)
- richtext-lexical: setting hideInsertParagraphAtEnd to true did not hide insert paragraph button (#10581) (8ab05b0)
- richtext-lexical: inline blocks did not store nested fields correctly (#10578) (61117ee)
- richtext-lexical: ensure jsx and html converters do not output linebreak if editor is empty (#10563) (df4af70)
- richtext-slate: link and upload extra field drawers did not render fields if collection has unrelated access control set (#10583) (ecf0572)
- ui: renders custom block row labels (#10686) (6c19579)
- ui: fixed many bugs in the WhereBuilder relationship select menu (#10553) (56667cd)
- ui: replace hard coded path to API with serverURL and routes.api (#10618) (5a95237)
- ui: placement issue with sonner toasts (#10641) (f1cc8bd)
- ui: show outline on focus for sort column buttons (#9557) (818467d)
⚡ Performance
- list view table should not send duplicative client CollectionConfig to client (#10664) (823e223)
- ensure deepCopy in beforeValidate hook does not run unnecessarily for rest and graphQL API (#10666) (b69fe99)
- optimize getEntityConfig lookups (#10665) (c07c9e9)
- remove deepCopying in sanitizeJoinQuery, optimize flattenWhereToOperators (#10663) (91ed882)
- operations performance optimizations (#10609) (42382b6)
- reduce document data deepCopying in field hooks (#10610) (116fd99)
- do not send minRows and maxRows undefined values to client (#10600) (0a1cf7b)
- ensure unnecessary config translations are not sent to the client (#10524) (3fb6ac3)
- significantly reduce form state response size by up to 3x (#9388) (31ae27b)
- richtext-lexical: ensure internal link nodes do not store url field, and vice versa (#10564) (5d6c29f)
- ui: remove unnecessary deepCopy in reduceToSerializableFields (#10667) (a98a398)
- ui: speed up list view rendering, ensure root layout does not re-render when navigating to list view (#10607) (fafe37e)
📚 Documentation
- react hooks - update useForm import path (#10658) (ef44bdd)
- removes live preview image placeholder comment (#10643) (64fc2df)
- update wording for sentence (#10599) (22f3c79)
- add section on localized access control (#10567) (8217842)
🧪 Tests
- field level validation errors (#10614) (86ff0a4)
📝 Templates
- form fields will now respect 'required' flag from config on website template (#10681) (2d70269)
- add cache tag to images so that they can be revalidated along with the page on website templates (#10647) (7d10e1b)
- bump for v3.17.1 (#10560) (592f02b)
📓 Examples
- add example on Astro + Payload Local API (#10174) (2bf58b6)
🔨 Build
- move larger scripts into tools dir in workspace (#10653) (f18ca9c)
⚙️ CI
- update canary script for tools dir (711febc)
- add multi-tenant plugin to publish list (076ffa2)
- disable integration tests retrying (#10615) (28b7c04)
- access sha in dispatch event (5ee36fc)
- dispatch event (f306785)
- scripts: publish-canary script always bump minor, more realistic [skip ci][skip lint] (4629784)
🏡 Chores
- set save-prefix='' for repo [skip ci] (ef4b8d9)
- run pnpm dev without dev - this improves error logging on init (#10669) (9215f03)
- adjust multi tenant version (#10640) (baad382)
- multi-tenant plugin updates (#10598) (0d47a5d)
- enable noUncheckedIndexedAccess in all packages except richtext-lexical (#10592) (d4039f2)
- enable noImplicitOverride in all packages (#10588) (d55b6a3)
- update mongodb-memory-server v9 -> v10 (#10556) (918bd72)
- make TypeScript strict in test folder. Simplify tsconfig (#10582) (a304dc4)
- make TypeScript strict by default in packages and 7 packages stricter (#10579) (085c1d0)
- db-mongodb: update mongoose and mongodb deps (#10644) (00cc10c)
- deps: upgrade various dependencies (#10657) (b6e9c3b)
- deps: bumps path-to-regexp (8c3f6e1)
- examples: bumps custom components example to latest and runs seed on init (#10661) (9f5ffed)
- richtext-lexical: add unit test that ensures lexical dependency checker is updated (#10561) (6a6ef8f)
- templates: make TypeScript strict in website template (#10587) (2ce3829)
🤝 Contributors
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
- Sasha (@r1tsuu)
- Germán Jabloñski (@GermanJablo)
- Paul (@paulpopus)
- Boyan Bratvanov (@bratvanov)
- Dan Ribbens (@DanRibbens)
- Jarrod Flesch (@JarrodMFlesch)
- Patrik (@PatrikKozak)
- Riley Langbein (@rilrom)
- Said Akhrarov (@akhrarovsaid)
- Greg Presland (@gpresland)
- DracoBlue (@DracoBlue)
- Jessica Chowdhury (@JessChowdhury)
- Suphon T. (@suphon-t)
Jan 14, 2025
v3.17.1 (2025-01-14)

Important

This release upgrades the lexical dependency from 0.20.0 to 0.21.0. If you installed lexical manually, update it to 0.21.0. Installing lexical manually is not recommended, as it may break between updates, and our re-exported versions should be used. See the yellow banner box for details.

If you still encounter richtext-lexical errors, delete node_modules and your lockfile (e.g. pnpm-lock.json), then reinstall (e.g. pnpm install). Some package managers do not update the lexical peerdep automatically, likely due to a bug on their end.

🐛 Bug Fixes
- richtext-lexical: incorrect lexical version in dependency checker (#10559) (878763b)
🤝 Contributors
- Alessio Gravili (@AlessioGr)
Jan 13, 2025
v3.17.0 (2025-01-13)

Important

Please upgrade to 3.17.1. In 3.17.0, you may encounter richtext-lexical dependency checker errors during development.

🚀 Features
- delete scheduled published events (#10504) (f95d6ba)
- add ability to disable cache tags for admin thumbnails (#10319) (6b051bd)
- consolidates logic in update and updateByID operations (#9998) (690e99f)
- richtext-lexical: add new paragraph button below the editor (#10530) (6757f7d)
- richtext-lexical: respect imageURL for blocks and inline blocks (#10532) (ab564d3)
- richtext-lexical: upgrade lexical from 0.20.0 to 0.21.0. Fixes table selection & scrollable table bugs (#10501) (04733f0)
🐛 Bug Fixes
- respect res header immutability (#10554) (5cfb1da)
- better messaging when no arg passed to payload cli (#10550) (9278eec)
- aligns first render for hydration of dates in list view (#10541) (cc13ae7)
- rest api with Next.js basePath option (#10535) (04a8083)
- localized tabs with empty data and an array field inside lead to crash in afterChange (#10410) (1af7d87)
- cpa: proper debug logging (#10549) (9004205)
- next: ensures req.locale is populated before running access control (#10533) (afcc970)
- richtext-lexical: error when deleting links (#10557) (9631060)
- richtext-lexical: insert paragraph at end button overlaps floating link toolbar (#10552) (6ada450)
- richtext-lexical: remove alteration of lexical text format constant (#10415) (69fac59)
- richtext-lexical: combine 2 normalizeMarkdown implementations and fix code block regex (#10470) (0252681)
- richtext-lexical: editor placeholder had incorrect padding set for small viewports (#10531) (26711a7)
- richtext-lexical: adds support for localized placeholder (#10523) (dc6d79e)
- richtext-lexical: lexical editor behind a drawer was incorrectly registered as parent editor of lexical editor within drawer (#10502) (fd96a9a)
- translations: update etTranslations type to DefaultTranslationsObject (#10358) (2e0595b)
- ui: reset pagination when typing in WhereBuilder select menu (#10551) (a3ef5ee)
- ui: passes serverProps to custom label components within table columns (#10547) (6848cf4)
- ui: scheduled publish not showing related events in postgres (#10481) (c9584a9)
- ui: table custom label missing client field props (#10540) (415fbf1)
- ui: fixed issue with updatedAt timestamps not updating in the UI when drafts are updated (#10503) (082c4f0)
🛠 Refactors
- improve error logging during onInit and website template seed (#10528) (142c504)
- next: cleans up initPage through initReq overrides and consolidated return types (#10449) (c850bd4)
📚 Documentation
- improves grammar in vercel postgres usage note (#10365) (5043a8a)
- updates docs to reflect correct array hook usage (#10546) (43b40f0)
📝 Templates
- fix issue with shadcn utilities alias across website template and localization example (#10507) (d20dc58)
- bump for v3.16.0 (#10499) (a49f782)
⚙️ CI
- fix e2e test suite retries not working (#10525) (9b6cdd0)
🏡 Chores
- cpa: fixes typo in messages.ts (#10342) (2ae26d3)
🤝 Contributors
- Alessio Gravili (@AlessioGr)
- Elliot DeNolf (@denolfe)
- Germán Jabloñski (@GermanJablo)
- Dan Ribbens (@DanRibbens)
- Anthony Mifsud (@amifsud02)
- Ben Löffel (@benloeffel)
- Jacob Fletcher (@jacobsfletch)
- Tristan (@tristankrass)
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
- Simon Vreman (@SimonVreman)
- Amelia (@LimChorngUan)
- Sasha (@r1tsuu)
- Said Akhrarov (@akhrarovsaid)
Jan 10, 2025
v3.16.0 (2025-01-10)

🚀 Features
- consolidates REST API handling, decouple from next.js (#10466) (686e48d)
- exports ListPreferences from payload (#10474) (ae1542b)
- export the default JWTAuthentication strategy (#10430) (81c1e47)
- autoRun jobs (#10401) (c0dc0cc)
- payload-cloud: set up cron jobs on init (#10106) (36e50dd)
🐛 Bug Fixes
- collection access endpoint optional ID and use 404 for not found response (#10487) (225c24d)
- do not autorun jobs during next build process (#10483) (d8f4f06)
- properly validates preferences json (#10465) (6a262ab)
- schedule publish allowed before saving draft (#10461) (3349a4c)
- next: properly instantiates locale context (#10451) (a78bc6c)
- payload-cloud: infinite recursion on init (#10467) (34a0d00)
- richtext-lexical: respect defaultValue config of link feature url and linkType fields (#10498) (4fc6956)
- richtext-lexical: properly handle error if blocks or inline blocks are not found (#10497) (e0df0d6)
- richtext-lexical: update Thai translations for blockquote and horizontal rule (#10469) (8d5d2d1)
- richtext-lexical: allow external state mutation of block node from outside the form (#10486) (4c96028)
- richtext-lexical: inline Block drawers opened when document mounts (#10480) (bdb96dd)
- ui: disables form during locale change (#8705) (f4596fc)
- ui: stale doc status when publishing, reverting and unpublishing (#10405) (17e7ee2)
- ui: removes edit drawer button from uploads collection edit view (#10426) (9701fc6)
📚 Documentation
- update beforeValidate documentation (#10367) (21eec87)
- update draft doc for formatting (#10393) (a8d6f3f)
- removed unnecessary visible <br/> tag in fields/blocks (#10456) (83bd0e2)
📝 Templates
- adjusted the cron job schedule so its compatible with hobby tiers as well (#10457) (d9ff2e0)
- add support for scheduled publish to the website template [no lint] (#10455) (7321f9f)
🏡 Chores
- update year in licenses (#10463) (e46ad67)
- import copy icon from nested folder (#9223) (ac97bfd)
- templates: generate new migrations for vercel (#10458) (5318d24)
🤝 Contributors
- Sasha (@r1tsuu)
- Jacob Fletcher (@jacobsfletch)
- Alessio Gravili (@AlessioGr)
- Sepiolina (@TidalCare)
- Steve Kuznetsov (@stevekuznetsov)
- Adrian Maj (@AdrianMaj)
- Germán Jabloñski (@GermanJablo)
- Dan Ribbens (@DanRibbens)
- Paul (@paulpopus)
- Jarrod Flesch (@JarrodMFlesch)
- Patrik (@PatrikKozak)
Jan 8, 2025
v3.15.1 (2025-01-08)

🐛 Bug Fixes
- vercel upload adapter warning false positive (#10434) (7a21b44)
- deprecates admin.disable property (#10429) (b092754)
- richtext-lexical: fix default arg in normalizeMarkdown (#10424) (4d7587d)
🤝 Contributors
- Elliot DeNolf (@denolfe)
- Jacob Fletcher (@jacobsfletch)
- Germán Jabloñski (@GermanJablo)
Jan 7, 2025
v3.15.0 (2025-01-07)

🚀 Features
- allow running sub-tasks from tasks (#10373) (08fb159)
- warn if deploying to vercel and any upload collection missing storage adapter (#10391) (22c4dee)
- next: pass through query params from document view to find operations (#10343) (4a15b86)
- next: adds support for resetting preferences (#10304) (1cade17)
🐛 Bug Fixes
- extends type all to the locale type definition in req (#10399) (eadce5e)
- increase safety of findConfig (#10400) (f629709)
- handle withoutEnlargement for undefined height or width (#10078) (d212733)
- allow to set maxDepth: 0 for join fields, improve join field JSDoc (#10336) (ba228dd)
- copy to locale with localized arrays and blocks generate new IDs to prevent errors in postgres (#10292) (c7b3204)
- adds path to server field component prop types (#10330) (e97c43e)
- cpa: ensures .env & .env.example file modifications occur before git initialization (#10312) (3847718)
- db-postgres: handle undefined fallback for adapter.schemaName in relationships migration (#10384) (1525cc6)
- db-postgres: added missing quotes and schema name to sql statement in v2-v3 migration (#10322) (556b8ed)
- email-resend: add reply_to to the API when sending emails (#10407) (c7f21fc)
- live-preview-react: allows react peer deps of v16.8.0 or later (#10328) (f2fab39)
- next: live preview tab did not display custom edit view components (#10412) (ef7191b)
- richtext-lexical: make div container optional (#10383) (7fc6227)
- richtext-lexical: formatted inline code resulted in incorrect markdown export (#10413) (827c75a)
- richtext-lexical: modify JSXConvertersFunction type to support block types in strict mode (#10398) (d772b2b)
- richtext-lexical: open inline block drawer on mount (#10318) (5997aa1)
- storage-vercel-blob: return 404 when file is not found (#10327) (d68a1ea)
- ui: drawer component missing closing bracket in style calc (#10411) (ab53aba)
- ui: sort resets columns (#10402) (a83a430)
- ui: make relationship fields update the collection when it is changed in the drawer dropdown (#10338) (be84ad7)
- ui: properly reflects hook changes in ui (#10268) (3ea1d39)
- ui: ensures list drawer does not change underlying step nav (#10339) (b44aade)
📚 Documentation
- minor lexical docs improvements (#10414) (b774f55)
- fix all other links to live-preview example (#10385) (53aea62)
- fix CORS anchor link (#10333) (fd52de6)
- fix link to live-preview example and remove empty placeholder (#10380) (1e247f8)
- fix links and formatting (#10346) (5e4e274)
🧪 Tests
- fixes flaky localization e2e once and for all (#10406) (5991a2e)
📝 Templates
- fix nested docs url generation for categories (#10403) (398b609)
- use cross-env in the plugin template to achieve compatibility with Windows (#10390) (c1abd16)
- prevent plugin template from including nested next folder in git (#10364) (0ce7c66)
- bump for v3.14.0 (#10324) (3d5b9f0)
⚙️ CI
- scripts: create draft release with release script, cleanup [skip ci] (6dcf817)
🏡 Chores
- export RunInlineTaskFunction type (#10372) (1a9fba5)
- change base image for template base dockerfile [skip ci] (daf314c)
- deps: bumps react-datepicker to v7.6.0 to suppress react 19 warnings (#10366) (8d24528)
- examples: set HTML dir attribute for RTL locales #10344 (#10345) (df827c0)
- examples: remove outdated testing example (#10370) (5ba477b)
- examples: removes all instances of React.forwardRef (#10334) (1f4790a)
- richtext-lexical: improve block not found error message (#10348) (09d6c60)
- templates: unpin payload packages (#10386) (422e8e3)
- templates: removes all instances of React.forwardRef (#10331) (47e8158)
🤝 Contributors
- Alessio Gravili (@AlessioGr)
- Paul (@paulpopus)
- Boyan Bratvanov (@bratvanov)
- Jacob Fletcher (@jacobsfletch)
- Amir Aryan (@amiraryan1996)
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
- Germán Jabloñski (@GermanJablo)
- Sasha (@r1tsuu)
- bakaptr (@Zhousiru)
- Nacho Martin (@nachomglz)
- Said Akhrarov (@akhrarovsaid)
- Danilo Lemes (@Danil0v3s)
- James Mikrut (@jmikrut)
- Anders Semb Hermansen (@andershermansen)
- Jarrod Flesch (@JarrodMFlesch)
Jan 3, 2025
v3.14.0 (2025-01-03)

🚀 Features
- add Estonian language support (#10169) (38f3455)
🐛 Bug Fixes
- ensure scheduled publish restriction (#10317) (4e57054)
- ensure loggingLevels is respected (#10308) (2e58a4a)
- 'oldValue' must be a string error when viewing version diffs in postgres (#10313) (d9e0cd3)
- safely executes form state conditions, validations, and default values (#10275) (7928eca)
- next: returns proper verb tenses from update and delete routes (#10307) (d38ca83)
- richtext-lexical: allow any priority of FOCUS_COMMAND (#10128) (018c193)
- ui: unable to find user field schemas when updating password (#10305) (b14935c)
- ui: properly instantiates abort controllers (#10309) (abb51b9)
- ui: gracefully handle deletions in collection with upload hasMany (#9426) (2ae7d8e)
- ui: disable save button until the upload file is uploaded / ready (#10083) (bd7f705)
📚 Documentation
- warn when using defaultPopulate on collections with uploads enabled (#10138) (d6d9edc)
- fix typo in join.mdx (#10190) (b2042c5)
📝 Templates
- fix media block generating an error if referenced media is missing (#10310) (951c38e)
- reorders postcss plugins in the website template for tailwind compatibility (#10176) (a000e4a)
🏡 Chores
- examples: fix JSX rendering of internal links (#10303) (510968f)
- translations: adjust Norwegian translation of events (#10300) (c658022)
🤝 Contributors
- Sasha (@r1tsuu)
- Angel P. (@PlagueFPS)
- Jacob Fletcher (@jacobsfletch)
- Paul (@paulpopus)
- Alexander Cato (@alexander-cato)
- Tristan (@tristankrass)
- Dan Ribbens (@DanRibbens)
- Said Akhrarov (@akhrarovsaid)
- Sondre Ørland (@sondreorland)
- Germán Jabloñski (@GermanJablo)
- Grant Kennedy (@gkennedy87)
- Patrik (@PatrikKozak)
Jan 2, 2025
v3.13.0 (2025-01-02)

🚀 Features
- adds more control over how to disable graphql for collections /… (#10265) (7a59e7d)
- richtext-lexical: ability to override default placeholder (#10278) (182eaa3)
- translations: add Catalan translations (#10260) (5188a9b)
- ui: expose onMount to CodeField (#10223) (68a5f5c)
🐛 Bug Fixes
- close db connections after running jobs from command line. (#9994) (eb69885)
- cpa: do not overwrite custom.scss file on update (#10285) (c3eb272)
- graphql: Change config from raw path to file: url (#9311) (16c6abe)
- plugin-cloud-storage: actually deprecate adapters (#9640) (c4b31c0)
- plugin-search: respect custom api route in reindexButton (#10258) (cdaebcc)
- richtext-lexical: empty lines were incorrectly stripped from mdx blocks if doNotTrimChildren was set to true (#10287) (ee3c2cc)
- richtext-lexical: throw toast error when attempting to create upload node without any upload collections enabled (#10277) (07e86c0)
- richtext-lexical: various issues for lexical sub-fields due to incorrectly generated client field schema map (#10276) (35df899)
- richtext-lexical: formatted link markdown conversion not working (#10269) (885e966)
- richtext-lexical: ensure markdown normalization does not merge escaped code block lines (#10230) (c01b4bf)
- translations: adds missing max validations keys to client (#10266) (5d6064a)
- ui: checkboxes as first field were crashing WhereBuilder (#10290) (f3f36d8)
- ui: relationship edit drawers now respect current locale (#10262) (6dac4c5)
- ui: properly filters fields from list view columns and conditions (#10246) (f5a955d)
- ui: disableListColumn on first field breaks filter condition selection (#10267) (039b489)
- ui: removes useless verified checkbox on user create (#10252) (8671e85)
- ui: autosave wasnt firing on first change (#10256) (ef7242c)
📚 Documentation
- explicit payload usage from req to avoid import payload confusion (#10291) (76e4402)
- fix all missing vertical lines in tables (#10288) (b6de432)
- add missing vertical line to Collection Upload options table (#10282) (950f8ce)
- adds useListQuery to list of React hooks and updates useDocumentInfo (#10186) (be87ba0)
- fix dispatch actions link for useFormFields and useAllFormFields (#10273) (313b4ba)
- fix incorrect escaping of * (#10274) (5b4730d)
- fix docs for generate db schema (#10251) (63bca12)
- adds notes about importance of serverURL for verify / forgot-pa… (#10248) (6af6e44)
- add clarity about forgot-password and verify tokens (#10247) (363a24c)
- richtext-lexical: minor improvements (#10280) (943798a)
- richtext-lexical: improve building custom feature docs, add example for custom blocks (code field within lexical) (#10279) (6e19e82)
🧪 Tests
- consolidates list view e2e tests (#10263) (270ac10)
- adds custom pagination e2e tests (#10240) (6f5a1e3)
🏡 Chores
- cpa: remove success message outline (#10233) (2111a86)
- translations: fine-tune some Swedish texts (#10224) (c5b1cd6)
🤝 Contributors
- Sasha (@r1tsuu)
- James Mikrut (@jmikrut)
- Alessio Gravili (@AlessioGr)
- Said Akhrarov (@akhrarovsaid)
- Boyan Bratvanov (@bratvanov)
- Elliot DeNolf (@denolfe)
- Jacob Fletcher (@jacobsfletch)
- Gerard Du Pre (@GerardPolloRebozado)
- Jesper We (@JesperWe)
- Dan Ribbens (@DanRibbens)
- Violet Rosenzweig (@6TELOIV)
- Anders Semb Hermansen (@andershermansen)
Dec 28, 2024
v3.12.0 (2024-12-28)

🚀 Features
- scheduled publish / unpublish (#10203) (37d1f2d)
- adds req to filterOptions args (#10204) (cf8c0ae)
- export defaultLoggerOptions (#10133) (7e0975f)
- plugin template (#10150) (d8a62b7)
- cpa: create project from example using --example CLI arg (#10172) (6b4842d)
- richtext-lexical: multiline string support for objects in MDX parser (#10208) (181fc41)
- richtext-lexical: more lenient MDX JSON object parser that allows unquoted property keys (#10205) (a46609e)
🐛 Bug Fixes
- deep querying, handle getLocalizedPaths for blocks (#10187) (eff75f9)
- generate types when no en language is defined in i18n (#10181) (8debb68)
- ensure tab label and description are serializable (#10115) (68b5f61)
- db-postgres: prevent indexes from changing name on HMR (#10154) (374b79d)
- db-postgres: joins to self collection (#10182) (a0d8131)
- richtext-lexical: newlines in mdx props were stripped, even though objects inside props may expect there to be newlines (#10215) (67db04c)
- richtext-lexical: restore selection (#10129) (154ad9d)
- ui: pagination resets perPage (#10199) (fad4ee6)
- ui: prevent many upload fields overwriting bulkUpload onSuccess (#10189) (ebf3cee)
- ui: public users unable to log out (#10188) (f3aebe3)
- ui: infinite loading states when adding blocks or array rows (#10175) (b33f4b0)
⚡ Performance
- db-postgres: do not push database schema if not changed (#10155) (98666eb)
📚 Documentation
- fix backtick escaping in TableWithDrawers blocks (#10220) (3218b0d)
- correctly escape backticks (#10217) (466ea29)
- correctly escape backticks (#10216) (3278f45)
- fix typo (#10214) (da518f5)
- fix incorrect docs for complex mdx components (#10212) (78b6d51)
- fix syntax that couldn't be parsed (#10207) (29c5bcd)
- fix incorrect mdx (#10201) (bb0c8a8)
- fix arg name in live preview code example (#10127) (a49e63c)
- fix broken links to csrf and e-mail verification docs (#10140) (0588394)
🧪 Tests
- semantically splits admin e2e (#10213) (0be1a1d)
- ensure data strictness (#10123) (ed0d339)
📝 Templates
- use publishConfig for the plugin template (#10196) (a5b9adc)
- update Dockerfile for the website template, use the LTS version for Node.js image (#10184) (5613a7e)
- bump for v3.11.0 (#10121) (235eade)
⚙️ CI
- only label stale issues/prs, disable closing (1372f24)
🏡 Chores
- bump next to 15.1.3 in the monorepo (#10211) (7a4d53a)
- update rimraf and fix windows compatible clean script (#10152) (326b720)
- UnauthorizedError file misspelled as UnathorizedError (#10157) (6b45b2d)
- examples: localization example (#10134) (3bbc5bf)
- live-preview: strongly types message events (#10148) (466f109)
- richtext-lexical: export $createServerBlockNode, $isServerBlockNode and ServerBlockNode for the server (#10192) (1dc4b2c)
- ui: exports parseSearchParams (#10185) (5d3b816)
🤝 Contributors
- Sasha (@r1tsuu)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Seno (@s-en-o)
- James Mikrut (@jmikrut)
- Elliot DeNolf (@denolfe)
- Tobias Arends (@1b0t)
- Said Akhrarov (@akhrarovsaid)
- Dan Ribbens (@DanRibbens)
- Kethan Vegunta (@kethan1)
- Marcus Forsberg (@marcusforsberg)
- Germán Jabloñski (@GermanJablo)
Dec 21, 2024
v3.11.0 (2024-12-21)

🚀 Features
- db-sqlite: add autoIncrement option (#9427) (4e95353)
🐛 Bug Fixes
- ensures generated IDs persist on create (#10089) (957867f)
- db-mongodb: mongodb optimizations (#10120) (b08ff88)
- ui: join table row still shows after deletion (#9783) (a58b9fc)
- ui: ensure unpublish confirmation is reachable when opened in drawers (#10109) (ec853c4)
📚 Documentation
- remove stray backtick from Nested Docs Plugin page (#10118) (08eb13d)
- fix broken links (#10010) (2175451)
📝 Templates
- bump for v3.10.0 (#10107) (99481cb)
🤝 Contributors
- Sasha (@r1tsuu)
- Sam (@damnsamn)
- Alessio Gravili (@AlessioGr)
- Said Akhrarov (@akhrarovsaid)
- zuccs (@zuccs)
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
Dec 20, 2024
v3.10.0 (2024-12-20)

🚀 Features
- jsdocs for generated types, by using admin.description (#9917) (b330873)
- join field with polymorphic relationships (#9990) (d03658d)
- db-postgres, db-sqlite: drizzle schema generation (#9953) (23f1ed4)
  
  Full type safety on payload.drizzle with a single command
  
  pnpm payload generate:db-schema
  
  https://github.com/user-attachments/assets/96bddfe6-b598-42ae-8efd-eae7dab7a4e8
- make req partial and optional in DB / Local API operations (#9935) (0e5bda9)
- db-postgres, db-sqlite: drizzle schema generation (#9953) (23f1ed4)
- db-sqlite: add idType: 'uuid' support (#10016) (03ff775)
- ui: export RelationshipTable component (#10084) (6bba7be)
🐛 Bug Fixes
- unique error message regression (#10064) (0c57eef)
- commit transaction if a user isnt found in forgotPassword operation (#10055) (439dd04)
- db-mongodb: querying by localized polymorphic relationships using objects (#10037) (5753efb)
- db-postgres: relationships v2-v3 migration errors when migrating from v2 to stable v3 (#10080) (07be617)
- db-postgres: query has many relationships nested in row fields (#9944) (#9944) (eee6432)
- examples: awaits getHeaders in auth example (#10100) (7bedd6d)
- examples: add missing header component in auth example (#10088) (dd3c2eb)
- richtext-*: use correct "for" attribute for label (#10036) (97c120a)
- richtext-lexical: incorrect string interpolation in the upload converter (#10069) (6a8aeca)
- richtext-lexical: ui bug when zooming in Safari (#10072) (12dad35)
- storage-vercel-blob: fixes issue where files with spaces in their name would not be retrieved correctly (#10062) (ce74f1b)
- templates: broken preview if alternative auth strategy was used, invalid error handling (#9785) (d8c106c)
- ui: close copy locale modal after locale is changed (#10096) (59fc9d0)
- ui: join field "add new" calculate initial drawer data with relationship inside blocks (#10057) (1d46b6d)
⚡ Performance
- db-mongodb: improve performance of all operations, up to 50% faster (#9594) (e468292)
🛠 Refactors
- consistent caps for acronyms in variable names (#10101) (a7109ed)
- optimize database schema generation bin script (#10086) (7c4ea5b)
🧪 Tests
- revert default db adapter in integration tests to mongodb (#10079) (034b442)
- consolidates custom id e2e tests (#10061) (97a1f4a)
📝 Templates
- removes DATABASE_URI env var from with-vercel-website template .env.example (#10098) (52b1a9a)
- update dockerfiles (#10073) (997aed3)
- add Posts to internal links in website template (#10063) (605cf42)
🏡 Chores
- proper docker-compose postgres url (ba0e7ae)
- deps: bump turbo (044c22d)
- examples: updates auth example to latest (#10090) (7292220)
- richtext-slate: exports useElementButton, useLeafButton (#10047) (a501e60)
- templates: remove console.log that logs payload secret for security (#10095) (dec87e9)
🤝 Contributors
- Sasha (@r1tsuu)
- Shrinidhi Shastri (@shrinidhi4u)
- James Mikrut (@jmikrut)
- Dan Ribbens (@DanRibbens)
- Elliot DeNolf (@denolfe)
- Patrik (@PatrikKozak)
- Jacob Fletcher (@jacobsfletch)
- Mason Yekta (@masonyekta)
- Alessio Gravili (@AlessioGr)
- Andrzej Kłapeć (@klapec)
- Germán Jabloñski (@GermanJablo)
- Paul (@paulpopus)
Dec 18, 2024
v3.9.0 (2024-12-18)

🚀 Features
- add shouldRestore config to job queue tasks (#10059) (194a8c1)
- join field support relationships inside arrays (#9773) (b0b2fc6)
- db-mongodb: allow to customize mongoose schema options with collectionsSchemaOptions (#9885) (198763a)
- storage-*: add support for browser-based caching via etags (#10014) (ef90ebb)
🐛 Bug Fixes
- encodes upload filename urls (#10048) (1446fe4)
- passes field permissions to custom fields (#10024) (eb037a0)
- beforeValidate previousValue argument (#10022) (99ca1ba)
- cpa: updates CPAs w/ vercel-postgres db types to use POSTGRES_URL & updates .env.example to use generic env var strings (#10027) (70666a0)
- db-postgres: select query on upload fields with hasMany: true (#10029) (2ee3e30)
- payload-cloud: improve not found logging (#10058) (f29e633)
- plugin-search: prevent error on undefined value in linkToDoc component (#9932) (29ad1fc)
- templates: prevent image priority and lazy loading incompatibility (#10023) (7037983)
- ui: properly allows configuring rows for the textarea field (#10031) (61c5e0d)
- ui: properly sync field values in bulk upload preventing stale data overriding old docs (#9918) (7787105)
📚 Documentation
- fixes typo removeTokenFromRepsonse to removeTokenFromResponse (#10026) (13e0505)
📝 Templates
- document local development (#10032) (4bfa329)
- improve gen-templates script (#10015) (e04be4b)
- bump for v3.8.0 (#10013) (2d2a52b)
🔨 Build
- fix tsconfig monorepo setup (#10028) (f5c13de)
⚙️ CI
- add email-resend and email-* to scopes for pr-title workflow (#10053) (93dde52)
🏡 Chores
- fixes package license file casing (#10021) (b8de401)
🤝 Contributors
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
- Javier (@javierlinked)
- Jacob Fletcher (@jacobsfletch)
- Sasha (@r1tsuu)
- Dan Ribbens (@DanRibbens)
- Because789 (@Because789)
- Jarrod Flesch (@JarrodMFlesch)
- urquico (@urquico)
- Said Akhrarov (@akhrarovsaid)
- Hugo Knorr (@hkn-wt)
Dec 17, 2024
v3.8.0 (2024-12-17)

🚀 Features
- expose req to defaultValue function arguments (#9937) (6dea111)
- join field admin.defaultColumns (#9982) (2ec4d0c)
- db-vercel-postgres: allow to use a local database using pg instead of @vercel/postgres (#9771) (41167bf)
- graphql: graphQL custom field complexity and validationRules (#9955) (36e21f1)
- storage-vercel-blob: allow fallback to disk if token not set (#10005) (fa49e04)
🐛 Bug Fixes
- remove localized property from RowField and CollapsibleField (#9672) (c187bff)
- edit join field not rendering (#9971) (f5516b9)
- job collection was not added if job config only has workflows and no predefined tasks (#9963) (f48f981)
- db-sqlite: working point field CRUD and default value (#9989) (00909ec)
- templates: adds priority to hero images (#10003) (f54e180)
- ui: does not render row labels until form state returns (#10002) (ed44ec0)
- ui: automatically subscribes custom fields to conditional logic (#9928) (1502e09)
⚡ Performance
- reduce generated types for select by respecting interfaceName (#9870) (26a10ed)
🛠 Refactors
- deduplicate and abstract SQL schema building (#9987) (727fba7)
- plugin-seo: strongly type collection and global slugs in plugin config (#9962) (c167365)
📚 Documentation
- fix links in rich-text referencing old lexical sections (#9972) (c50f423)
- broken lexical link (#9991) (b0d648b)
🧪 Tests
- splits remaining field tests (#9959) (33d5482)
📝 Templates
- fix missing ts-ignore in seed script causing build errors (#10001) (8258d5c)
- bump for v3.7.0 (#10000) (0f63db0)
- add hero image field to posts instead of using the meta image for the hero as well (#9999) (12fa4fd)
- conditionally render the live preview listener component (#9973) (050ff84)
- fixes formatting issue with authors and footer not being at the bottom in the website template (#9969) (c2adf38)
- bump for v3.7.0 (#9966) (1d6a935)
⚙️ CI
- wait until version resolves in post-release-templates (#9968) (e073183)
🏡 Chores
- deps: bumps react-select to v5.9.0 to supress react 19 warnings (#9967) (4dc5003)
🤝 Contributors
- Sasha (@r1tsuu)
- Dan Ribbens (@DanRibbens)
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
- Said Akhrarov (@akhrarovsaid)
- zuccs (@zuccs)
- Paul (@paulpopus)
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
Dec 13, 2024
v3.7.0 (2024-12-13)

🚀 Features
- expose pagination: false to REST / GraphQL (#9952) (b101fec)
- add waitUntil property to payload.jobs.queue (#9950) (0d07ce2)
- allow loading predefined migrations from proper exports (#9872) (d4d79c1)
- allows excluding entities from the nav sidebar / dashboard without disabling its routes (#9897) (b1d92c2)
- ui: allow customizing min height of code editor (#9920) (bae2fe5)
🐛 Bug Fixes
- updates username validation to allow for all special character usage (#9946) (7a8b464)
- join collection read access (#9930) (5af71fb)
- db-postgres: payload.db.upsert inserts new rows instead of updating existing ones (#9916) (5e39634)
- plugin-nested-docs: publishing parent doc should not publish child doc (#9958) (50e7c24)
- translations: capitalized swedish 'collapseAll' translation (#9908) (821bd35)
- ui: awaits form state before rendering conditional fields (#9933) (796df37)
- ui: properly passes readOnly prop to email & username auth fields (#9938) (a582431)
- ui: truncates richtext fields when displaying within a joins field (#9911) (d9efd19)
🛠 Refactors
- ui: migrates away from React.forwardRef (#9907) (4c57df6)
- ui: export TableColumnsProvider, documentDrawerBaseClass and SelectMany (#9899) (00d438e)
📚 Documentation
- fix mdx error (#9945) (7e3fd5d)
- refactor and improve rich text docs (#9929) (abee24e)
- update Lexical to JSX documentation for RichText component (#9926) (9d324ff)
- fix typo (#9886) (e78b542)
🧪 Tests
- mock nodemailer network calls (#9957) (9c8cdea)
📝 Templates
- fix build by reducing strictness of eslint rules (#9943) (d78550c)
- set up prettier, bump next to 15.1.0, bump eslint to v9, set up .vscode configs (#9936) (c7272bb)
- change names of data variables to improve clarity between data and elements (#9912) (23e2f7b)
- fix preview path protocol not being https in production environments (#9910) (6a09fe1)
- fix live preview relative URLs on website template (#9906) (afa08d0)
- bump nextjs version to 15.1 (#9903) (d97d7ed)
- bump for v3.6.0 (#9900) (5c2f72d)
⚙️ CI
- update lint skip rules (0d8643a)
🏡 Chores
- use non-permanent / => /admin redirect so that the browser doesn't cache it for projects that don't redirect (#9948) (d57cad6)
- update what-is-payload.mdx (#9942) (9eb1b50)
- deflake postgres and sqlite integration joins test (#9939) (c298cbc)
- export JobLog and importHandlerPath, add missing id type to JobLog (#9921) (fffab66)
- payload-cloud: improve error log of staticHandler (#9934) (4334940)
- translations: improve password reset message (#9931) (6fffbdb)
- ui: export SearchFilter, EditUpload, FileDetails, PreviewSizes, PreviewButton, ErrorIcon, InfoIcon, SuccessIcon, WarningIcon (#9919) (c8046ca)
🤝 Contributors
- Jessica Chowdhury (@JessChowdhury)
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
- Sasha (@r1tsuu)
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Germán Jabloñski (@GermanJablo)
- Nate (@ncaminata)
- Dan Ribbens (@DanRibbens)
- Paul (@paulpopus)
- Marwin Hormiz (@marwinhormiz)
- Joachim Damsgaard (@nrone)
Dec 11, 2024
v3.6.0 (2024-12-11)

🚀 Features
- expose session, db in migrations to use the active transaction with the database directly (#9849) (b73fc58)
- consolidates create and duplicate operations (#9866) (ca52a50)
- allow where in payload.jobs.run (#9877) (b1ef28d)
- add payload.jobs.runByID (#9875) (09246a4)
- next: adds suppressHydrationWarning property to payload config admin options (#9867) (5223990)
🐛 Bug Fixes
- cannot pass function to client error when defining server-only props in custom field components (#9898) (91e8acc)
- ensures autosave only runs sequentially (#9892) (a0f0316)
- forgotPassword set expiration time (#9871) (306b5d2)
- upgrade pg snapshot during v3 upgrade if needed (#9837) (1e5364f)
- next: thread default ServerProps to view actions and other components that were missing (#9868) (0303b78)
- next: next.js 15.1.0 compatibility by not importing isRedirectError from next/dist (#9878) (5bfc92d)
- next: does not format top-level domains within admin.preview or livePreview.url functions (#9831) (e095222)
- richtext-*: field errors and descriptions were not displayed (#9824) (60ceeb0)
- richtext-lexical: lexical-html export (#9793) (d791db2)
- templates: website infinite reload bug with 404s in production mode (#9843) (d3b8d0c)
- ui: ensures admin.disableListFilter is disabled despite url search params (#9874) (da6bc55)
- ui: refreshes column state during hmr and respects admin.disableListColumn despite preferences (#9846) (f7172b5)
- ui: prevents unwanted data overrides when bulk editing (#9842) (563694d)
🛠 Refactors
- richtext-lexical: export useBlockComponentContext and useInlineBlockComponentContext (#9896) (b83ea84)
- richtext-lexical: export JSXConverter type (#9815) (7599ede)
📚 Documentation
- properly capitalize SQLite and Next.js (#9848) (7642837)
- add missing types, prefer pnpm, fix various typos, discourage using payload from import (#9847) (254d888)
- fix typo (#9845) (36c2714)
🧪 Tests
- properly mock nodemailer verify in unit test (#9832) (e746d7a)
📝 Templates
- bump for v3.5.0 (#9844) (43a0ce7)
- website template added changes for seed script, relative live preview URLs and fixed endpoint status code (#9808) (b0c9b41)
- bump for v3.5.0 (#9804) (1fdc7cc)
⚙️ CI
- add missing tests to all-green dependency array (#9825) (84abfdf)
- add PR co-authors to contributors section of release notes (e236c28)
- add types testing with tstyche (#9803) (f09ee0b)
- adjust tag detection for post-release-templates (67a35d3)
🏡 Chores
- better default for useAsTitle with custom auth collections (#9841) (fee1744)
- post-release-templates fetch tags (2c0bea8)
- update template lockfiles (a80de3f)
- deps: upgrade dataloader dependency from 2.2.2 to 2.2.3 (#9823) (dc741bb)
🤝 Contributors
- Alessio Gravili (@AlessioGr)
- Sasha (@r1tsuu)
- Said Akhrarov (@akhrarovsaid)
- James Mikrut (@jmikrut)
- Patrik (@PatrikKozak)
- Dan Ribbens (@DanRibbens)
- Jarrod Flesch (@JarrodMFlesch)
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
- Paul (@paulpopus)
- Jayce Pulsipher (@jaycetde)
- Riley Pearce (@rilrom)
- Tom Mrazauskas (@mrazauskas)
Dec 6, 2024
v3.5.0 (2024-12-06)

🚀 Features
- upgrade to React 19 stable and Next.js 15.0.4 (#9801) (8f3f449)
  
  It is recommended to upgrade to React 19 stable and Next.js 15.0.4 in your existing project. The pnpm.overrides and overrides keys are not needed anymore!
  
  To do that, change the following in your package.json:
```
...
  "dependencies": {
-    "next": "15.0.3",
+    "next": "15.0.4",
-    "react": "19.0.0-rc-66855b96-20241106",
-    "react-dom": "19.0.0-rc-66855b96-20241106",
+    "react": "19.0.0",
+    "react-dom": "19.0.0",
     ...
  },
  "devDependencies": {
-    "@types/react": "npm:types-react@19.0.0-rc.1",
-    "@types/react-dom": "npm:types-react-dom@19.0.0-rc.1".
+    "@types/react": "19.0.1",
+    "@types/react-dom": "19.0.1",
  },
-  "pnpm": {
-    "overrides": {
-      "@types/react": "npm:types-react@19.0.0-rc.1",
-      "@types/react-dom": "npm:types-react-dom@19.0.0-rc.1"
-    }
-  },
-  "overrides": {
-    "@types/react": "npm:types-react@19.0.0-rc.1",
-    "@types/react-dom": "npm:types-react-dom@19.0.0-rc.1"
-  }
```
- export sanitizeSelectParam, sanitizePopulateParam, senitizeJoinParams utils (#9777) (afd0b54)
- allow to define global label as function (#9759) (0829a35)
- live-preview: supports relative urls for dynamic preview deployments (#9746) (f12b4dc)
- next: supports relative preview URLs (#9755) (1fc9c47)
🐛 Bug Fixes
- defaultPopulate and populate with nested to arrays/blocks properties (#9751) (7def6b7)
- getPayload generate import map only when used in Payload Admin Panel (#9371) (d8f7034)
- db-mongodb: bump mongoose to 8.8.3 (#9747) (840dde2)
- db-postgres: handle select query on select fields (#9607) (dff71ee)
- ui: collapsed array state on input change (#9800) (62fc2f5)
- ui: join field ignoring defaultSort and defaultLimit (#9766) (a11243e)
- ui: disable doc submenu when parent button is disabled (#9750) (1ab3be6)
- ui: stale locale value from useLocale (#9582) (fa7ed3f)
- ui: only render header dom node if needed (#9742) (8e26824)
- ui: incorrect label size for group field (#9740) (4a324a9)
📚 Documentation
- adds missing "to" in jobs-queue/overview (#9778) (de53f2a)
- plugin-search: add info on collection reindexing (#9764) (c9ce350)
📝 Templates
- bump for v3.4.0 (#9780) (d3232b9)
- improvements to seed speed on website template and updated hero and collapsible fields (#9779) (19ddd3c)
- fixes the seeding for the website template when using postgres (#9758) (3d1305d)
- improve speed of seed script (#9748) (2321970)
- website: add next sitemap robots disallow config for /admin (#9761) (97d3bb1)
⚙️ CI
- add nightly stale cron (#9802) (a1a0a07)
- explicitly use ubuntu-24.04 instead of latest to ensure compat (#9786) (bbf35a6)
- fetch-depth 0 needed for lint job (a108986)
- main workflow improvements (#9784) (4cc6f4c)
- only run tests when needed via needs_tests filter (#9781) (cb691e0)
- post-release-templates assign PR to user that triggered (ef8d3c9)
- post-release-templates always use latest tag with workflow_dispatch (28c6b2a)
- use PAT for post-release-templates (c2ff9b1)
- ensure clean all script does not error after retrying step, by installing globby and chalk globally (#9745) (84a5b40)
- ensure triage actions work for PRs from forks (12a8bba)
🏡 Chores
- cpa: updates .env.example env vars along side .env vars based on selected DB (#9757) (1aa23d3)
- richtext-lexical: remove outdated custom block component examples (#9754) (61a4656)
- templates: migrate to new richtext component in website template (#9615) (89db8fb)
- translations: improved serbian translations for the lexical editor (#9795) (10eab87)
- ui: expose onInputChange from react-select in SelectInput component (#9728) (8f785e1)
Dec 4, 2024
v3.4.0 (2024-12-04)

🚀 Features
- adds configurable expiration prop for password reset tokens (#9710) (9bffa09)
🐛 Bug Fixes
- hidden and disabled fields cause incorrect field paths (#9680) (a53c1d5)
- join field description, custom components and loading state (#9703) (67179a7)
- error after view is left idle on edit views (#9709) (fbb59ba)
- copy data from locale transaction error (#9673) (d047f01)
- richtext-lexical: ensure hooks from sub-fields receive document data and doc props, and not node data and doc props (#9406) (50823be)
- ui: copy to locale incorrect label when locale label is defined as object (#9705) (18f9f35)
📚 Documentation
- add output standalone in docker deployment section (#9738) (340bc85)
- sqlite is also supported (#9690) (d118544)
- fix typo in Collections.mdx (#9696) (0f2feac)
📝 Templates
- vercel migrations (#9730) (32f0f34)
- website template copy code button darkmode behavior (#9715) (fd9a007)
- vercel website template migrations wrong adapter import (#9708) (01d5746)
- website: add sitemap support to website template (#9727) (fce210b)
- website: add new favicons and og images to website template (#9716) (1bd689b)
- website: website remove maxDepth from references in link field (#9702) (d2007b1)
⚙️ CI
- template bump workflow (#9733) (f5aad49)
- create separate post-release-templates workflow (0c34f27)
- pin specific github-releases-to-discord version (7bd1a16)
🏡 Chores
- adds jsdocs for auth.forgotPassword.expiration prop (#9739) (c7218c0)
- fix broken links in collections.mdx (#9697) (2ef7de5)
- workflow rename (188466d)
- change deprecation warning for getPayloadHMR to warning (#9700) (643c92d)
- next: remove unused sanitizeEditViewProps fn (#9569) (92a01c2)
- templates: add initial migrations for vercel with website template (#9706) (3f32224)
🤝 Contributors
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
- DracoBlue (@DracoBlue)
- Alessio Gravili (@AlessioGr)
- Paul (@paulpopus)
- Nate (@ncaminata)
- Jacob Fletcher (@jacobsfletch)
- DesertShadow (@MotorcycleEnjoyer)
- Dan Ribbens (@DanRibbens)
- Jarrod Flesch (@JarrodMFlesch)
- Sasha (@r1tsuu)
- Francisco Lourenço (@franciscolourenco)
Dec 3, 2024
v3.3.0 (2024-12-03)

🚀 Features
- disableLocalStrategy with auth fields still enabled (#9579) (6104fe5)
- export built-in field validations (#9622) (519752f)
- examples: add custom server example [skip-lint] (#9641) (fdfa07b)
- ui: adds beforeInput & afterInput props for arrays, blocks, collapsible, group, radio, & relationship fields. (#9674) (58b7415)
- ui: upgrade react-datepicker dependency from 6.2.0 to 7.5.0 (#9654) (9d72408)
- ui: export CodeEditor (#9650) (963387f)
- ui: export TabsProvider and TabComponent (#9647) (f151723)
🐛 Bug Fixes
- throw proper error if import handler paths are not able to be imported, improve import handler path docs (#9679) (0dbfc23)
- ensure jobs do not retry indefinitely by default, fix undefined values in error messages (#9605) (a89d544)
- latest: true version disappear on parallel writes (#9032) (631edd4)
- duplicate afterRead collection hook call on loginOperation (#9664) (c5fe021)
- job task output data was not fetched and restored, if task failed previously (#9651) (f076797)
- prevent workflow destructuring errors for failing tasks (#9649) (4cd31ce)
- ensure job errors are saved in payload (#9644) (e6ea68e)
- live-preview: populates localized relationships in client-side live preview (#9617) (3d1a065)
- next: remove keyboard focus for closed nav items (#9558) (2d2e7d5)
- plugin-search: delete proper search document when doc has the same value but different relationTo (#9616) (b896507)
- richtext-lexical: ensure lexical doesn't break if used without react installed (#9620) (030b759)
- richtext-lexical: add form id to drawSlug (#9613) (9892303)
- translations: changes rs and rs-Latin dateFNSkey to proper locale instead of en-US (#9621) (2b4522b)
- ui: data disappearing when form state updates in globals (#9682) (d1de106)
- ui: properly animates height for dynamically rendered children (#9665) (d04cea1)
- ui: upgrade sonner from 1.5.0 to 1.7.0 (#9666) (24c75b0)
- ui: upgrade react-select, fixes type issues with select input (#9653) (73e0e25)
🛠 Refactors
- deprecates params and search params contexts (#9581) (edc04ae)
📚 Documentation
- add payload.auth to local api (#9632) (cf34d3a)
- add upgrade from previous beta section to migration guide (#9642) (1e8c9d3)
- fix links to /access-control/overview (#9619) (bc2d7c9)
- adds missing comma to example config in localization.mdx (#9618) (aa5dd8a)
⚙️ CI
- allow more commit types in release notes (#9677) (e4c3c5b)
- add back CI-level automatic retrying for failing int and e2e tests (#9652) (0b445c8)
- add github-releases-to-discord (702df1f)
- small tweaks to post-release (f150a68)
🏡 Chores
- upgrade all dependencies used to build payload (swc, esbuild, react compiler, babel) (#9658) (877b899)
- upgrade all react and next-related packages (#9655) (71ba4a8)
- add contributor count badge to readme (0716128)
- examples: migrates form-builder example to 3.0 (#9681) (40f5c72)
- scripts: fix generate template variations script (#9671) (5b3079a)
🤝 Contributors
- Paul (@paulpopus)
- Dan Ribbens (@DanRibbens)
- Patrik (@PatrikKozak)
- Harley Salas (@HarleySalas)
- Alessio Gravili (@AlessioGr)
- Elliot DeNolf (@denolfe)
- Tobias Arends (@1b0t)
- Jacob Fletcher (@jacobsfletch)
- Said Akhrarov (@akhrarovsaid)
- Riley Pearce (@rilrom)
- Yunsup Sim (@SimYunSup)
- Sasha (@r1tsuu)
- Vasileios Drosatos (@drosi94)
Nov 29, 2024
v3.2.2 (2024-11-29)

🚀 Features
- richtext-lexical: fully-typed blocks in JSX serializer (#9554) (519bb79)
🐛 Bug Fixes
- add generic to LabelFunction to prevent type error for custom translation keys (#9335) (27eeac2)
- do not send admin dependencies to client (#9583) (3da9be0)
- incorrect formState after doc save (#9573) (4b302f2)
- plugin-sentry: capture non APIError errors to sentry (#9595) (61a51ca)
- richtext-lexical: allow exiting the RTE with the keyboard in Firefox (#8654) (3c35d81)
- richtext-lexical: various JSX converter issues (#9570) (17c7945)
- ui: ensure UI is reactive to HMR changes, without having to refresh the page (#9602) (c4327f2)
- ui: css is not defined error in production build (#9603) (36a6a19)
- ui: retains search params when navigating back (#9576) (3961223)
- ui: ensure Form submit button only uses onClick handler when needed, as that was causing issues with password manager extensions (#9572) (ca07c9f)
🤝 Contributors
- Alessio Gravili (@AlessioGr)
- Sasha (@r1tsuu)
- Marwin Hormiz (@marwinhormiz)
- Chris Aprea (@aprea)
- Said Akhrarov (@akhrarovsaid)
- Arne Wiese (@wiesson)
- Jarrod Flesch (@JarrodMFlesch)
- Riley Pearce (@rilrom)
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
Nov 27, 2024
v3.2.1 (2024-11-27)

🐛 Bug Fixes
- plugin-search: missing copyfiles script, incorrect scss import (#9552) (6af4dee)
🤝 Contributors
- Elliot DeNolf (@denolfe)
- Alessio Gravili (@AlessioGr)
Nov 27, 2024
v3.2.0 (2024-11-27)

🚀 Features
- adds ability to copy data from across locales (#8203) (601759d)
- deprecates react-animate-height in favor of native css (#9456) (0757e06)
- plugin-search: added support for reindexing collections on demand (#9391) (defa13e)
- richtext-lexical: export hasText helper (#9484) (21db058)
- richtext-lexical: lexical => JSX converter (#8795) (bffd98f)
⚡ Performance
- faster page navigation by speeding up createClientConfig, speed up version fetching, speed up lexical init. Up to 100x faster (#9457) (fd0ff51)
🐛 Bug Fixes
- utilizes override access false (#9550) (2248be4)
- overrides entity visibility within drawers (#9546) (5d18a52)
- allows for emails to be non unique when allowEmailLogin is false (#9541) (67a9d66)
- skip validation of where query paths from access result (#9349) (a9f511d)
- corrects localizer positioning in RTL mode (#9494) (910b681)
- next: properly threads field permissions through versions diff (#9543) (f19053e)
- plugin-form-builder: allow overrides to the payment fields group (#9522) (71c2f63)
- plugin-seo: enforce readonly on the client (#9536) (44c0cdb)
- richtext-lexical: prevent use of text formats whose features were not enabled (#9507) (90f893a)
- templates: website priority with loading lazy on medium hero error (#9537) (dac42ff)
- ui: remove overflow hidden from app-header wrappers since it breaks any popout elements (#9525) (82145f7)
🤝 Contributors
- Jarrod Flesch (@JarrodMFlesch)
- Anthony Bouch (@58bits)
- Germán Jabloñski (@GermanJablo)
- Jacob Fletcher (@jacobsfletch)
- Said Akhrarov (@akhrarovsaid)
- Alessio Gravili (@AlessioGr)
- Jessica Chowdhury (@JessChowdhury)
- Elliot DeNolf (@denolfe)
- Patrik (@PatrikKozak)
- Paul (@paulpopus)
- Sasha (@r1tsuu)
- Harley Salas (@HarleySalas)
Nov 25, 2024
v3.1.1 (2024-11-25)

🚀 Features
- templates: website template performance improvements (#9466) (aa1d300)
- templates: website optimisations for image sizes and loading (#9447) (be8cd7f)
⚡ Performance
- flattenedFields collection/global property, remove deep copying in validateQueryPaths (#9299) (cae300e)
🐛 Bug Fixes
- incorrect locale registration in datepicker (#9516) (6ffd4c7)
- improper spread of list preferences (#9510) (f136a7d)
- correct migrations sorting in getMigrations (#9330) (e176b8b)
- run queues via the /payload-jobs/run endpoint without workflows (#9509) (b96475b)
- ensure deleteJobOnComplete property for jobs works (#9283) (7eb388d)
- db-mongodb: sanitizeRelationshipIDs named tabs within tabs (#9400) (b5f89d5)
- db-postgres: allow to clear select fields with hasMany: true (#9464) (e5cc915)
- templates: website template firefox logo fix and images fix on vercel (#9459) (23d54a7)
- templates: vercel website template payload config regression (#9455) (09abebd)
- templates: fixes imports in website template from @payloadcms/ui to be direct (#9451) (90fedbc)
- translations: add sl to acceptedLanguages (#9506) (0c7e418)
- ui: prevents column reset on sort (#9517) (8383426)
- ui: z-index on react-select menu (#9512) (af096a3)
🤝 Contributors
- Tylan Davis (@tylandavis)
- Sasha (@r1tsuu)
- Elliot DeNolf (@denolfe)
- Said Akhrarov (@akhrarovsaid)
- Jacob Fletcher (@jacobsfletch)
- Francisco Lourenço (@franciscolourenco)
- Jarrod Flesch (@JarrodMFlesch)
- Jeffrey Arts (@JeffreyArts)
- Harley Salas (@HarleySalas)
- Indy (@IndySeh)
- Alessio Gravili (@AlessioGr)
- Paul (@paulpopus)
Nov 22, 2024
v3.1.0 (2024-11-22)

🚀 Features
- add skip and force accept flags to migration commands (#8843) (fb3242d)
- richtext-lexical: more powerful custom Block RSCs, improved selection handling (#9422) (9e31e17)
- richtext-lexical: allow customizing maxActiveItems for toolbar groups (#9417) (38de760)
- richtext-lexical: export lexical drawer hooks (#9415) (3b68671)
- templates: update website styles and new home hero image (#9413) (2036a56)
🐛 Bug Fixes
- invalid payload.collections type (#9414) (91dcf6d)
- unable to load documents with non-standard ids (#9407) (ee1a91e)
- error when opening admin panel without any permissions (#9392) (9470f9b)
- db-postgres: joins with versions and hasMany relationship (#9370) (d499de1)
- live-preview: client-side live preview cannot clear all array rows (#9439) (ae6c71b)
- next: threads server props to custom providers (#9412) (f5683b0)
- next: next@15.0.3 compatibillity for turbopack warnings patch (#9341) (f2205d1)
- richtext-lexical: error when changing block collapsed state in rare cases (#9421) (b9cc4d4)
- richtext-lexical: slash menu from + button did not trigger item select action (#9420) (a891e98)
- richtext-lexical: slash menu query doesn't disappear after selecting slash menu item (#9396) (3d0424b)
- richtext-lexical: preserve indent and text-align when converting Lexical <-> HTML (#9165) (0960290)
- templates: website template breaking change by renaming hero image to jpg (#9416) (18b139b)
- ui: add disabled attribute to blocks drawer toggler (#9424) (27acdae)
- ui: stale server components when rows are moved (#9410) (e3866c4)
- ui: error when collapsing sidebar groups (#9393) (90e37fe)
🤝 Contributors
- Jacob Fletcher (@jacobsfletch)
- Riley Pearce (@rilrom)
- Jessica Chowdhury (@JessChowdhury)
- Germán Jabloñski (@GermanJablo)
- Alessio Gravili (@AlessioGr)
- Paul (@paulpopus)
- Sasha (@r1tsuu)
- Friggo (@MrFriggo)
- Patrik (@PatrikKozak)
- Jarrod Flesch (@JarrodMFlesch)
Nov 20, 2024
v3.0.2 (2024-11-20)

🐛 Bug Fixes
- allow self referencing relationships when adding new collections to config (#9360) (4030e21)
- next: properly sets doc id types when using postgres (#9381) (07a9125)
- next: autosave document rendering (#9364) (9e85be0)
- richtext-lexical: use copy of @lexical/markdown that does not install @lexical/code (#9382) (5db7e1e)
- ui: prioritize server rendered Actions in ActionsProvider (#9379) (439dcd4)
- ui: invalid permissions passed to group and named tab sub-fields (#9366) (c67291d)
- ui: bulk update and delete ignoring search query (#9377) (ef37483)
🤝 Contributors
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Jarrod Flesch (@JarrodMFlesch)
- Elliot DeNolf (@denolfe)
- Said Akhrarov (@akhrarovsaid)
- Evan Cusack (@cusacke)
- Patrik (@PatrikKozak)
Nov 19, 2024
v3.0.1 (2024-11-19)

⚡ Performance
- significantly reduce HTML we send to the client. Up to 4x smaller (#9321) (5d2b0b3)
🐛 Bug Fixes
- allow setting admin path route from config (#8085) (d3b0a04)
- templates: website logo not showing (#9334) (7f65c83)
- templates: seeding in website template moved to a separate route so timeout can be customised (#9327) (26cb1e1)
- ui: could not save selection from upload has many drawer (#9325) (f42b1e1)
- ui: client side doc data not updating after save (#9340) (661f450)
- ui: show required indicator for select fields (#9348) (2c7ea63)
- ui: proper permissions within version diff view (#9346) (188baec)
- ui: addFieldRow set modified (#9324) (0f3f6e7)
🤝 Contributors
- Elliot DeNolf (@denolfe)
- Jarrod Flesch (@JarrodMFlesch)
- Said Akhrarov (@akhrarovsaid)
- Jessica Chowdhury (@JessChowdhury)
- Jacob Fletcher (@jacobsfletch)
- Patrik (@PatrikKozak)
- Marc Maceira (@marcmaceira)
- Paul (@paulpopus)
- James Mikrut (@jmikrut)
- garrettgrohman (@garrettgrohman)
- Sean Zubrickas (@zubricks)
- Alessio Gravili (@AlessioGr)
- Blain Maguire (@BlainMaguire)
Nov 19, 2024
This is a major release that includes a re-architecture of Payload from an Express + React Router SPA to the Next.js App Router + RSCs. In addition to this architectural change, we've also shipped a ton of large features, miscellaneous fixes, and DX improvements.

Architectural changes
- Payload now installs fully in any Next.js app router
- You can now deploy your entire project (frontend and backend) in one app
- Payload can now be deployed serverless on platforms like Vercel
- Everything Payload does now works seamlessly within any Next.js project
- You can now use the Payload Local API in Server Components and Server Functions
- Postgres, Live Preview, and Lexical have been marked as stable
- All Payload exports have been significantly cleaned up and organized
- Payload is now an ESM project
- Payload is now modular, and we now publish new packages ui, next, translations, and graphql
- The Payload config is now server-side only, and works in any Node environment
- Server-side HMR works out of the box - removing the need for nodemon
Large features
- Join field - bi-directional relationships, more control over the database schema, and more
- Select API - select specific fields when querying using Local API
- Jobs Queue - background jobs fully supported in Payload with no third-party dependencies
- Populate / DefaultPopulate API - determine which fields should be retrieved when Payload populates relationships
- Lexical blocks and inline blocks - easily make Payload Blocks available in Lexical as custom rich text features
- SQLite database adapter now available
- Vercel Postgres database adapter released, specifically for serverless deploys on Vercel
- Live Preview server components support
- Admin UI has been refreshed
- hasMany upload fields are now supported
- Bulk upload has been added
- Document Locking pattern has been implemented, which shows if someone is currently editing a document
- Ability to publish individual locales one at a time has been added
- Lexical now has Table support
Small but still important features
- New Payload logo (thanks Candycode!)
- New Resend email adapter is now available
- Postgres now saves single, monomorphic relationships directly in a column rather than in _rels table
- GraphQL has been abstracted into a specific Next.js route handler, and no longer affects Payload initialization at all
- React Compiler has been introduced into Payload build pipeline
- You can now run migrations on init, rather than only in CI (helpful for long-running servers)
- New Local API operations - count, countVersions, countGlobalVersions, upsert
- Adds baseListFilter function to allow enforced list view filters based on user
- Lexical fixed toolbar option has been added
- Optimized the way that relational DBs store relations
- Postgres point field is now supported
- Postgres deep JSON querying is now supported
- Cuztomize Drizzle schema by passing in your own, which is handled outside of Payload
- Fully typed i18n t function
- Focal point data is now stored on uploads
- Adds ability to login with username rather than email
- New pattern for passing custom server / client props to custom components
- Email adapter pattern, including optimized Resend HTTP client
- Reduced / optimized the shape of /access permissions results
- Allows sorting by multiple fields
- MongoDB now saves ObjectID for relationships
- Adds more control over log level customization
- Downgrades common errors like NotFound or Forbidden to info
- Swaps out react-toastify for sonner
- True "virtual" fields via virtual: true
- Adds ability to customize filenames before upload
- Adds locale indicators to localized field labels
- Scope all payload css to payload-default layer
- Document duplicate / delete from drawers
⚠️ BREAKING CHANGES

This release includes breaking changes. In order to update from version 2 to 3, please review the migration docs.

🤝 Contributors
- James Mikrut (@jmikrut)
- Elliot DeNolf (@denolfe)
- Dan Ribbens (@DanRibbens)
- Said Akhrarov (@akhrarovsaid)
- Germán Jabloñski (@GermanJablo)
- Jarrod Flesch (@JarrodMFlesch)
- Sophia Michelle Andren (@sandren)
- Patrik (@PatrikKozak)
- Nate (@ncaminata)
- mattddean (@mattddean)
- Sasha (@r1tsuu)
- Jacob Fletcher (@jacobsfletch)
- Mikkel Wied Frederiksen (@mikkelwf)
- Alessio Gravili (@AlessioGr)
- Paul (@paulpopus)
- Tobias Odendahl (@tak-amboss)
- Jessica Chowdhury (@JessChowdhury)
- Ruy Monteiro (@ruymon)
- Nathan Clevenger (@nathanclevenger)
- Kendell Joseph (@kendelljoseph)
- Steve (@steventsvetkov)
- Mikkel Madsen (@miguel2650)
- Tylan Davis (@tylandavis)
- Javier (@javierlinked)
- Timothy Choi (@tyteen4a03)
- Andreas Bernhard (@abernh)
- Friggo (@MrFriggo)
- Jesper We (@JesperWe)
- vahacreative (@vahacreative)
- Manuel Leitold (@agrippa1994)
- Gregor Gabrič (@GregorGabric)
- Konsequanzheng (@Konsequanzheng)
- Brandon Kocur (@Brandoko)
- Anders Semb Hermansen (@andershermansen)
- Hristiyan Dodov (@hdodov)
- MotorcycleEnjoyer (@MotorcycleEnjoyer)
- Because789 (@Because789)
- Ante (@azivkovi)
- Mike Bailey (@mykz)
- Riley Pearce (@rilrom)
- Louis Ba (@muyunz)
- gervickas.js (@wellitongervickas)
- Frank Omondi (@Dofften)
- Thành Trang (@trangcongthanh)
- Victor Winberg (@VictorWinberg)
- Florian Quiblier (@fofoy)
- Christoffer Hasselberg (@stofolus)
- Hampus Wallentin Olsen (@hampusolsen)
- Bruno Crosier (@brunocrosier)
- Alexander (@Arctomachine)
- Francisco Lourenço (@franciscolourenco)
- Giuseppe Chiruzzi (@xfloor)
- Ritsu (@r1tsuu)
- Willy Brauner (@willybrauner)
- Michel v. Varendorff (@mvarendorff)
- Lynn Dylan Hurley (@lynndylanhurley)
- Hulpoi George-Valentin (@GeorgeHulpoi)
- Jasper Beaurain (@JasperBeaurain)
- Wilson (@WilsonLe)
- Harley Salas (@HarleySalas)
- Frederic Perron (@FredPerr)
- Viet-Tien (@nvti)
- Patryk Kowalczyk (@Patryk-Kowalczyk)
- Leo Hilsheimer (@linobino1)
- zvizvi (@zvizvi)
- Francis Turmel (@fturmel)
Nov 19, 2024
v3.0.0-beta.135 (2024-11-19)

🚀 Features
- new Payload logo (#9240) (54379ec)
- richtext-lexical: mdx support (#9160) (d4f1add)
⚡ Performance
- removes unnecessary field styles from initial page response (#9286) (30947d2)
🐛 Bug Fixes
- queues types with strict: true (#9281) (e40141b)
- nav jumping around if no nav preferences are set (#9301) (0a6f530)
- sanitize sub block field permissions correctly (#9296) (5503afd)
- getPayload node exits on webpack-hmr websocket failure (#9279) (488c28c)
- db-mongodb: potential errors in sanitizeRelationshipIDs with ref being a non object (#9292) (665b353)
- graphql: loading of polymorphic hasMany relationships (#9175) (0075b99)
- next: passes doc through edit view handler (#9302) (ec95ce8)
- next: passes locale through requests in live preview edit view (#9298) (54ac8b9)
- next: initialize payload with importMap (#9297) (58ac784)
- templates: remove req from seed script (ecbafbf)
- templates: seed from url (#9306) (333da1b)
- ui: safely accesses field in default filter component (#9276) (1a31e63)
⚠️ BREAKING CHANGES
- removes unnecessary field styles from initial page response (#9286) (30947d2)
  
  This only effects those who are importing Payload's field components into your own Custom Components or front-end application. The width prop no longer exists. It has been consolidated into the existing style prop. To migrate, simply move this prop as follows:
  
  import { TextInput } from '@payloadcms/ui export const MyCustomComponent = () => { return ( <TextInput - width="60%" style={{ + width: "60%, }} /> ) }
🤝 Contributors
- Said Akhrarov (@akhrarovsaid)
- Dan Ribbens (@DanRibbens)
- Elliot DeNolf (@denolfe)
- Germán Jabloñski (@GermanJablo)
- James Mikrut (@jmikrut)
- Sophia Michelle Andren (@sandren)
- Jarrod Flesch (@JarrodMFlesch)
- Patrik (@PatrikKozak)
- Nate (@ncaminata)
- mattddean (@mattddean)
- Sasha (@r1tsuu)
- Jacob Fletcher (@jacobsfletch)
- Mikkel Wied Frederiksen (@mikkelwf)
- Alessio Gravili (@AlessioGr)
Nov 17, 2024
v3.0.0-beta.134 (2024-11-17)

🚀 Features
- support relationship writes using objects instead of IDs (#9253) (d21fca9)
- deprecates getPayloadHMR in favor of simpler getPayload (#9249) (31b32ef)
- richtext-lexical: allow replacing entire blocks with custom components (#9234) (63cc966)
⚡ Performance
- richtext-lexical: significantly reduce lexical rerendering and amount of network requests from blocks (#9255) (35917c6)
🐛 Bug Fixes
- proper casing for default root views (#9248) (ed21c1c)
- next: custom default root views (#9247) (c4269d2)
- ui: avoid calling getTableState from join field on create (#9256) (ef2475d)
⚠️ BREAKING CHANGES
- proper casing for default root views (#9248) (ed21c1c)
  
  Custom account and dashboard views now defined as lowercase in the config.
  
  import { buildConfig } from 'payload' const config = buildConfig({ // ... admin: { components: { // ... views: { // ... - Account: ... - Dashboard: ... + account: ... + dashboard: ... }, }, }, })
- richtext-lexical: significantly reduce lexical rerendering and amount of network requests from blocks (#9255) (35917c6)
  
  The field RSC now provides an initial state for all lexical blocks. This completely obliterates any flashes and lexical block loading states when loading or saving a document.
  
  This removes the feature.hooks.load and feature.hooks.save interfaces from custom lexical features, as they weren't used internally and added unnecessary, additional overhead.
  
  If you have custom features that use those, you can migrate to using normal payload hooks that run on the server instead of the client.
🤝 Contributors
- Sasha (@r1tsuu)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
- James Mikrut (@jmikrut)
Nov 16, 2024
v3.0.0-beta.133 (2024-11-16)

🚀 Features
- templates: programmatic migration gen (#9238) (1393d84)
🐛 Bug Fixes
- corrects cases of false positive identification of custom id fields (#9245) (9b00b59)
🤝 Contributors
- Elliot DeNolf (@denolfe)
- James Mikrut (@jmikrut)
Nov 15, 2024
v3.0.0-beta.132 (2024-11-15)

🐛 Bug Fixes
- templates: vercel website migrations (#9235) (30d66bf)
- ui: lexical was incorrectly set to readonly in blocks, groups, and tabs (#9237) (131d1be)
🤝 Contributors
- James Mikrut (@jmikrut)
- Elliot DeNolf (@denolfe)
Nov 15, 2024
v3.0.0-beta.131 (2024-11-15)

🚀 Features
- sanitise access endpoint (#7335) (26ffbca)
- bumps date-fns to 4.1.0 (#9221) (6845878)
- re-order DefaultCellComponentProps generics (#9207) (77c99c2)
- db-mongodb: update mongoose to 8.8.1 (#9115) (7c6f419)
- db-mongodb: support query options in db update operations (#9191) (2d2d020)
- richtext-lexical: add tooltips to toolbar dropdown items (#9218) (7294880)
- richtext-lexical, ui: add icon if link opens in new tab (#9211) (82e72fa)
- storage-uploadthing: upgrade to v7 (#8346) (4690cd8)
⚡ Performance
- removes undefined props from rsc requests (#9195) (2d7626c)
- removes i18n.supportedLanguages from client config (#9209) (5482e7e)
🐛 Bug Fixes
- improve collection / global slugs type-safety in various places (#8311) (810c29b)
- duplicate list preferences stored (#9185) (a5cae07)
- wires up abort controller logic for list columns (#9180) (129fadf)
- ui: jumping hasmany uploads when form is submitting or in readonly mode (#9198) (315b4e5)
- ui: fixes layout shift when form is submitted (#9184) (e6d0443)
⚠️ BREAKING CHANGES
- db-mongodb: update mongoose to 8.8.1 (#9115) (7c6f419)
  
  MongoDB projects need to run a migration after updating to this beta version, because all relationship IDs are now stored as ObjectID (as they should have always been saved) and we need to migrate your existing relationship data from string-based IDs to ObjectIDs.
  
  To create this migration, run:
  
  pnpm payload migrate:create --file @payloadcms/db-mongodb/relationships-v2-v3
  
  And then run your migrations using:
  
  pnpm payload migrate
  
  In addition, if your project is heavily relying on using the Mongoose models directly, you may want to review the upgrade guides from v6 to v7 and v7 to v8, making adjustments as needed.
- bumps date-fns to 4.1.0 (#9221) (6845878)
- improve collection / global slugs type-safety in various places (#8311) (810c29b)
  
  Improves type-safety of collection / global slugs by using CollectionSlug / UploadCollectionSlug and GlobalSlug types instead of string in these places: Adds UploadCollectionSlug and TypedUploadCollection utility types
  
  This also changes how we suggest to add an upload collection to a cloud-storage adapter: Before:
  
  azureStorage({ collections: { [Media.slug]: true, }, })
  
  After:
  
  azureStorage({ collections: { media: true, }, })
- re-order DefaultCellComponentProps generics (#9207) (77c99c2)
  
  Changes the order of the DefaultCellComponentProps generic type, allowing us to infer the type of cellData when a ClientField type is passed as the first generic argument. You can override the cellData type by passing the second generic.
  
  Previously:
  
  type DefaultCellComponentProps<TCellData = any, TField extends ClientField = ClientField>
  
  New:
  
  type DefaultCellComponentProps<TField extends ClientField = ClientField, TCellData = undefined>
  
  You can override the cellData type by passing in the second argument to the generic. ie if you know the shape of your data differs than the inferred type then you can do something like:
  
  DefaultCellComponentProps<RelationshipFieldClient, { myShape: string, here: string }>
- storage-uploadthing: upgrade to v7 (#8346) (4690cd8)
  
  Upgrade uploadthing to v7
  
  The options that can be passed to the plugin now mirror the UTApiOptions of v7.
  
  The most notable change is to pass token with process.env.UPLOADTHING_TOKEN instead of apiKey with process.env.UPLOADTHING_SECRET.
  
  options: { - apiKey: process.env.UPLOADTHING_SECRET, + token: process.env.UPLOADTHING_TOKEN, acl: 'public-read', },
Nov 13, 2024
v3.0.0-beta.130 (2024-11-13)

🚀 Features
- adds ability to define base filter for list view (#9177) (9da8543)
- customize log levels and downgrade common errors to info (#9156) (d628222)
- next: initializes nav group prefs on the server and consolidates records (#9145) (f6bdc0a)
- templates: update config structure in website template to be more clear (#9161) (5ac4e73)
🐛 Bug Fixes
- add inline <head><style> to ensure the order of declared css layers as much as possible (#9123) (cd95daf)
- fallbackLocale not respecting default settings, locale specific fallbacks and not respecting 'none' or false (#8591) (f4d526d)
- expose server and client props to custom list slot components (#9159) (a8e3095)
- db-postgres: create relationship-v2-v3 migration (#9178) (5b9cee6)
- next: safely check for state when creating first user (#9168) (3b55458)
🤝 Contributors
- Sasha (@r1tsuu)
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
- James Mikrut (@jmikrut)
- Patrik (@PatrikKozak)
- Dan Ribbens (@DanRibbens)
- Elliot DeNolf (@denolfe)
- Jacob Fletcher (@jacobsfletch)
Nov 12, 2024
v3.0.0-beta.129 (2024-11-12)

🐛 Bug Fixes
- richtext-lexical: inline blocks drawer not rendering any fields due to incorrect schemapath suffix (#9158) (a1c99c8)
🤝 Contributors
- Patrik (@PatrikKozak)
- Alessio Gravili (@AlessioGr)
Nov 12, 2024
v3.0.0-beta.128 (2024-11-12)

This is a significant release which overhauls the way that we render, and provide, custom React components to the Payload Admin UI. Now, custom server components receive contextual props, like data and value, so you can do considerably more with them on the server.

It also ships with a variety of performance improvements to the server-side rendering done for the admin panel.

There are a few relatively simple breaking changes outlined below.

🚀 Features
- adds option to mongoose to ensure indexes (#9155) (6bb4067)
- on demand rsc (#8364) (c96fa61)
- db-postgres: deep querying on json and rich text fields (#9102) (b878daf)
- docs: add example for customising the filename of an upload via hooks (#9124) (d839138)
- richtext-lexical: add useAsTitle to the popup links label (#8718) (23907e4)
- richtext-lexical: backport relevant from lexical playground between 0.18.0 and 0.20.0 (#9129) (a30eeaf)
- richtext-lexical: upgrade lexical from 0.18.0 to 0.20.0 (#9126) (7767c94)
- templates: add with-vercel-website (#9144) (def595e)
⚡ Performance
- upgrade pino-pretty. This reduces bundle size and total amount of dependencies from 94 => 85 (#9127) (7261faa)
🐛 Bug Fixes
- allow specifying queue (#9151) (e0309a1)
- incorrectly looking for schema paths when upload is not enabled (#9146) (a3ebf51)
- empty publish dropdown when localization is false (#9106) (3e954f4)
- custom id field not shown depending on field and db types (#9091) (9a970d2)
- update README with new asset, image URL (#9099) (d7fc944)
- cpa: use proper branch tag (#9141) (7cd805a)
- db-mongodb: use dbName for mongodb model (#9107) (09c41d5)
- db-mongodb: destructuring error when trying to filter date fields by string query (#9116) (6899a3c)
- next: disable turbopack serverExternalPackages warnings (#9147) (64967e4)
- next, ui: respect access of user for document locking (#9139) (48d0fae)
- ui: pass correct relationTo to locked documents creation (#9137) (3298113)
- ui: error in filtered relationship field component while scrolling, if the select option label is a number (#9117) (2ad9917)
⚠️ BREAKING CHANGES
- on-demand rsc (#8364) (c96fa61)
  
  Add the following to your root layout file, typically located at (app)/(payload)/layout.tsx:
  
  /* THIS FILE WAS GENERATED AUTOMATICALLY BY PAYLOAD. */ /* DO NOT MODIFY IT BECAUSE IT COULD BE REWRITTEN AT ANY TIME. */ + import type { ServerFunctionClient } from 'payload' import config from '@payload-config' - import { RootLayout } from '@payloadcms/next/layouts' + import { handleServerFunctions, RootLayout } from '@payloadcms/next/layouts' import React from 'react' import { importMap } from './admin/importMap.js' import './custom.scss' type Args = { children: React.ReactNode } + const serverFunction: ServerFunctionClient = async function (args) { + 'use server' + return handleServerFunctions({ + ...args, + config, + importMap, + }) + } const Layout = ({ children }: Args) => ( <RootLayout config={config} importMap={importMap} + serverFunction={serverFunction} > {children} </RootLayout> ) export default Layout
  
  If you were previously posting to the /api/form-state endpoint, it no longer exists. Instead, you'll need to invoke the form-state Server Function, which can be done through the new getFormState utility:
  
  - import { getFormState } from '@payloadcms/ui' - const { state } = await getFormState({ - apiRoute: '', - body: { - // ... - }, - serverURL: '' - }) + const { getFormState } = useServerFunctions() + + const { state } = await getFormState({ + // ... + })
  
  Multiple layer of React Context were removed in favor of direct props. As a result, the following React hooks were removed:
  
  - useFieldProps() - useTableCell()
  
  If you were previously using any of these hooks, for example to access field path or cellData, you can now access that directly from the props object.
  
  - const { path } = useFieldProps(); + const { path } = props; - const { cellData } = useTableCell(); + const { cellData } = props;
  
  The field prop also no longer contains a _schemaPath property. Instead, this is now also accessed directly through props:
  
  - const { _schemaPath } = props.field + const { schemaPath } = props
- db-mongodb: use dbName for mongodb model (#9107) (09c41d5)
  
  If a dbName was previously provided, it will now be used as the MongoDB collection name instead of the collection slug. autoPluralization will not be applied to dbName.
- richtext-lexical: upgrade lexical from 0.18.0 to 0.20.0 (#9126) (7767c94)
  
  This upgrades our lexical dependencies from 0.18.0 to 0.20.0. If you have lexical dependencies installed in your project, you will have to upgrade those.
  
  Additionally, the lexical team may introduce breaking changes in this upgrade. If you use lexical APIs directly, please consult their changelog for more information: https://github.com/facebook/lexical/releases
🤝 Contributors
- Sasha (@r1tsuu)
- James Mikrut (@jmikrut)
- Jarrod Flesch (@JarrodMFlesch)
- Elliot DeNolf (@denolfe)
- Tobias Odendahl (@tak-amboss)
- Nate (@ncaminata)
- Patrik (@PatrikKozak)
- Alessio Gravili (@AlessioGr)
- Germán Jabloñski (@GermanJablo)
- Jacob Fletcher (@jacobsfletch)
- Paul (@paulpopus)
- Jessica Chowdhury (@JessChowdhury)
Nov 11, 2024
v3.0.0-beta.127 (2024-11-11)

🚀 Features
- db-postgres: add point field support (#9078) (0a15388)
- templates: add adminThumbnail to media in website template (#9059) (015580a)
⚡ Performance
- upgrade json-schema-to-typescript and various other dependencies (#9076) (0cd83f0)
🐛 Bug Fixes
- migrateRefresh migrates without previously ran migrations (#9073) (e3172f1)
- handle custom id logic in mongodb adapter (#9069) (ee117bb)
- incorrect form changed state after doc drawer edit (#9025) (dc11104)
- login redirect missing route (#8990) (010ac2a)
- populate with find operation (#9087) (721ae79)
- corrected translation emailOrPasswordIncorrect for Danish (da) (#9063) (57e535e)
- db-mongodb: totalDocs with joins (#9056) (f67761f)
- db-mongodb: write migrations index file (#9071) (d20445b)
- docs: auth page email broken link (#9089) (1584c41)
- templates: use direct blocks props instead of drilling them out of pages (#9074) (b32c4de)
- templates: fix website template's missing paragraph feature allowing you to change text from headings (#9072) (1d5d303)
- translations: improves Bulgarian translations (#9031) (a6e7305)
⚠️ BREAKING CHANGES
- handle custom id logic in mongodb adapter (#9069) (ee117bb)
  
  When using custom ID fields, if you have any collection hooks for beforeValidate, beforeChange then data._id will no longer be assigned as this happens now in the database adapter. Use data.id instead.
🤝 Contributors
- Sasha (@r1tsuu)
- Ruy Monteiro (@ruymon)
- Nathan Clevenger (@nathanclevenger)
- Dan Ribbens (@DanRibbens)
- Jessica Chowdhury (@JessChowdhury)
- Kendell Joseph (@kendelljoseph)
- Paul (@paulpopus)
- Steve (@steventsvetkov)
- Alessio Gravili (@AlessioGr)
- Elliot DeNolf (@denolfe)
- Mikkel Madsen (@miguel2650)
- Tylan Davis (@tylandavis)
- Patrik (@PatrikKozak)
Nov 6, 2024
v3.0.0-beta.126 (2024-11-06)

🚀 Features
- generate types for joins (#9054) (213b7c6)
- add populate property to Local / REST API (#8969) (a22c0e6)
🐛 Bug Fixes
- allow workflows to be empty or undefined (#9039) (f0f96e7)
- replace console.error with logger.errors (#9044) (0165ab8)
- publish locale with autosave enabled and close dropdown (#8719) (7dc5256)
- handle bulk upload sequentially to prevent conflicts (#9052) (f507305)
- db-postgres: handle special characters in createDatabase (#9022) (147d28e)
- richtext-slate, ui: use PointerEvents to show tooltips on enabled / disabled buttons (#9006) (d425290)
- ui: dedupes custom id fields (#9050) (4b4ecb3)
- ui: edit many modal draft action button order and style (#9047) (becf56d)
🤝 Contributors
- Dan Ribbens (@DanRibbens)
- Javier (@javierlinked)
- Sasha (@r1tsuu)
- Jessica Chowdhury (@JessChowdhury)
- Timothy Choi (@tyteen4a03)
- Jacob Fletcher (@jacobsfletch)
- Andreas Bernhard (@abernh)
Nov 6, 2024
v3.0.0-beta.125 (2024-11-06)

🚀 Features
- add join field config where property (#8973) (93a55d1)
- adds x-powered-by Payload header in next config (#9027) (ddc9d97)
- plugin-seo: add czech translation (#8998) (4652e8d)
- plugin-seo: add Swedish translations (#9007) (3e31b7a)
- templates: website template now has configured image sizes, updated readme and simplified env vars for setting up (#9036) (201d686)
🐛 Bug Fixes
- custom endpoints with method: 'put' (#9037) (9ce2ba6)
- type augmentation of RequestContext (#9035) (f52b7c4)
- cpa: remove lock file on project creation (cdcefa8)
- ui: json fields can now take a maxHeight in admin props and there's a mininum height of 3 lines (#9018) (3ca203e)
- ui: ensure upload field updates reflect in edit popup changes (#9034) (2175e5c)
- ui: updatedAt field in locked-docs collection able to be updated by non-owner (#9026) (ebd3c02)
🤝 Contributors
- Dan Ribbens (@DanRibbens)
- Elliot DeNolf (@denolfe)
- Sasha (@r1tsuu)
- Paul (@paulpopus)
- James Mikrut (@jmikrut)
- Friggo (@MrFriggo)
- Patrik (@PatrikKozak)
- Jesper We (@JesperWe)
Nov 4, 2024
v3.0.0-beta.124 (2024-11-04)

🚀 Features
- plugin-seo: add Turkish translation v3 (#8993) (cca6746)
🐛 Bug Fixes
- prefetch causing stale data (#9020) (35b107a)
- graphql missing options route resulting in failed cors preflight checks in production (#8987) (6b9f178)
- invalid select type with strictNullChecks: true (#8991) (4349b78)
- querying relationships by id path with REST (#9013) (5b97ac1)
🤝 Contributors
- James Mikrut (@jmikrut)
- Paul (@paulpopus)
- vahacreative (@vahacreative)
- Sasha (@r1tsuu)
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
- Said Akhrarov (@akhrarovsaid)
Oct 31, 2024
v3.0.0-beta.123 (2024-10-31)

🚀 Features
- plugin-seo: support overriding default fields via a function instead and fixes bugs regarding localized labels (#8958) (b417c1f)
🐛 Bug Fixes
- select with unnamed tabs (#8966) (3175541)
- locked documents with read access for users (#8950) (55ce8e6)
- return type of findByID with strict: true (#8953) (08251ec)
- next: overly large width on document locked modal content (#8967) (090831c)
- templates: website template error inside the populateAuthors hook (#8972) (9eb79c1)
- ui: increase z-index of ReactSelect (#8735) (c0397c3)
⚠️ BREAKING CHANGES
- plugin-seo: support overriding default fields via a function instead and fixes bugs regarding localized labels (#8958) (b417c1f)
  
  The SEO plugin now takes in a function to override or add in new
  
  fields
  
  fieldOverrides has been removed
  
  fields is now a function that takes in defaultFields and expects an array of fields in return
  
  This makes it a lot easier for end users to override and extend existing fields and add new ones. This change also brings this plugin inline with the pattern that we use in our other plugins.
  
  // before seoPlugin({ fieldOverrides: { title: { required: true, }, }, fields: [ { name: 'customField', type: 'text', } ] }) // after seoPlugin({ fields: ({ defaultFields }) => { const modifiedFields = defaultFields.map((field) => { // Override existing fields if ('name' in field && field.name === 'title') { return { ...field, required: true, } } return field }) return [ ...modifiedFields, // Add a new field { name: 'ogTitle', type: 'text', label: 'og:title', }, ] }, })
🤝 Contributors
- Paul (@paulpopus)
- Germán Jabloñski (@GermanJablo)
- Sasha (@r1tsuu)
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
Oct 31, 2024
v3.0.0-beta.122 (2024-10-31)

🚀 Features
- translations: added sl to exported date locales (#8817) (3918c09)
🐛 Bug Fixes
- bulk upload mimetype wildcard file selection (#8954) (03e5ae8)
- graphql: avoid adding extra password fields when running mutations (#8032) (#8845) (58441c2)
- ui: description undefined error on empty tabs array (#8830) (755355e)
- ui: overly large width on stay logged in modal content (#8952) (57fba36)
🤝 Contributors
- Said Akhrarov (@akhrarovsaid)
- Manuel Leitold (@agrippa1994)
- Gregor Gabrič (@GregorGabric)
- Konsequanzheng (@Konsequanzheng)
- Paul (@paulpopus)
- Sasha (@r1tsuu)
- James Mikrut (@jmikrut)
Oct 30, 2024
v3.0.0-beta.121 (2024-10-30)

🚀 Features
- adds jobs queue (#8228) (8970c6b)
- add defaultPopulate property to collection config (#8934) (c41ef65)
- custom views are now public by default and fixed some issues with notFound page (#8820) (01ccbd4)
- select fields (#8550) (dae832c)
- prevent create new for joins (#8929) (6cdf141)
🐛 Bug Fixes
- db-mongodb: ensure relationships are stored in ObjectID (#8932) (d64946c)
- db-mongodb: joins with singular collection name (#8933) (f4041ce)
- plugin-search: localization (#8938) (1231251)
- ui: perf improvements in bulk upload (#8944) (03331de)
- ui: broken buttons in the bulk upload drawer (#8926) (d38d7b8)
- ui: sanitize limit for preferences (#8913) (6c341b5)
- ui: missing localization label on text area fields (#8927) (c0aa96f)
⚠️ BREAKING CHANGES
- custom views are now public by default and fixed some issues with notFound page (#8820) (01ccbd4)
  
  This PR aims to fix a few issues with the notFound page and custom views so it matches v2 behaviour:
  
  Non authorised users should always be redirected to the login page regardless if not found or valid URL
  
  Previously notFound would render for non users too potentially exposing valid but protected routes and creating a confusing workflow as the UI was being rendered as well
  
  Custom views are now public by default
  
  in our admin test suite, the /admin/public-custom-view is accessible to non users but /admin/public-custom-view/protected-nested-view is not unless the checkbox is true in the Settings global, there's e2e coverage for this
  
  Fixes https://github.com/payloadcms/payload/issues/8716
- plugin-search with localization enabled (#8938) (1231251)
  
  The search plugin was incorrectly retrieving all locales, when it should just be retrieving the locale of the parent document that was actively being updated.
  
  If you have a localized Payload config, and you are using the plugin-search, we will now automatically localize the title field that is injected by the search plugin and this may lead to data loss. To opt out of this new behavior, you can pass localize: false to the plugin options.
🤝 Contributors
- James Mikrut (@jmikrut)
- Said Akhrarov (@akhrarovsaid)
- Paul (@paulpopus)
- Sasha (@r1tsuu)
- Kendell Joseph (@kendelljoseph)
- Dan Ribbens (@DanRibbens)
- Elliot DeNolf (@denolfe)
- Patrik (@PatrikKozak)
Oct 29, 2024
v3.0.0-beta.120 (2024-10-29)

🚀 Features
- join field defaultLimit and defaultSort (#8908) (f0edbb7)
🐛 Bug Fixes
- autosave potentially losing latest: true w/ race condition (#8894) (00ed66b)
- form-builder payment static value field (#8905) (44e52b0)
- cpa: write POSTGRES_URL to .env for vercel postgres (#8743) (aea1b41)
- db-mongodb: query 'in' with a comma-delimited value (#8910) (7a7a2f3)
- next, ui: exclude expired locks for globals (#8914) (e74906f)
- next, ui: only show locked docs that are not expired (#8899) (1e002ac)
- richtext-lexical: ensure editor cursor / selection state is preserved when working with drawers (#8872) (a8569b9)
🤝 Contributors
- Patrik (@PatrikKozak)
- Sasha (@r1tsuu)
- Dan Ribbens (@DanRibbens)
- Said Akhrarov (@akhrarovsaid)
- Brandon Kocur (@Brandoko)
- James Mikrut (@jmikrut)
- Alessio Gravili (@AlessioGr)
- Elliot DeNolf (@denolfe)
Oct 25, 2024
v3.0.0-beta.119 (2024-10-25)

🚀 Features
- rename @payloadcms/plugin-cloud (#8828) (1b1dc82)
- sort by multiple fields (#8799) (4d44c37)
- richtext-slate: add useElement hook to richtext-slate client exports (#8856) (2e11068)
⚡ Performance
- index globals versions timestamps by default (#8821) (6e919cc)
🐛 Bug Fixes
- cpa: properly detect if pnpm exists on windows (#8855) (1a15425)
- db-postgres: sort by localized fields (#8839) (9069bd3)
- plugin-search: issues with overriding the search collection slug consistently across hooks (#8847) (2df8f94)
- ui: upload buttons being hidden at mobile screen widths (#8860) (e72e81c)
- ui: leave without saving when changing /account theme (#8724) (085e127)
⚠️ BREAKING CHANGES
- rename @payloadcms/plugin-cloud (#8828) (1b1dc82)
  
  BREAKING CHANGE: Rename @payloadcms/plugin-cloud to @payloadcms/payload-cloud. Anyone using the existing plugin will need to switch to using the new package.
  
  Why?
  
  Since v3 will be using fixed versioning, all versions of ^3 must be available. Unfortunately, the @payloadcms/plugin-cloud version has already breached that version number. Renaming will allow it to be on the same version as other monorepo packages.
  
  Additionally, the name plugin-cloud is quite ambiguous and sometimes is confused with plugin-cloud-storage, so using payload-cloud feels like a good move to make this more evident.
🤝 Contributors
- Paul (@paulpopus)
- Elliot DeNolf (@denolfe)
- Anders Semb Hermansen (@andershermansen)
- Sasha (@r1tsuu)
- Hristiyan Dodov (@hdodov)
Oct 24, 2024
v3.0.0-beta.118 (2024-10-24)

🚀 Features
- add localized indicator to field label (#8602) (03c0702)
- templates: add a copy button to website template code blocks (#8794) (0fcbce3)
🐛 Bug Fixes
- reduce import map diff when config changes (#8846) (1caa383)
- join field works on collections with versions enabled (#8715) (8af00f2)
- db-postgres: alias already in use in this query (#8823) (4c396c7)
🤝 Contributors
- MotorcycleEnjoyer (@MotorcycleEnjoyer)
- Sasha (@r1tsuu)
- Jessica Chowdhury (@JessChowdhury)
Oct 22, 2024
v3.0.0-beta.117 (2024-10-22)

🚀 Features
- bump next.js to 15.0.0 (#8825) (74266bd)
⚡ Performance
- replace jsonwebtoken with jose (#8217) (ef8a5b1)
- upgrade pino and pino-pretty, reducing the total amount of dependencies (#8776) (062a333)
🐛 Bug Fixes
- drizzle init args (#8818) (9fb8665)
- db-mongodb: virtual fields within row / collapsible / tabs (#8733) (9056b9f)
- next, ui: ensures selectAll in the list view ignores locked documents (#8813) (2908c9a)
- plugin-seo: description and title fields now respect given minLength and maxLength rules for passing validation (#8765) (1f0d8da)
- richtext-*: ensure admin panel doesn't freeze with some field configurations consisting of 2+ richtext fields (#8773) (aedf3c8)
- richtext-lexical: richtext fields in drawers aren't editable, inline toolbar artifacts are shown for readOnly editors (#8774) (f3bec93)
- richtext-lexical: fix CLS on collapsed/expanded state of Lexical blocks (#8029) (a789556)
- ui: unique ids for nested rows on row duplicate to prevent errors with postgres (#8790) (fe25b54)
- ui: padding on relationship fields when no options or loading text is displayed (#8767) (82f2789)
⚠️ BREAKING CHANGES
- bump next.js to 15.0.0 (#8825) (74266bd)
  
  Bump Next.js to version 15.0.0. Additionally, you will need to upgrade react and react-dom to 19.0.0-rc-65a56d0e-20241020 (mirrors Next.js).
🤝 Contributors
- Elliot DeNolf (@denolfe)
- Patrik (@PatrikKozak)
- Sasha (@r1tsuu)
- Anders Semb Hermansen (@andershermansen)
- Because789 (@Because789)
- Alessio Gravili (@AlessioGr)
- Germán Jabloñski (@GermanJablo)
- Paul (@paulpopus)
- Said Akhrarov (@akhrarovsaid)
Oct 17, 2024
v3.0.0-beta.116 (2024-10-17)

🐛 Bug Fixes
- pg where filters not respected in policy generation (#8753) (99b4359)
- disables document locking of payload-locked-documents, preferences, & migrations collections (#8744) (c63b7bc)
- db-postgres: esm compatible import of pg (#8758) (f37e476)
- drizzle: bump drizzle-orm in drizzle package to 0.35.1 (#8759) (73102e9)
- drizzle: enforce uniqueness on index names (#8754) (90bca15)
- drizzle: select hasMany nested to array + tab/group (#8737) (872b205)
🤝 Contributors
- Sasha (@r1tsuu)
- Jarrod Flesch (@JarrodMFlesch)
- Dan Ribbens (@DanRibbens)
- Patrik (@PatrikKozak)
Oct 16, 2024
v3.0.0-beta.115 (2024-10-16)

🐛 Bug Fixes
- corrects schemaPath passing (#8726) (a19e8d3)
- db-postgres, db-sqlite: bump drizzle-kit drizzle-orm @libsql/client (#8617) (93545f3)
- templates: website template issue with previewing drafts (#8714) (303a224)
- ui: restrict file picking via upload config mimetypes (#8710) (c4fa885)
- ui: add missing styles under the payload-default css layer (#8723) (e6a1ca5)
- ui: removes overflow: hidden style from actions wrapper (#8717) (8d10737)
⚠️ BREAKING CHANGES
- db-postgres, db-sqlite: bump drizzle-kit drizzle-orm @libsql/client (#8617) (93545f3)
  
  Inheriting all the fixes from drizzle moving to latest versions
  
  BREAKING CHANGES
  
  If you have a prior version of @libsql/client installed in your project, you must upgrade to 0.14.0
🤝 Contributors
- Dan Ribbens (@DanRibbens)
- Said Akhrarov (@akhrarovsaid)
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
Oct 15, 2024
v3.0.0-beta.114 (2024-10-15)

🚀 Features
- add disableTransaction to local api (#8697) (d781624)
- add limit property to bulk update operation (#8656) (7a0b419)
- db-postgres, db-vercel-postgres: createDatabase, auto database create if it does not exist (#8655) (256949e)
🐛 Bug Fixes
- ensure beforeValidate hook runs for reset password (#8433) (a9e7d48)
- local update limit (#8704) (3110c1b)
- validate should not always equate valid to true (#8696) (8bbc833)
- ensure dropzone respects canCreate permissions (#8689) (3f128c5)
- ensure Component is not required in MappedComponent types (#8687) (793dfe8)
- properly store timestamps in versions (#8646) (8daac4e)
- db-mongodb: add validation to relationship ids (#8395) (21606de)
- drizzle: indexes / unique with relationships (#8432) (1ffb6c3)
- drizzle, ui: properly filters out number field values with the exists operator filter (#8706) (3f2b828)
- next: returns proper document id type from init page result (#8700) (35a5199)
- ui: react-datepicker in number fields and datepicker visual issues (#8694) (e3957d7)
- ui: prevents react-select styles being injected into hasMany number fields (#8695) (08f8831)
- ui: show configured description on active tabs (#8675) (65d4f37)
- ui: export useListRelationships (#8658) (e4fd1e3)
- ui: hasMany selecting single docs clicking through instead of selecting a document (#8624) (a4f1af4)
🤝 Contributors
- Jacob Fletcher (@jacobsfletch)
- Patrik (@PatrikKozak)
- Jessica Chowdhury (@JessChowdhury)
- Dan Ribbens (@DanRibbens)
- Alessio Gravili (@AlessioGr)
- Paul (@paulpopus)
- Jarrod Flesch (@JarrodMFlesch)
- Said Akhrarov (@akhrarovsaid)
- Because789 (@Because789)
- Sasha (@r1tsuu)
Oct 10, 2024
v3.0.0-beta.113 (2024-10-10)

🚀 Features
- plugin-sentry: update plugin to 3.0 (#8613) (0b2a7a3)
- translations: add slovenian lang (#8603) (28c3a77)
🐛 Bug Fixes
- commonjs exports missing for withPayload (#8643) (d0a5560)
- sanitize virtual fields in admin.useAsTitle (#8620) (fdebc84)
- corrects useAuth generics (#8627) (5e94d9b)
- drizzle: hasMany joins - localized, limit and schema paths (#8633) (f6acfdb)
- ui: react select fields not increasing height when items overflow (#8618) (f507530)
🤝 Contributors
- Elliot DeNolf (@denolfe)
- Paul (@paulpopus)
- Jarrod Flesch (@JarrodMFlesch)
- Sasha (@r1tsuu)
- Germán Jabloñski (@GermanJablo)
- Gregor Gabrič (@GregorGabric)
- Patrik (@PatrikKozak)
Oct 9, 2024
v3.0.0-beta.112 (2024-10-09)

🚀 Features
- join field works with hasMany relationships (#8493) (1bf580f)
- plugin-seo: adds german translation (#8580) (bb3496d)
- ui: scope all payload css to payload-default layer (#8545) (7c62e2a)
🐛 Bug Fixes
- verify view is inaccessible (#8557) (1b63ad4)
- duplicate with upload collections (#8552) (400293b)
- db-vercel-postgres: add pg dep (#8598) (ca77944)
- payload: calculates correct aspect ratio dimensions on sharp based files (#8537) (c14c429)
- payload: applies resize after cropping if resizeOptions are defined (#8528) (9a0568c)
- richtext-lexical: linkFeature doesn't respect admin.routes from payload.config.ts (#8513) (6cb128a)
- templates: await params/cookies properly (#8560) (463490f)
- ui: add unstyled prop to react-select so that payload styles take priority (#8572) (2a1321c)
⚠️ BREAKING CHANGES
- improve auth provider setting user and user cookie (#8600) (829996a)
  
  If you are using the setUser function exposed from the useAuth() provider, then you will need to make some adjustments.
  
  setUser now expects the response data from auth enabled endpoints, ie the /me route. This is so the cookie and expiration can be properly set in sync when a new user is set on the provider.
  
  // before setUser({ id: 670524817048be0fa222fc01, email: dev@payloadcms.com, // ... other user properties }) // new setUser({ user: { id: 670524817048be0fa222fc01, email: dev@payloadcms.com, // ... other user properties }, exp: 1728398351, token: "....eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVC...." })
- ui: scope all payload css to payload-default layer (#8545) (7c62e2a)
  
  All payload css is now encapsulated inside CSS layers under @layer payload-default
  
  Any custom css will now have the highest possible specificity. We have also provided a new layer @layer payload if you want to use layers and ensure that your styles are applied after payload.
  
  To override existing styles in a way that the existing rules of specificity would be respected you can use the default layer like so
  
  @layer payload-default { // my styles within the payload specificity }
🤝 Contributors
- Patrik (@PatrikKozak)
- Jarrod Flesch (@JarrodMFlesch)
- Jessica Chowdhury (@JessChowdhury)
- Dan Ribbens (@DanRibbens)
- Elliot DeNolf (@denolfe)
- Paul (@paulpopus)
- Germán Jabloñski (@GermanJablo)
- Because789 (@Because789)
- Sasha (@r1tsuu)
- Jacob Fletcher (@jacobsfletch)
Oct 4, 2024
v3.0.0-beta.111 (2024-10-04)

🚀 Features
- update next@15.0.0-canary.173, react@19.0.0-rc-3edc000d-20240926 (#8489) (fa59d4c)
🐛 Bug Fixes
- db-postgres: missing types for db.pool by moving @types/pg from devDependencies to dependencies (#8556) (0d3416c)
- drizzle: make radio and select column names to snake_case (#8439) (0128eed)
- drizzle: row / collapsible inside of localized fields (#8539) (414030e)
- ui: disableBulkEdit on ui fields, defaults to true (#8540) (cf8347f)
- plugin-seo: now respects serverURL and api routes configuration (#8546) (157b1e1)
- templates: dark and light mode not correctly working on website template's header (#8542) (dffdb22)
- templates: add no search results text to website template search page (#8531) (eb4e371)
- templates: static generation from incorrect params provided (#8530) (132131a)
- ui crashes editing doc with deleted upload (#8526) (9ef4fab)
- templates: add force-static to pages and posts (#8527) (65015aa)
- next: safely checks user within useEffect (#8524) (0f7d444)
- properly resolves cjs withPayload export (#8521) (ca90d2b)
- templates: remove lock from website template (#8520) (ecfd90b)
- templates: fixed drafts not being unpublished in the frontend of the website template (#8514) (8637144)
- next: current published version label (#8505) (a8eceb0)
- ui: admin.allowCreate in upload field (#8484) (d80410b)
- db-postgres, db-sqlite: joins relation name (#8491) (27b1629)
⚠️ BREAKING CHANGES
- drizzle: make radio and select column names to snake_case (#8439) (0128eed)
  
  Fixes https://github.com/payloadcms/payload/issues/8402 and https://github.com/payloadcms/payload/issues/8027
  
  Before DB column names were camelCase:
  
  After this change, they are snake_case:
  
  Breaking SQLite / Postgres ⚠️
  
  If you had any select (not hasMany: true) or radio fields with the name in camelCase, for example:
  
  { name: 'selectReadOnly', type: 'select', admin: { readOnly: true, }, options: [ { label: 'Value One', value: 'one', }, { label: 'Value Two', value: 'two', }, ], },
  
  This previously was mapped to the db column name "selectReadOnly". Now it's select_read_only. Generate a new migration to rename your columns.
  
  pnpm payload migrate:create
  
  Then select "rename column" for targeted columns and Drizzle will handle the migration.
- update next@15.0.0-canary.173, react@19.0.0-rc-3edc000d-20240926 (#8489) (fa59d4c)
  
  Updates the minimal supported versions of next.js to 15.0.0-canary.173 and react to 19.0.0-rc-3edc000d-20240926.
  
  Adds neccessary awaits according to this breaking change https://github.com/vercel/next.js/pull/68812
  
  The params and searchParams types in app/(payload)/admin/[[...segments]]/page.tsx and app/(payload)/admin/[[...segments]]/not-found.tsx must be changed to promises:
  
  - type Args = { - params: { - segments: string[] - } - searchParams: { - [key: string]: string | string[] - } - } + type Args = { + params: Promise<{ + segments: string[] + }> + searchParams: Promise<{ + [key: string]: string | string[] + }> + }
🤝 Contributors
- Sasha (@r1tsuu)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Paul (@paulpopus)
- Dan Ribbens (@DanRibbens)
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
- Germán Jabloñski (@GermanJablo)
Sep 30, 2024
v3.0.0-beta.110 (2024-09-30)

🚀 Features
- join field on upload fields (#8379) (3f375cc)
- richtext-lexical: export $createInlineBlockNode, $isInlineBlockNode and InlineBlockNode (#8480) (163f3c0)
- translations: add danish translations (#7809) (22f120d)
- richtext-lexical: upgrade lexical from 0.17.0 to 0.18.0, make tables more reliable (#8444) (8b44676)
- templates: add search functionality to the website template (#8454) (fb60344)
- payload, ui: add admin.allowEdit relationship field (#8398) (17e0547)
🐛 Bug Fixes
- db-*: make db.begintransactions required (#8419) (3847428)
- db-mongodb: duplicate versions with parent string ids (#8487) (7b6a760)
- draft status access control checks (#8486) (0c10045)
- reset password link extra slash and thread admin.routes.reset property (#8448) (e765a5e)
- sorting by id incorrectly orders by version.id (#8442) (4241811)
- db-mongodb: properly filters out number field values with the exists operator filter (#8416) (8110cb9)
- ui: RTL not applying for localised textarea fields (#8474) (e5ca476)
- drizzle: hasMany / poly relationships nested to localized fields / nested blocks to localized fields (#8456) (613d3b0)
- richtext-lexical: match the indentation spacing of paragraphs and lists (#8437) (f50174f)
⚠️ BREAKING CHANGES
- richtext-lexical: upgrade lexical from 0.17.0 to 0.18.0, make tables more reliable (#8444) (8b44676)
  
  This upgrades lexical from 0.17.0 to 0.18.0. If you have any lexical packages installed in your project, please update them accordingly. Additionally, if you depend on the lexical APIs, please consult their changelog, as lexical may introduce breaking changes: https://github.com/facebook/lexical/releases/tag/v0.18.0
🤝 Contributors
- Dan Ribbens (@DanRibbens)
- Sasha (@r1tsuu)
- James Mikrut (@jmikrut)
- Ante (@azivkovi)
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Paul (@paulpopus)
- Mike Bailey (@mykz)
- Germán Jabloñski (@GermanJablo)
Sep 26, 2024
v3.0.0-beta.109 (2024-09-26)

🚀 Features
- preselected theme (#8354) (84d2026)
- drizzle: customize schema with before / after init hooks (#8196) (8acbda0)
- add upsert to database interface and adapters (#8397) (82ba193)
- improve afterError hook to accept array of functions, change to object args (#8389) (28ea0c5)
- templates update (#8391) (e72f12a)
🐛 Bug Fixes
- db-mongodb: docs duplicated in list view with drafts (#8435) (adc9bb5)
- richtext-lexical: add max-width to tables (temporary fix for overflow). (#8431) (a09811f)
- ui: autosave and preventLeaveWithoutSaving interfering with fetching form-state reliably (#8434) (c73f6c7)
- ui: number field not being able to clear out the field's value (#8425) (5c2e39e)
- ui: align to the top fields inside row field (#8421) (4b0351f)
- ui: versions in documentInfo and status component reverse latest true changes (#8417) (95231da)
- db-mongodb: add req to migration templates for transactions (#8407) (b10f61c)
- make field property of FieldLabel optional and partial (#8409) (87360f2)
- plugin-seo: titles being displayed twice (#8310) (8fadc33)
- drizzle: migrate args no longer partial payload request (#8375) (c6519ab)
- client function error on forgot password view (#8374) (06ea67a)
- drizzle: use alias for localized field sorting (#8396) (775e6e4)
- lock documents using the live-preview view (#8343) (57f93c9)
- ui: published, draft and changed labels should now be correctly displayed (#8382) (a37abd1)
- db-vercel-postgres: include needed pg dependency (#8393) (6da4f06)
- templates: proper migration file import source for vercel-postgres (#8394) (50da212)
- safely access user in auth operations (#8381) (a80f5b6)
- db-mongodb: db.find default limit to 0 (#8376) (dc69e2c)
- richtext-lexical: regression in lexical blocks (#8378) (19e2f10)
- richtext-lexical: table dropdown menu dark mode color (#8368) (bd41b4d)
- optional sortOptions type for SingleRelationshipFieldClient (#8340) (fbc395b)
- next: set the user data after first user registration (#8360) (30eb1d5)
- drizzle: sanitize query value uuid / number id NaN (#8369) (dedcff0)
- drizzle: array/relationship/select hasMany in localized field (#8355) (338c93a)
- cannot use join on relationships in unnamed fields (#8359) (c696728)
- ui: inconsistent arrow dropdown on buttons, popover missing caret (#8341) (3583c45)
⚠️ BREAKING CHANGES
- improve afterError hook to accept array of functions, change to object args (#8389) (28ea0c5)
  
  Changes the afterError hook structure, adds tests / more docs. Ensures that the req.responseHeaders property is respected in the error handler.
  
  afterError now accepts an array of functions instead of a single function:
  
  - afterError: () => {...} + afterError: [() => {...}]
  
  The args are changed to accept an object with the following properties:
  
  | Argument | Description | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | error | The error that occurred. | | context | Custom context passed between Hooks. More details. | | graphqlResult | The GraphQL result object, available if the hook is executed within a GraphQL context. | | req | The Request object containing the currently authenticated user | | collection | The Collection in which this Hook is running against. This will be undefined if the hook is executed from a non-collection endpoint or GraphQL. | | result | The formatted error result object, available if the hook is executed from a REST context. |
🤝 Contributors
- Dan Ribbens (@DanRibbens)
- Germán Jabloñski (@GermanJablo)
- Paul (@paulpopus)
- Riley Pearce (@rilrom)
- Jessica Chowdhury (@JessChowdhury)
- Sasha (@r1tsuu)
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
- Alessio Gravili (@AlessioGr)
- Tylan Davis (@tylandavis)
Sep 20, 2024
v3.0.0-beta.108 (2024-09-20)

🚀 Features
- richtext-lexical: dropdown menu disabled status (#8177) (7d2022f)
- upgrade next, react and react-dom, move react/next dependency checker from payload to next package (#8323) (1afcaa3)
- join field (#7518) (6ef2bde)
- adds overrideLock flag to update & delete operations (#8294) (9c3f863)
- ui: hides lock icon when locked by current user (#8309) (879f690)
- ui: threads collectionSlugs through useListDrawer (#8292) (405a6c3)
- storage-vercel-blob: threads cacheControlMaxAge through static handler (#8065) (a94e40f)
- ui: useTableColumns add abillity to reset columns state (#8296) (72995fc)
- plugin-form-builder: new wildcards {{}} and {{:table}} are now supported in email bodies and emails fall back to a global configuration value in addition to base email configuration (#8271) (9821aeb)
- lock documents while being edited (#7970) (f98d032)
- plugin-seo: add vietnamese translation (#8179) (89601f1)
- add virtual property to the fields config (#7621) (bf48af4)
- add publish specific locale (#7669) (b7a0b15)
⚡ Performance
- disable router cache refresh that occurs after every page transition or page load (#8318) (0cdd5b6)
- optimizes admin ui loading by using react cache to memoize req / auth (#8315) (c6a7ad2)
🐛 Bug Fixes
- ui: hide dot menu in read-only mode for locked documents (#8342) (493b121)
- db-mongodb: treat empty strings as null / undefined for exists queries (#8337) (e916512)
- ui: client side error when passing labels as functions for custom view tabs (#8339) (1f7d47a)
- add logger to serverOnlyConfigProperties (#8325) (afb8805)
- plugin-form-builder: emails array field has read access by authenticated users only by default now (#8338) (0789f4d)
- drizzle: equals polymorphic querying with object notation (#8316) (265d7fa)
- drizzle: nested arrays with localized items and versions (#8331) (2596b85)
- ui: adjust list view table alignment (#8330) (b51d2bc)
- only add snapshot to versions query when localization is enabled (#8293) (2d29b7e)
- findByID adjust type to null if disableErrors: true is passed (#8282) (37e1adf)
- richtext-slate: fix issue with richText field cell not being a link when used as a useAsTitle (#8272) (dd96f9a)
- templates: optional chaining bug (#8268) (4d54cc6)
- ui: code field adjusts its height to its content dynamically. Scrolling over the container is not prevented. (#8209) (f011e4f)
- strongly types field validation args (#8263) (c0aad3c)
- ui: mobile menu button sizing (#8264) (110fda7)
- drizzle: in query on polymorphic relations across ID types (#8240) (31ffc57)
- ui: filter collection crashes when navigating away (#8260) (9035467)
- properly infers field validation args (#8243) (029eba5)
- richtext-lexical: dropdown item disabled status (#8159) (67cd3b3)
- ui: pass label as prop through to the textarea input (#8248) (a06458d)
- ui: field alignment when labels overflow inside rows (#8246) (149b7cb)
- ui: draft docs are now correctly provided in preview URL (#8245) (ccd0b1e)
- error on forgot-password route (#8244) (d2eafdf)
- ui: nav button height being stretched and navWrapper border on RTL (#8242) (a68f0ce)
- drizzle: optimize count querying when no joins (#7749) (8520fd9)
- plugin-seo: threads entity slug and document config through generation fn args (#8238) (aee76cb)
- drizzle: localized fields uniqueness per locale (#8230) (b7db53c)
⚠️ BREAKING CHANGES
- richtext-lexical: dropdown menu disabled status (#8177) (7d2022f)
  
  ToolbarDropdown no longer receives groupKey={group.key} and items={group.items} as props, but instead group={group}
- plugin-form-builder: emails array field has read access by authenticated users only by default now (#8338) (0789f4d)
- upgrade next, react and react-dom, move react/next dependency checker from payload to next package (#8323) (1afcaa3)
  
  Upgrades minimum supported @types/react version from npm:types-react@19.0.0-rc.0 to npm:types-react@19.0.0-rc.1
  
  Upgrades minimum supported @types/react-dom version from npm:types-react-dom@19.0.0-rc.0 to npm:types-react-dom@19.0.0-rc.1
  
  Upgrades minimum supported react and react-dom version from 19.0.0-rc-06d0b89e-20240801 to 19.0.0-rc-5dcb0097-20240918
  
  Upgrades minimum supported Next.js version from 15.0.0-canary.104 to 15.0.0-canary.160
- join field (#7518) (6ef2bde)
  
  Adds a new "join" field type to Payload and is supported by all database adapters
  
  The UI uses a table view for the new field
  
  db-mongodb changes relationships to be stored as ObjectIDs instead of strings (for now querying works using both types internally to the DB so no data migration should be necessary unless you're querying directly, see breaking changes for details
  
  Adds a reusable traverseFields utility to Payload to make it easier to work with nested fields, used internally and for plugin maintainers
  
  export const Categories: CollectionConfig = { slug: 'categories', fields: [ { name: 'relatedPosts', type: 'join', collection: 'posts', on: 'category', } ] }
  
  All mongodb relationship and upload values will be stored as MongoDB ObjectIDs instead of strings going forward. If you have existing data and you are querying data directly, outside of Payload's APIs, you get different results. For example, a contains query will no longer works given a partial ID of a relationship since the ObjectID requires the whole identifier to work.
- drizzle: localized fields uniqueness per locale (#8230) (b7db53c)
  
  Previously, this worked with MongoDB but failed with Postgres / SQLite when the slug field has both localized: true and unique: true.
  
  await payload.create({ collection: "posts", locale: "en", data: { slug: "my-post" } }) await payload.create({ collection: "posts", locale: "de", data: { slug: "my-post" } })
  
  Now, we build unique constraints and indexes in combination with the _locale column. This should also improve query performance for fields with both index: true and localized: true.
  
  Migration steps (Postgres/SQLite only)
  
  This change updates the database schema and requires a migration (if you have any localized fields). To apply it, run the following commands:
  
  pnpm payload migrate:create locale_unique_indexes pnpm payload migrate
  
  Note that if you use db.push: true which is a default, you don't have to run pnpm payload migrate in the development mode, only in the production, as Payload automatically pushes the schema to your DB with it.
🤝 Contributors
- Germán Jabloñski (@GermanJablo)
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
- Paul (@paulpopus)
- Louis Ba (@muyunz)
- Alessio Gravili (@AlessioGr)
- Sasha (@r1tsuu)
- Dan Ribbens (@DanRibbens)
- Tylan Davis (@tylandavis)
- James Mikrut (@jmikrut)
- gervickas.js (@wellitongervickas)
- Jessica Chowdhury (@JessChowdhury)
- Frank Omondi (@Dofften)
- Jacob Fletcher (@jacobsfletch)
- Because789 (@Because789)
- Thành Trang (@trangcongthanh)
Sep 16, 2024
v3.0.0-beta.107 (2024-09-16)

🚀 Features
- add new option for admin.components.header (#7647) (3b59416)
- cpa: add node engines (#8234) (7c8272b)
⚡ Performance
- remove find-up dependency, upgrade file-type dependency (#8195) (6d1a287)
🐛 Bug Fixes
- duplication with localized arrays in unnamed tabs (#8236) (c460868)
- drizzle: polymorphic querying of different ID types (#8191) (a0a1e20)
🤝 Contributors
- James Mikrut (@jmikrut)
- Sasha (@r1tsuu)
- Jessica Chowdhury (@JessChowdhury)
- Elliot DeNolf (@denolfe)
- Jacob Fletcher (@jacobsfletch)
- Alessio Gravili (@AlessioGr)
Sep 15, 2024
v3.0.0-beta.106 (2024-09-15)

🐛 Bug Fixes
- duplicating localized nested arrays (#8220) (5873a3d)
🤝 Contributors
- James Mikrut (@jmikrut)
Sep 15, 2024
v3.0.0-beta.105 (2024-09-15)

⚡ Performance
- upgrade ajv, and upgrade typescript to 5.6.2 in monorepo (#8204) (fbc28b0)
- upgrade jsonwebtoken from 9.0.1 to 9.0.2 (#8202) (ec624bd)
🐛 Bug Fixes
- plugin-seo: removes duplicative json translations (#8206) (64f2395)
- error when viewing versions if plural label is set as a function (#8213) (ff1c1e0)
- richtext-lexical: default Cell not being a link when used as the primary column in lists (#8212) (d0bb1c9)
- ui: field type being overridden when providing a Cell component (#8211) (1608150)
- db-postgres: preserve parent createdAt when creating a new version (#8160) (43a9109)
- richtext-lexical: unnecessary isEnabled computations on toolbar items (#8176) (334f940)
- graphql: id field non null (#8169) (db29e1e)
- ui: bulk selection and useSelection hook losing types of the IDs its returning (#8194) (d28d40c)
- ui: properly extracts label from field in FieldLabel component (#8190) (a6f13f7)
- requires client field prop in server field components (#8188) (c28618b)
⚠️ BREAKING CHANGES
- ui: bulk selection and useSelection hook losing types of the IDs its returning (#8194) (d28d40c)
This PR changes the type of selected returned from the useSelection hook from the SelectionProvider from an object to a Map.

This fixes a bug where in some situations we lose the type of the ID which can break data entry when using postgres, due to keys being cast to strings inside of objects which doesn't happen when using a Map.

This PR also fixes a CSS bug with the checkbox when it should be partially selected.
```
// before
selected: Record<number | string, boolean>

// after
selected: Map<number | string, boolean>
```
This means you now need to read the data differently than before.
```
// before
Object.entries(selected).forEach(([key, value]) => {
  // do something
})

// after
for (const [key, value] of selected) {
  // do something
}
```
🤝 Contributors
- Jacob Fletcher (@jacobsfletch)
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
- Sasha (@r1tsuu)
- Germán Jabloñski (@GermanJablo)
- Jarrod Flesch (@JarrodMFlesch)
- Elliot DeNolf (@denolfe)
- Victor Winberg (@VictorWinberg)
- Florian Quiblier (@fofoy)
- Christoffer Hasselberg (@stofolus)
Sep 12, 2024
v3.0.0-beta.104 (2024-09-12)

🚀 Features
- passes client field config to server components (#8166) (8b30701)
- document drawer controls (#7679) (51bc8b4)
- drizzle: add support for in and not_in operators on json field (#8148) (ec37307)
🐛 Bug Fixes
- ui: properly retrieves singular labels for array field rows (#8171) (6e94884)
- templates: website media staticDir to public folder (#8175) (9561aa3)
- properly names BlocksField and related types (#8174) (465e47a)
- cpa: match vercel postgres db type with package name (#8141) (043bf95)
- ui: fix row width bug (#7940) (cd734b0)
- ui: set max-width for row (efe17ff)
⚠️ BREAKING CHANGES
- properly names BlocksField and related types (#8174) (465e47a)
  
  The BlockField type is not representative of the underlying "blocks" field type, which is plural, i.e. BlocksField. This is a semantic change that will better align the type with the field.
  
  Breaking Changes
  
  Types related to the blocks field have change names. If you were using the BlockField or related types in your own applications, simply change the import name to be plural and instead of singular.
  
  Old (singular):
  
  import type { BlockField, BlockFieldClient, BlockFieldValidation, BlockFieldDescriptionClientComponent, BlockFieldDescriptionServerComponent, BlockFieldErrorClientComponent, BlocksFieldErrorServerComponent, BlockFieldLabelClientComponent, BlockFieldLabelServerComponent, } from 'payload'
  
  New (plural):
  
  import type { BlocksField, BlocksFieldClient, BlocksFieldValidation, BlocksFieldDescriptionClientComponent, BlocksFieldDescriptionServerComponent, BlocksFieldErrorClientComponent, BlocksFieldErrorServerComponent, BlocksFieldLabelClientComponent, BlocksFieldLabelServerComponent, } from 'payload'
🤝 Contributors
- Dan Ribbens (@DanRibbens)
- Patrik (@PatrikKozak)
- Jacob Fletcher (@jacobsfletch)
- Paul (@paulpopus)
- Hampus Wallentin Olsen (@hampusolsen)
- Germán Jabloñski (@GermanJablo)
- Bruno Crosier (@brunocrosier)
Sep 11, 2024
v3.0.0-beta.103 (2024-09-11)

🚀 Features
- examples: adds custom components example (#8162) (8fe6ffd)
🐛 Bug Fixes
- useAsTitle validation now accounts for default and base fields (#8165) (663e511)
- next: set the user data before redirect after login (#8135) (0118bce)
- upload.defParamCharset: utf8 by default (#8157) (a234092)
- richtext-lexical: hover style of the button to remove blocks (#8154) (281c80d)
- extends server props onto field component types (#8155) (12a30a0)
- db-postgres: querying on array wtihin a relationship field (#8152) (0c563eb)
🤝 Contributors
- Paul (@paulpopus)
- Jacob Fletcher (@jacobsfletch)
- Sasha (@r1tsuu)
- Jarrod Flesch (@JarrodMFlesch)
- Germán Jabloñski (@GermanJablo)
Sep 9, 2024
v3.0.0-beta.102 (2024-09-09)

🚀 Features
- explicitly types field components (#8136) (8e1a5c8)
🐛 Bug Fixes
- beforeDuplicate localized blocks and arrays (#8144) (d267cad)
- richtext-lexical: indent regression (#8138) (fa38dfc)
⚠️ BREAKING CHANGES
- explicitly types field components (#8136) (8e1a5c8)
  
  We are no longer exporting TextFieldProps etc. for each field type. Instead, we now export props for each client/server environment explicitly. If you were previously importing one of these types into your custom component, simply change the import name to reflect your environment.
  
  Old:
  
  import type { TextFieldProps } from 'payload'
  
  New:
  
  import type { TextFieldClientProps, TextFieldServerProps } from 'payload'
🤝 Contributors
- Dan Ribbens (@DanRibbens)
- Germán Jabloñski (@GermanJablo)
- Jacob Fletcher (@jacobsfletch)
Sep 9, 2024
v3.0.0-beta.101 (2024-09-09)

🚀 Features
- add validation for useAsTitle to throw an error if it's an invalid or nested field (#8122) (638382e)
🐛 Bug Fixes
- #6800, graphql parallel queries with different fallback locales (#8140) (d44fb2d)
- multiple preferences for the same user and entry (#8100) (852f9fc)
- removes transactions wrapping auth strategies and login (#8137) (e2d8038)
- ui: wrong block indication when an error occurred (#7963) (7fa68d1)
- ui: bulk select checkbox being selected by default when in drawer (#8126) (9ec431a)
- ui: thumbnails when serverURL config is provided (#8124) (cadf815)
- ui: various issues around documents lists, listQuery provider and search params (#8081) (b27e42c)
- ui: missing thumbnail for non-image files in bulk upload sidebar (#8102) (32cc1a5)
- ui: better responsiveness for upload fields in sidebar (#8101) (38be69b)
🤝 Contributors
- James Mikrut (@jmikrut)
- Dan Ribbens (@DanRibbens)
- Germán Jabloñski (@GermanJablo)
- Paul (@paulpopus)
- Elliot DeNolf (@denolfe)
- Tylan Davis (@tylandavis)
Sep 6, 2024
v3.0.0-beta.100 (2024-09-06)

🚀 Features
- cpa: add support for bun package manager in v3 installer (#7709) (b69826a)
🐛 Bug Fixes
- ui, next: adjust modal alignment and padding (#7931) (ead12c8)
- ui: optimizes the relationship field by sharing a single document drawer across all values (#8094) (6253ec5)
- ui: handles falsey relationship options on reset (#8095) (f9ae56e)
- db-postgres: sanitize tab/group path for table name (#8009) (0688c2b)
- cpa: detect package manager from command execution environment (#8087) (c624661)
🤝 Contributors
- Tylan Davis (@tylandavis)
- Jacob Fletcher (@jacobsfletch)
- Sasha (@r1tsuu)
- Alexander (@Arctomachine)
- Paul (@paulpopus)
- Francisco Lourenço (@franciscolourenco)
Sep 5, 2024
v3.0.0-beta.99 (2024-09-05)

🐛 Bug Fixes
- ui: significantly optimizes relationship field (#8063) (308fad8)
- only show restore as draft option when drafts enabled (#8066) (6427b7e)
- db-postgres: query hasMany text/number in array/blocks (#8003) (3a65784)
🤝 Contributors
- Jacob Fletcher (@jacobsfletch)
- Jessica Chowdhury (@JessChowdhury)
- Sasha (@r1tsuu)
- Elliot DeNolf (@denolfe)
Sep 3, 2024
v3.0.0-beta.98 (2024-09-03)

🚀 Features
- plugin-seo: add Italian translations (#8020) (1130a58)
⚡ Performance
- richtext-lexical: greatly simplify lexical loading and improve performance (#8041) (b6a8d1c)
🐛 Bug Fixes
- richtext-lexical: toolbar styles (#7936) (7a3507d)
- plugin-seo: meta image selection not working (#8024) (9bcdf0d)
- padding on the right of the default padding when scrollbars are enabled in the browser (#8023) (8203fe8)
- richtext-lexical: incorrect error check in TableActionMenu (#7964) (d9cccc7)
- collection pagination limits being merged with defaults instead of overidden (#8004) (ee3d585)
- ui: radio fields are now selectable as options in filtering in query builder (#8002) (cf9e13a)
- ui: list view crash when using a code field type (#7994) (e25730f)
⚠️ BREAKING CHANGES
- richtext-lexical: greatly simplify lexical loading and improve performance (#8041) (b6a8d1c)
  
  We noticed that we can bring functions down to the client directly without having to wrap them in a component first. This greatly simplifies the loading of all lexical client components
  
  BREAKING:
  
  createClientComponent is no longer exported as it's not needed anymore
  
  The exported ClientComponentProps type has been renamed to BaseClientFeatureProps.
  
  The order of arguments in sanitizeClientEditorConfig has changed
🤝 Contributors
- Alessio Gravili (@AlessioGr)
- Elliot DeNolf (@denolfe)
- Germán Jabloñski (@GermanJablo)
- Paul (@paulpopus)
- Giuseppe Chiruzzi (@xfloor)
- Riley Pearce (@rilrom)
Aug 30, 2024
v3.0.0-beta.97 (2024-08-30)

🚀 Features
- move logger configuration to Payload config (#7973) (8202c3d)
- templates: update website src directory structure (#7971) (90b3e83)
🐛 Bug Fixes
- templates: add button to exit preview mode (#7991) (c1533bf)
- migrations exit code (#7989) (442d105)
- ui: upload field not showing admin.description (#7978) (b6ae689)
- nested-docs-plugin: throw an error to the UI if children are not passing validation (#7977) (e033488)
- ui: upload with has many bulk select not working with postgres (#7976) (e071382)
- ui: propagates sort change events through list query provider (#7968) (c072822)
Contributors
- Paul (@paulpopus)
- Elliot DeNolf (@denolfe)
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
Aug 29, 2024
v3.0.0-beta.96 (2024-08-29)

🚀 Features
- auto-removes localized property from localized fields within other localized fields (#7933) (538b7ee)
- significantly reduce payload install size by removing unnecessary monaco-editor dependency (#7939) (e375f6e)
- reduce package size and amount of dependencies by upgrading json-schema-to-typescript (#7938) (dc12047)
🐛 Bug Fixes
- db-postgres: nested localized arrays (#7962) (ac10bad)
- prevents duplicate active nav indicators (#7943) (de3d7c9)
- improve validation errors for unique fields (#7937) (cc9b877)
- incorrect config.upload types (#7874) (0962850)
⚠️ BREAKING CHANGES
- auto-removes localized property from localized fields within other localized fields (#7933) (538b7ee)
  
  Payload localization works on a field-by-field basis. As you can nest fields within other fields, you could potentially nest a localized field within a localized field—but this would be redundant and unnecessary. There would be no reason to define a localized field within a localized parent field, given that the entire data structure from the parent field onward would be localized.
  
  Up until this point, Payload would allow you to nest a localized field within another localized field, and this might have worked in MongoDB but it will throw errors in Postgres.
  
  Now, Payload will automatically remove the localized: true property from sub-fields within sanitizeFields if a parent field is localized.
  
  This could potentially be a breaking change if you have a configuration with MongoDB that nests localized fields within localized fields.
  
  Migrating
  
  You probably only need to migrate if you are using MongoDB, as there, you may not have noticed any problems. But in Postgres or SQLite, this would have caused issues so it's unlikely that you've made it too far without experiencing issues due to a nested localized fields config.
  
  In the event you would like to keep existing data in this fashion, we have added a compatibility.allowLocalizedWithinLocalized flag to the Payload config, which you can set to true, and Payload will then disable this new sanitization step.
  
  Set this compatibility flag to true only if you have an existing Payload MongoDB database from pre-3.0, and you have nested localized fields that you would like to maintain without migrating.
Contributors
- James Mikrut (@jmikrut)
- Elliot DeNolf (@denolfe)
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
- Paul (@paulpopus)
Aug 28, 2024
v3.0.0-beta.95 (2024-08-28)

🐛 Bug Fixes
- ui: admin.dependencies components not added to client config (#7928) (ef818fd)
- richtext-lexical: enabledCollections and disabledCollections props in RelationshipFeature (#7926) (0aaf3af)
- db-postgres, db-sqlite: hasMany text, number, poly relationship, blocks, arrays within localized fields (#7900) (18b0806)
- richtext-lexical: ensure html converter text is escaped (#7919) (c7e7dc7)
- active nav item set incorrectly in child routes (#7918) (375671c)
- depth not being respected by upload has many (#7897) (27d743e)
Contributors
- Elliot DeNolf (@denolfe)
- Alessio Gravili (@AlessioGr)
- Germán Jabloñski (@GermanJablo)
- James Mikrut (@jmikrut)
- Jacob Fletcher (@jacobsfletch)
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
Aug 27, 2024
v3.0.0-beta.94 (2024-08-27)

🚀 Features
- templates: add new slug component to the website (#7895) (5d97d57)
🐛 Bug Fixes
- upload has many field updates (#7894) (a76be81)
- richtext-lexical: html converters can populate relationships infinitely (#7890) (de7ff1f)
- locale selector + autosave race condition (#7891) (3d714d3)
Contributors
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
- James Mikrut (@jmikrut)
- Elliot DeNolf (@denolfe)
Aug 27, 2024
v3.0.0-beta.93 (2024-08-27)

🐛 Bug Fixes
- bugs in versions UI with perPage, pagination and diffs not showing for tabs. publish button no longer double saves when using keyboard (#7889) (23c5ef4)
- richtext-lexical: dependency checker suggesting incorrect version (#7888) (f046a04)
Contributors
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
Aug 27, 2024
v3.0.0-beta.92 (2024-08-27)

🚀 Features
- implement info command (#7882) (ea48cfb)
- add nextjs and react version checks to dependency checker (#7868) (dfb4c8e)
- richtext-lexical: more lenient url validation, URL-encode invalid urls on save (#7870) (ad7a387)
🐛 Bug Fixes
- templates: website live preview and code block (#7881) (1aeb912)
- plugin-seo: remove dependency on import from payload/next package (#7879) (ce2cb35)
- error when closing the live preview popup window (#7878) (d3ec68a)
- templates: website bug fixes for slug generation and form builder and adds support for strictNullChecks: true (#7877) (05bf52a)
- sanitizes modifyResponseHeaders from client config (#7876) (fed7f2f)
- exports richtext-slate useSlatePlugin (#7875) (686b086)
Contributors
- Elliot DeNolf (@denolfe)
- Paul (@paulpopus)
- Jacob Fletcher (@jacobsfletch)
- James Mikrut (@jmikrut)
- Alessio Gravili (@AlessioGr)
Aug 23, 2024
v3.0.0-beta.91 (2024-08-23)

Features
- templates: add vercel postgres template (#7841) (825d8b8)
- enable react compiler for @payloadcms/next package (#7839) (83022f6)
- richtext-lexical: improve upload and relationship node types (#7822) (6349cd4)
- ui: add styling for no docs and clear all on hasmany upload (#7816) (95ebead)
Bug Fixes
- next: properly 404s not found documents (#7833) (03440f5)
- trim down accepted args of getPayloadHMR (#7834) (0fa6611)
- collapsible toggle hover stacking issue (#7812) (49c0709)
- weaken JsonObject type to allow types from payload-types being assigned to it (#7815) (c2b2f10)
- ui: relationship field "add new" button styling (#7814) (3eed8b1)
- richtext-lexical: slate => lexical migrator improvements (#7802) (1eefb12)
Contributors
- Elliot DeNolf (@denolfe)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Tylan Davis (@tylandavis)
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
- Dan Ribbens (@DanRibbens)
- Ritsu (@r1tsuu)
Aug 22, 2024
v3.0.0-beta.90 (2024-08-22)

Features
- @payloadcms/db-vercel-postgres adapter (#7806) (631431e)
Bug Fixes
- ui: upload has many no rows error (#7804) (492d920)
Contributors
- Elliot DeNolf (@denolfe)
- Paul (@paulpopus)
Aug 22, 2024
v3.0.0-beta.89 (2024-08-22)

Features
- upload hasmany (#7796) (d2571e1)
- bulk upload (#7800) (1ee19d3)
- log document id in ValidationError cause, if present (9beaa28)
- extends Button and extracts ListHeader components (#7777) (cad1906)
Bug Fixes
- richtext-lexical: ensure errors during slate => lexical migration are caught and do not halt migration progress (cf66341)
- richtext-lexical: inaccurate detection of whether the editor is empty or not (5174c70)
- richtext-lexical: migrate scripts not working due to migration hooks running during migrate script (d894ac7)
- no longer handle disabling node deprecation warnings within bin script shebangs, as it errored on some systems (#7797) (af0105c)
- ui, richtext-lexical: corrects clickable areas on block headers (#7791) (93e8131)
- handles custom collection description components (#7789) (cb9b80a)
BREAKING CHANGES
- handles custom collection description components (#7789) (cb9b80a)
  
  If you were previously defining a custom description component on a collection, simply move it into the correct position.
  
  Old:
  
  { admin: { components: { edit: { Description: '' } } } }
  
  New:
  
  { admin: { components: { Description: '' } } }
Contributors
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
- Jarrod Flesch (@JarrodMFlesch)
- Tylan Davis (@tylandavis)
- Jacob Fletcher (@jacobsfletch)
Aug 20, 2024
v3.0.0-beta.88 (2024-08-20)

Features
- ui: export Banner component (#7779) (95a8bb0)
Bug Fixes
- ui: on Table component crashing when looking for className on admin (#7776) (9c2ccbf)
- plugin-search: not being able to override labels (#7775) (3ee0e84)
- ui: text clipping on document header title with Segoe UI font (#7774) (6ec9820)
Contributors
- Elliot DeNolf (@denolfe)
- Paul (@paulpopus)
- Tylan Davis (@tylandavis)
Aug 20, 2024
v3.0.0-beta.87 (2024-08-20)

Features
- threads field config through components and strictly types props (#7754) (3a91deb)
Contributors
- Jacob Fletcher (@jacobsfletch)
Aug 20, 2024
v3.0.0-beta.86 (2024-08-20)

Features
- pre-compile ui and richtext-lexical with react compiler (#7688) (ebd43c7)
Bug Fixes
- type generation for block fields with no blocks (#7765) (0c36cbd)
- useField incorrect initialization of errorMessage on update (#7756) (adf2f31)
- postgres migrate args (#7766) (17312d9)
Contributors
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
- Jarrod Flesch (@JarrodMFlesch)
- James Mikrut (@jmikrut)
Aug 19, 2024
v3.0.0-beta.85 (2024-08-19)

Features
- custom view and document-level metadata (#7716) (a526c7b)
- abstract postgres base adapter (#7732) (2835e1d)
Bug Fixes
- migrate error on windows (#7759) (bb09da0)
- ui: tabs preferences not being saved (#7761) (ab09f2a)
- richtext-lexical: richtext editor features overriding other editor features props if multiple editors in one document (#7758) (2f38290)
- prevent vertical scrolling on tab fields (#7729) (b3b1cd2)
- ui: relationship cells in table from list drawer not shown (#7730) (6eb4438)
Contributors
- Dan Ribbens (@DanRibbens)
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
- Tylan Davis (@tylandavis)
Aug 16, 2024
v3.0.0-beta.84 (2024-08-16)

Bug Fixes
- adds default drizzle package exports (#7728) (3d37d74)
- ensures user is accurate in useAuth (#7727) (de19822)
- corrects logout icon styling (#7726) (2b2bcb5)
Contributors
- James Mikrut (@jmikrut)
- Tylan Davis (@tylandavis)
Aug 16, 2024
v3.0.0-beta.83 (2024-08-16)

Features
- plugin-seo: pass req through to generate functions (#7711) (5eee49d)
Bug Fixes
- type RelationshipFieldClient typed incorrectly (#7725) (b0a7601)
- login with username server validations (#7719) (95569e4)
- bin script error when running on linux (#7721) (1181608)
- ui: ensure that aborting Autosave always has a valid reason for the controller - fixes uncaught error (#7723) (3a86822)
- ensures users cannot be created without confirming pw (#7583) (6f8604e)
Contributors
- Alessio Gravili (@AlessioGr)
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
- Tylan Davis (@tylandavis)
Aug 15, 2024
v3.0.0-beta.82 (2024-08-15)

Bug Fixes
- importMap windows paths (#7706) (3a6c75a)
Contributors
- Jacob Fletcher (@jacobsfletch)
- Dan Ribbens (@DanRibbens)
- Alessio Gravili (@AlessioGr)
- Elliot DeNolf (@denolfe)
Aug 14, 2024
v3.0.0-beta.81 (2024-08-14)

Features
- allow passing false as PayloadComponent which signals that the component should not be rendered (#7682) (49a2d70)
Bug Fixes
- use tsx instead of swc as default bin script transpiler, as swc errors when it encounters 'next/cache' (#7681) (cb7fa00)
- next: supports root document view overrides as separate from default edit view (#7673) (a212cde)
- ui: issue with checking for undefined json when autosave and validate is enabled (#7678) (4f323a3)
Contributors
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Paul (@paulpopus)
Aug 14, 2024
v3.0.0-beta.80 (2024-08-14)

Bug Fixes
- next: properly closes leave-without-saving modal after navigating from Leave anyway button (#7661) (806c22e)
- sidebar nav jumping around when loading page (#7574) (39d7b71)
- ui: ensure field components safely access field.admin property (#7670) (c65f502)
Contributors
- Patrik (@PatrikKozak)
- Alessio Gravili (@AlessioGr)
- Paul (@paulpopus)
Aug 14, 2024
v3.0.0-beta.79 (2024-08-14)

:rotating_light: This release includes breaking changes :rotating_light:

Follow along with the migration guide below for full details on each of the changes. Please reference this document as you migrate your own apps to this release.

So what's included in this release? By far the biggest change comes from this PR (migration guide below).

This PR made significant optimizations to the underlying codebase
- The Payload Config is now 100% Node-safe
- Compile times are 2x faster for some applications
- Greatly increases type-safety throughout the codebase
- Significant improvements for Custom Component types
For a complete list of all other bug fixes and features included in this release, scroll to the bottom of this document.

[!IMPORTANT] The payload config cannot import client files anymore. If you do that, you will get errors when running bin scripts, e.g. "Unknown file extension ".css". This means that you are still importing client modules somewhere in your config - could be components you're still importing without component paths, or older plugins that still import client modules into your config. Follow this migration guide to find out how you can migrate your config.

Migration Guide

To migrate from beta.78 to beta.79, you'll need to make a few changes to your Payload Config. Although this release is substantial, migration is relatively straightforward, with most of the changes only effecting the use of Custom Components.

The following changes are required of all projects:

1. The new "Import Map"
- Add a blank "import map" to your project. Create a new file called importMap.js and add it to /app/(payload)/admin/importMap.js in your app with the following content:
  
  export const importMap = {}
  
  Payload will dynamically inject this file with imports at compile time. If you are using a custom admin route, change the path accordingly.
  
  It is recommended to run the payload generate:importMap command after you're done with the migration (make sure you follow all migration steps below first). Additionally, if the automatic import map generation fails, try running payload generate:importMap.
2. Using the Import Map in your NextJS app
- Thread the "import map" file through your Root Layout, Root Page, and Not Found Pages:
  
  The Root Layout at /app/(payload)/layout.tsx:
  
  // ... import { importMap } from "./admin/importMap.js" //... const Layout = ({ children }: Args) => ( <RootLayout config={configPromise} importMap={importMap}> {children} </RootLayout> ) export default Layout
  
  The Root Page at /app/(payload)/admin/[[...segments]]/page.tsx:
  
  // ... import { importMap } from "../importMap.js" //... const Page = ({ params, searchParams }: Args) => RootPage({ config, importMap, params, searchParams }) export default Page
  
  The Not Found Page at /app/(payload)/admin/[[...segments]]/not-found.tsx:
  
  // ... import { importMap } from "../importMap.js" //... const NotFound = ({ params, searchParams }: Args) => NotFoundPage({ config, importMap, params, searchParams }) export default NotFound
3. Importing your Config file
- If you are importing the Payload Config in a Node.js environment, there is no longer a need for a special loader to process it. Instead, you can simply import the Payload Config directly. To migrate, remove the importConfig and importWithoutClientFiles functions from your Node.js code:
  
  Old:
  
  import { importConfig, importWithoutClientFiles } from "payload" import { join } from "path" const config = importConfig(join(__dirname, "payload.config.js")) const configWithoutClientFiles = importWithoutClientFiles( join(__dirname, "payload.config.js") )
  
  New:
  
  import config from "./payload.config.js"
If you are not using Custom Components in your applications, then you are done! If you are using Custom Components, please continue reading.

Custom Components

If you are using Custom Components in your application, please follow these next steps. Not all of these changes will apply to every project. So first, review this list of changes, and if a change applies to yours, scroll down to that individual section for full details:
1. Update component imports to component paths (required)
2. Update useConfig hook usage (if applicable)
3. Update useComponentMap hook usage (if applicable)
4. Update Custom Field prop references (if applicable)
5. Remove useFieldProps hook usage (if applicable)
6. Update Custom Views and Tabs keys (if applicable)
Here's a full breakdown of each step:

1. Custom Component import changes
- If you are using Custom Components in your Payload Config, the pattern for defining them has changed. You'll need to update your Custom Component definitions to use "component paths" instead of direct imports. To migrate, pass the path to the component's file:
  
  Old:
  
  import { MyCustomComponent } from './MyCustomComponent.js' // ... { // ... admin: { components: { Label: MyCustomComponent }, }, }
  
  New:
  
  { // ... admin: { components: { // NOTE: this path is relative to your `baseDir`, NOT the importing file // The `#` character is used to specify the export name, if necessary Label: '/collections/Posts/MyServerComponent.js#MyExportName', }, }, }
  
  Regarding the extension in the component path: you'd write it as if you were to write an import statement yourself. Few examples, assuming the imports are done from the base directory:
  
  If you'd previously write import { sth } from './file.js' the component path would be '/file.js#sth'
  
  if you'd previously write import { sth } from './file' the component path would be '/file#sth'
  
  if you'd previously write import file from './file.tsx' the component path would be '/file.tsx' or '/file.tsx#default'
  
  Alternatively, you can also define the custom component as a "PayloadComponent" in the Payload Config. This allows you to pass in client-side vs server-side props explicitly, which get automatically sanitized from the client. Previously, you'd have to use an HOC, or a utility such as withMergedProps in order to do that.
  
  { // ... admin: { components: { Label: { path: '/collections/Posts/MyServerComponent.js#MyExportName', // exportName: 'MyComponent2' // optional if you wish to omit the export name from the path clientProps: { someClientProp: 'someValue' }, serverProps: { someServerProp: () => 'someValue' } } }, }, }
  
  More info regarding how the new component path imports work can be found in our custom component imports docs
2. useConfig hook changes
- If you are using the useConfig React hook anywhere in your Custom Components, its return value has changed in shape. The config is now a property within the context object, rather than the return value itself. To migrate, simply destructure the config property from the return value of useConfig:
  
  Old:
  
  import { useConfig } from "@payloadcms/ui" // ... const config = useConfig()
  
  New:
  
  import { useConfig } from "@payloadcms/ui" // ... const { config } = useConfig()
3. useComponentMap hook was deprecated
- If you were using the useComponentMap React hook anywhere in your Custom Components, it no longer exists. Instead, it has been merged into useConfig. To migrate, swap it out for the new hook:
  
  Old:
  
  import { useComponentMap } from "@payloadcms/ui" // ... const { componentMap, getComponentMap } = useComponentMap() const collectionComponentMap = getComponentMap({ collectionSlug: "pages" })
  
  New:
  
  import { useConfig } from "@payloadcms/ui" // ... const { config, getEntityConfig } = useConfig() const collectionClientConfig = getEntityConfig({ collectionSlug: "pages" })
4. Custom Component props have changed
- If you were using Custom Fields anywhere in your code, their props have changed in shape. Previously, field props were spread in at the top-level of the component. Now, they are nested under the field key, which is a client-safe version of that field's config. To migrate, simply change your prop references to be nested under field:
  
  Old:
  
  import type { TextFieldProps } from "payload" const MyCustomField: : React.FC<TextFieldProps> = ({ name }) => { return <div>{name}</div> }
  
  New:
  
  import type { TextFieldProps } from "payload" const MyCustomField: : React.FC<TextFieldProps> = ({ field: { name } }) => { return <div>{name}</div> }
  
  This example demonstrates a simple text field, but this same thing applies to all field types. The type naming convention is consistent across all field types, so you can easily find the type definitions for your respective field type.
5. useFieldProps is not necessary anymore
- If you were using the useFieldProps hook in your Custom Client Components, this is no longer needed. Now, client components are automatically detected and rendered client-side which direct props. To migrate your Custom Client Components, simply remove the useFieldProps hook from your component and read directly from props:
  
  Old:
  
  "use client" import type { TextFieldProps } from "payload" import { useFieldProps } from "@payloadcms/ui" const MyCustomClientComponent: React.FC<TextFieldProps> = () => { const { path } = useFieldProps() return <div>{path}</div> }
  
  New:
  
  "use client" import type { TextFieldProps } from "payload" const MyCustomClientComponent: React.FC<TextFieldProps> = ({ field: { _path }, }) => { return <div>{_path}</div> }
6. Custom views and tab config changes
- The shape of Custom Views and Custom Tabs has changed. Previously, you could define Custom Views and Tabs top-level in the config object OR as a configuration object. Now, you can only define them as a configuration object. For this reason, the keys have changed in casing to reflect the new shape (CapitalCase denotes a React component, camelCase denotes a regular object). To migrate, simply change the casing of of these keys within your Payload Config:
  
  Old:
  
  { // ... admin: { components: { views: { Edit: { Default: { Tab: MyCustomTab }, API: MyCustomAPIView } } } } }
  
  New:
  
  { // ... admin: { components: { views: { edit: { default: { tab: { // ... } }, api: { // ... } } } } } }
  
  This example demonstrates only a subset of the Custom Views that are available in the Payload Config. The same change applies to all Custom Views and Tabs, such as admin.views.account at the root-level, or admin.views.list on Collection Configs.
Other Updates

This release also includes other miscellaneous features and fixes, including:

FEATURES
- richtext-lexical: move migration related features to /migrate subpath export in order to decrease module count when those are not used (#7660) (a192632)
- filename compound index (#7651) (5fc9f76)
BUG FIXES
- richtext-lexical: inline blocks and tables not functioning correctly if they are used in more than one editor on the same page (#7665) (fca4ee9)
- live-preview: encode query string url (#7635) (9cb84c4)
BREAKING CHANGES
- richtext-lexical: move migration related features to /migrate subpath export in order to decrease module count when those are not used (#7660) (a192632)
This lowers the module count by 31 modules

BREAKING: Migration-related lexical modules are now exported from @payloadcms/richtext-lexical/migrate instead of @payloadcms/richtext-lexical

Contributors
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- James Mikrut (@jmikrut)
- Patrik (@PatrikKozak)
- Paul (@paulpopus)
Aug 13, 2024
v3.0.0-beta.78 (2024-08-13)

Features
- add support for custom image size file names (#7634) (56aded8)
- plugin-form-builder: pass beforeChange params into beforeEmail hook and add types to it (#7626) (78dd6a2)
- plugin-redirects: added new option for redirect type in the redirects collection (#7625) (5dfcffa)
- indent migration sql (#7475) (fa3d250)
- adds classnames to list, edit views (#7596) (c1b0d93)
Bug Fixes
- config deepmerge, fixes #7580 (#7639) (b33b5f4)
- autoLogin not working if old, invalid token is present (#7456) (a063b81)
- payload: filtering by polymorphic relationships with drafts enabled (#7570) (8d12037)
- ui: render singular label for ArrayCell when length is 1 (#7586) (f88cef5)
- ui: field permissions not being correctly updated when locale changes (#7611) (4b2a9f7)
- ui: apiKey field not being customisable and field access control not being updated with correct data (#7591) (69ada97)
- set correct step nav path to Account on account page (#7599) (81e7355)
- add editDepth to account view so that it doesn't redirect from modals (#7597) (ce8b95f)
- corrects local strategy user lookup when using loginWithUsername (#7587) (6227276)
Contributors
- James Mikrut (@jmikrut)
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
- Dan Ribbens (@DanRibbens)
- Tylan Davis (@tylandavis)
- Jarrod Flesch (@JarrodMFlesch)
Aug 8, 2024
v3.0.0-beta.77 (2024-08-08)

Bug Fixes
- empty path in error message (#7555) (b546c7b)
Contributors
- Elliot DeNolf (@denolfe)
- Jessica Chowdhury (@JessChowdhury)
Aug 7, 2024
v3.0.0-beta.76 (2024-08-07)

Bug Fixes
- richtext-lexical: next.js multiple refs of same fix (#7572) (b5d65dd)
Contributors
- Elliot DeNolf (@denolfe)
Aug 7, 2024
v3.0.0-beta.75 (2024-08-07)

Features
- db-*: allows for running migrations in production automatically (#7563) (1cb1e5e)
- bump next canary to 104 and update withPayload for new config (#7541) (8d1fc6e)
- richtext-lexical: export serialized inline blocks and table node types (ffd8ea5)
Bug Fixes
- db-postgres: #7492 migrate snapshots (#7540) (46f70d9)
- plugin-seo: issue with generating image from a function (#7566) (b7e2c59)
- hydrate permissions on dashboard, fix active menu item logic (0cc7184)
- ui: fixes issue when filtering by checkbox value in a different language (#7547) (4a20a63)
- next, payload: enable relationship & upload version tracking when localization enabled (#7508) (62744e7)
- richtext-lexical: html converters not respecting overrideAccess property when populating values, in local API (c15d679)
- scopes preferences queries and mutations by user (#7534) (a422a0d)
- ensure pw confirmation when creating users in admin panel (#7535) (edaeb1e)
- custom meta icons getting overwritten by default icon (#7466) (6f35c35)
BREAKING CHANGES
- adjusts auth hydration from server (#7545) (e905675)
  
  Fixes https://github.com/payloadcms/payload/issues/6823
  
  Allows the server to initialize the AuthProvider via props. Renames HydrateClientUser to HydrateAuthProvider. It now only hydrates the permissions as the user can be set from props. Permissions can be initialized from props, but still need to be hydrated for some pages as access control can be specific to docs/lists etc.
  
  Renames exported HydrateClientUser to HydrateAuthProvider
- ⚠️ bump next canary to 104 and update withPayload for new config (#7541) (8d1fc6e)
  
  We are now bumping up the Next canary version to 15.0.0-canary.104 and react and react-dom to ^19.0.0-rc-06d0b89e-20240801.
  
  Your new dependencies should look like this:
  
  "next": "15.0.0-canary.104", "react": "^19.0.0-rc-06d0b89e-20240801", "react-dom": "^19.0.0-rc-06d0b89e-20240801",
- richtext-lexical: html converters not respecting overrideAccess property when populating values, in local API (c15d679)
Contributors
- James Mikrut (@jmikrut)
- Paul (@paulpopus)
- Dan Ribbens (@DanRibbens)
- Jarrod Flesch (@JarrodMFlesch)
- Patrik (@PatrikKozak)
- Alessio Gravili (@AlessioGr)
- Jessica Chowdhury (@JessChowdhury)
Aug 6, 2024
v3.0.0-beta.74 (2024-08-06)

Features
- richtext-lexical: add HTML converter to table feature (9bccdfd)
- richtext-lexical: accessible editor placeholders (c348081)
- richtext-lexical: add table hover actions to quickly add rows or columns (12ba820)
- allows loginWithUsername to not require username (#7480) (1ebd54b)
- updated admin UI (#7424) (68553ff)
- expose useTableColumns hook (#7448) (9a3bce1)
- richtext-lexical: upgrade lexical from 0.16.1 to 0.17.0 (e65b647)
Bug Fixes
- email and username fields rendering in drawers (#7520) (442189e)
- richtext-lexical: various table and icon style issues (#7522) (5d1cc76)
- ui: prevents hasMany text going outside of input boundaries (#7455) (3f5403a)
- ui: properly handles ID field component type based on payload.db.defaultIDType (#7416) (62666a9)
- db-*: drizzle enums, bump drizzle-kit (#7514) (95fcd13)
- cpa: adjust template file location detection (#7507) (0040e17)
- error thrown in version view when localization is false (#7502) (cdb2072)
- #7488, cant deploy SQLite to Vercel (#7490) (005befc)
BREAKING CHANGES
- updated admin UI (#7424) (68553ff)
  
  Custom components and styling that don't utilize Payload's CSS/SCSS variables may need adjustments to match the updated styling.
  
  If you are using the Merriweather font, you will need to manually configure next/font in your own project.
- richtext-lexical: upgrade lexical from 0.16.1 to 0.17.0 (e65b647)
  
  This upgrades lexical from 0.16.1 to 0.17.0. If you have any lexical packages installed in your project, please update them accordingly. Additionally, if you depend on the lexical APIs, please consult their changelog, as lexical may introduce breaking changes: https://github.com/facebook/lexical/releases/tag/v0.17.0
Contributors
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
- Jessica Chowdhury (@JessChowdhury)
- Tylan Davis (@tylandavis)
- Willy Brauner (@willybrauner)
- James Mikrut (@jmikrut)
Aug 2, 2024
v3.0.0-beta.73 (2024-08-02)

Features
- adds upload's relationship thumbnail (#7473) (4d19e64)
- cpa: add sqlite (#7470) (3114359)
Bug Fixes
- too many RSC props were being passed, inflating initial HTML size (#7474) (995f51d)
- set active nav item (#7467) (f752804)
Aug 1, 2024
v3.0.0-beta.72 (2024-08-01)

Features
- adds restore as draft option to versions (#7100) (d307d62)
- ui: expose custom errors in deleteMany (#7438) (febd7f7)
- db-*: add defaultValues to database schemas (#7368) (695ef32)
- cpa: warn on unsupported Next.js version (#7434) (6f5cf5d)
- db-*, payload: better transactions (#7395) (3545888)
Bug Fixes
- db-postgres: incorrect schema type on adapter (#7459) (449c16d)
- db-postgres, db-sqlite: enum schema (#7453) (0758199)
- db-postgres: localized array inside blocks field (#7457) (1ec78a1)
- validates password and confirm password on the server (#7410) (290ffd3)
- ui: reincorporate basePath into logout component link (#7451) (3d89508)
- db-postgres: proper migrations table detection query (#7436) (b5b2bb1)
- formats locales for version comparison view (#7433) (5ef2951)
- hide force unlock button if the user has no permissions to interact with it (#7418) (a943487)
- page param not getting reset when applying filters (#7243) (ada9978)
- next: infinite loop when logging into root admin (#7412) (874279c)
- types for the 'validate' property across fields so internal validation functions can be reused (#7394) (7ed6634)
- export default was not found in graphql (#6975) (09a0ee3)
- plugin-search: ensure search updates are unique to collection (#6363) (67acab2)
- layout preferences for array/blocks were being saved twice in dev mode (#7396) (5cd0c7e)
Contributors
- Dan Ribbens (@DanRibbens)
- Jessica Chowdhury (@JessChowdhury)
- Jarrod Flesch (@JarrodMFlesch)
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Michel v. Varendorff (@mvarendorff)
- Lynn Dylan Hurley (@lynndylanhurley)

Jul 29, 2024

v3.0.0-beta.71 (2024-07-29)

Features

ui: passes field props to custom components (#7360) (97837f0)
adds keepAfterRead to plugin-relationship-objectid (#7388) (f9e5573)

Bug Fixes

db-sqlite: migration template errors (#7404) (6d066c2)
db-postgres: migration template type error (#7403) (1dc4288)
merges headers safely in nextjs route handlers (#7399) (c8da9b1)
ui: stacking drawers (#7397) (2021028)
docs: update import path for validation functions for fields (#7392) (2ea56fe)
ui: handle abort() call signal error (#7390) (5655266)
ui: spacing in row fields by using gap instead of inner margins (#7387) (e823051)

BREAKING CHANGES

ui: passes field props to custom components (#7360) (97837f0)

Currently, there is no way to read field props from within a custom field component, i.e. admin.components.Description. For example, if you set maxLength: 100 on your field, your custom description component cannot read it from props.maxLength or any other methods. Because these components are rendered on the server, there is also no way of using admin.component.Field to inject custom props yourself, either. To support this, we can simply pass the base component props into these components on the server, as expected. This has also led to custom field component props becoming more strictly typed within the config.

This change is considered breaking only because the types have changed. This only affects you if you were previously importing the following types into your own custom components. To migrate, simply change the import paths for that type.

Old:

import type {
  ArrayFieldProps,
  ReducedBlock,
  BlocksFieldProps,
  CheckboxFieldProps,
  CodeFieldProps,
  CollapsibleFieldProps,
  DateFieldProps,
  EmailFieldProps,
  GroupFieldProps,
  HiddenFieldProps,
  JSONFieldProps,
  NumberFieldProps,
  PointFieldProps,
  RadioFieldProps,
  RelationshipFieldProps,
  RichTextComponentProps,
  RowFieldProps,
  SelectFieldProps,
  TabsFieldProps,
  TextFieldProps,
  TextareaFieldProps,
  UploadFieldProps,
  ErrorProps,
  FormFieldBase, 
  FieldComponentProps,
  FieldMap,
  MappedField,
  MappedTab,
  ReducedBlock,
} from '@payloadcms/ui'

New:

import type {
  FormFieldBase, 
  // etc.
} from 'payload'

Custom field components are now much more strongly typed. To make this happen, an explicit type for every custom component has been generated for every field type. The convention is to append DescriptionComponent, LabelComponent, and ErrorComponent onto the end of the field name, i.e. TextFieldDescriptionComponent. Here's an example:

import type { TextFieldDescriptionComponent } from 'payload'

import React from 'react'

export const CustomDescription: TextFieldDescriptionComponent = (props) => {
  return (
    <div id="custom-field-description">{`The max length of this field is: ${props?.maxLength}`}</div>
  )
}

Here's the full list of all new types:

Label Components:

import type {
  ArrayFieldLabelComponent,
  BlocksFieldLabelComponent,
  CheckboxFieldLabelComponent,
  CodeFieldLabelComponent,
  CollapsibleFieldLabelComponent,
  DateFieldLabelComponent,
  EmailFieldLabelComponent,
  GroupFieldLabelComponent,
  HiddenFieldLabelComponent,
  JSONFieldLabelComponent,
  NumberFieldLabelComponent,
  PointFieldLabelComponent,
  RadioFieldLabelComponent,
  RelationshipFieldLabelComponent,
  RichTextFieldLabelComponent,
  RowFieldLabelComponent,
  SelectFieldLabelComponent,
  TabsFieldLabelComponent,
  TextFieldLabelComponent,
  TextareaFieldLabelComponent,
  UploadFieldLabelComponent
} from 'payload'

Error Components:

import type {
  ArrayFieldErrorComponent,
  BlocksFieldErrorComponent,
  CheckboxFieldErrorComponent,
  CodeFieldErrorComponent,
  CollapsibleFieldErrorComponent,
  DateFieldErrorComponent,
  EmailFieldErrorComponent,
  GroupFieldErrorComponent,
  HiddenFieldErrorComponent,
  JSONFieldErrorComponent,
  NumberFieldErrorComponent,
  PointFieldErrorComponent,
  RadioFieldErrorComponent,
  RelationshipFieldErrorComponent,
  RichTextFieldErrorComponent,
  RowFieldErrorComponent,
  SelectFieldErrorComponent,
  TabsFieldErrorComponent,
  TextFieldErrorComponent,
  TextareaFieldErrorComponent,
  UploadFieldErrorComponent
} from 'payload'

Description Components:

import type {
  ArrayFieldDescriptionComponent,
  BlocksFieldDescriptionComponent,
  CheckboxFieldDescriptionComponent,
  CodeFieldDescriptionComponent,
  CollapsibleFieldDescriptionComponent,
  DateFieldDescriptionComponent,
  EmailFieldDescriptionComponent,
  GroupFieldDescriptionComponent,
  HiddenFieldDescriptionComponent,
  JSONFieldDescriptionComponent,
  NumberFieldDescriptionComponent,
  PointFieldDescriptionComponent,
  RadioFieldDescriptionComponent,
  RelationshipFieldDescriptionComponent,
  RichTextFieldDescriptionComponent,
  RowFieldDescriptionComponent,
  SelectFieldDescriptionComponent,
  TabsFieldDescriptionComponent,
  TextFieldDescriptionComponent,
  TextareaFieldDescriptionComponent,
  UploadFieldDescriptionComponent
} from 'payload'

This PR also:

Standardizes the FieldBase['label'] type with a new LabelStatic type. This makes type usage much more consistent across components.
Simplifies some of the typings in the field component map, removes unneeded <Omit>, etc.
Fixes misc. linting issues around voiding promises

ui: update the names of internal components so that they respect eslint rules (#7362) (e734d51)

So _Upload becomes UploadComponent which doesnt break the naming convention of react components and we no longer export these internal components

Contributors

Dan Ribbens (@DanRibbens)
James Mikrut (@jmikrut)
Jacob Fletcher (@jacobsfletch)
Paul (@paulpopus)
Patrik (@PatrikKozak)

Jul 26, 2024
v3.0.0-beta.70 (2024-07-26)

Features
- templates: add live preview breakpoints for mobile, tablet and desktop to website template (#7384) (4704c8d)
- cpa: support next.config.ts (#7367) (a64f37e)
Bug Fixes
- db-postgres: properly reference drizzle createTableName function (#7383) (55c6ce9)
Contributors
- Paul (@paulpopus)
- Elliot DeNolf (@denolfe)
Jul 26, 2024
v3.0.0-beta.69 (2024-07-26)

Features
- payload: allows metadata to be appended to the file of the output media (#7293) (b5afc62)
- drizzle: abstract shared sql code to new package (#7320) (09ad6e4)
- adds @payloadcms/live-preview-vue to release pipeline (#7328) (904ec01)
- next: root admin (#7276) (863abc0)
Bug Fixes
- filterOptions for upload fields (#7347) (70f2e16)
- db-mongodb: adds new optional collation feature flag behind mongodb collation option (#7361) (8ba39aa)
- ui: hide 'Create new' button entirely if user has no access to create a media item (#7348) (128d721)
- attempts to use query.locale when present in createLocalReq (#7345) (2796d21)
- relaxes equality check for relationship options in filter (#7343) (cbac62a)
- db-postgres: localized groups/tabs and nested fields (#6158) (51f1c8e)
- some email adapters not working if they're promises due to config sanitisation (#7326) (c129c10)
- misc issues with loginWithUsername (#7311) (b2814eb)
- ui: email field now correctly renders autocomplete attribute (#7322) (c405e59)
- plugin-stripe: properly types async webhooks (#7317) (a35979f)
- ui: Where query selectors for checkboxes are now translated (#7309) (b9cf6c7)
- first version doc throws error (#7314) (f2b3305)
- db-mongodb: removes precedence of regular chars over international chars in sort (#7294) (b3e8ddf)
- cpa: check cmd exists after first checking flag and lock file (#7297) (83ad453)
Contributors
- James Mikrut (@jmikrut)
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
- Paul (@paulpopus)
- Jarrod Flesch (@JarrodMFlesch)
- Ritsu (@r1tsuu)
- Dan Ribbens (@DanRibbens)
- Jacob Fletcher (@jacobsfletch)
- Jessica Chowdhury (@JessChowdhury)
Jul 22, 2024
v3.0.0-beta.68 (2024-07-22)

Features
- upgrade pino and pino-pretty, clean up hacky esm imports (#7291) (4584478)
- remove joi schema validation (#7226) (e83eb99)
- 700% faster deepCopyObject, refactor deep merging and deep copying, type improvements (#7272) (c45fbb9)
- new server-only, faster and immediate autoLogin (#7224) (a7b0f8b)
- ui: change autosave logic to send updates as soon as possible, improving live preview speed (#7201) (014ee1a)
- update reserved fields name check to be more comprehensive and only check top level fields (#7235) (76b3075)
Bug Fixes
- search plugin localized fields (#7292) (5aa3283)
- templates: website template building error with postgres number IDs (#7281) (bba7cf3)
- ui: not updating permissions when locale changes (#7245) (1ae71a3)
- payload: resizes images first before applying focal point (#7277) (2c16c60)
- api errors not populating in prod (#7232) (3d63ce9)
BREAKING CHANGES
- 700% faster deepCopyObject, refactor deep merging and deep copying, type improvements (#7272) (c45fbb9)
  
  The deepMerge exported from payload now handles more complex data and is slower. The old, simple deepMerge is now exported as deepMergeSimple
  
  combineMerge is no longer exported. You can use deepMergeWithCombinedArrays instead
  
  The behavior of the exported deepCopyObject and isPlainObject may be different and more reliable, as the underlying algorithm has changed
- new server-only, faster and immediate autoLogin (#7224) (a7b0f8b)
  
  autoLogin without prefillOnly set now also affects graphQL/Rest operations. Only the user specified in autoLogin will be returned. Within the graphQL/Rest/Local API, this should still allow you to authenticate with a different user, as the autoLogin user is only used if no token is set.
Contributors
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
- Paul (@paulpopus)
- Dan Ribbens (@DanRibbens)
- Patrik (@PatrikKozak)
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
Jul 18, 2024
v3.0.0-beta.67 (2024-07-18)

Bug Fixes
- ui: uploading from drawer & focal point positioning (#7117) (00771b1)
Contributors
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Jarrod Flesch (@JarrodMFlesch)
Jul 18, 2024
v3.0.0-beta.66 (2024-07-18)

Features
- ability to login with email, username or both (#7086) (7b3b021)
- add db idType to generated payload types (#7186) (502548a)
- richtext-lexical: inline blocks (#7102) (676dfa3)
- next: strongly type getNextRequestI18n (#7157) (c6da04a)
Bug Fixes
- cherry picks lockUntil fix from #6052 (#7213) (478fb8d)
- aliases AfterMe, AfterLogout, and AfterRefresh hook types (#7216) (700baf1)
- templates: bad import in website seed script (#7198) (a3af360)
- maxListenersExceeded warning due to atomically, which is a peerdep of conf (#7182) (1fe6761)
- ui: search queries remain between navigation (#7169) (f909f06)
- richtext-lexical: slash menu keyboard navigation not triggering auto-scroll (#7185) (fe23ca5)
- webpack error if dbName or enumName was set (#7184) (8fdd88b)
- ui: date field background color specificity (#7181) (1ea2e32)
- version comparison view showing empty localized fields (#7180) (8fb17c2)
- localised relationship fields (#7178) (2f0aa83)
BREAKING CHANGES
- aliases AfterMe, AfterLogout, and AfterRefresh hook types (#7216) (700baf1)
Duplicate of #7146 but for beta. If you were using the AfterMeHook, AfterLogoutHook, or AfterRefreshHook, these types have been renamed and are now prefixed with Collection to match all other hook naming conventions, just as the documentation already indicates.

Old:
```
import type { AfterMeHook, AfterLogoutHook, AfterRefreshHook } from 'payload'
```
New:
```
import type { CollectionAfterMeHook, CollectionAfterLogoutHook, CollectionAfterRefreshHook } from 'payload'
```
Contributors
- Jarrod Flesch (@JarrodMFlesch)
- Jacob Fletcher (@jacobsfletch)
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
- Jessica Chowdhury (@JessChowdhury)
Jul 15, 2024
v3.0.0-beta.65 (2024-07-15)

Features
- configure cors allowed headers (#6837) (9c72ab9)
Bug Fixes
- richtext-lexical: newly created upload nodes with extra fields do not display fields when opening extra fields drawer (#7155) (35f7a9e)
- richtext-*: nested field recursion for named tabs did not work (8c5a1f0)
- richtext-lexical: one-line migrators not detecting richText migrations in nested fields (6d68a4a)
- email-nodemailer: skipVerify behavior being reversed (#6790) (f494eba)
- custom tabs not working in globals (#7148) (24f55c9)
Contributors
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Hulpoi George-Valentin (@GeorgeHulpoi)
- Jasper Beaurain (@JasperBeaurain)
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
Jul 12, 2024
v3.0.0-beta.63 (2024-07-12)

Fixes publishing issue
Jul 12, 2024
v3.0.0-beta.62 (2024-07-12)

Features
- validate field names for reserved names (#7130) (03d854e)
- ui: various admin panel styling improvements (#7121) (c359c34)
- suppress email adapter warning on build (#7129) (b750ebf)
- ui: updates version status UI to be more informative (#6661) (c019969)
- richtext-lexical: add missing SerializedLineBreakNode to default node types, remove SerializedBlockNode from default node types (1c8bed5)
- richtext-lexical: allow SerializedBlockNode fields to be typed via generic (10336ba)
Contributors
- Paul (@paulpopus)
- Tylan Davis (@tylandavis)
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
- Alessio Gravili (@AlessioGr)
- Jessica Chowdhury (@JessChowdhury)
Jul 12, 2024
v3.0.0-beta.61 (2024-07-12)

Features
- upgrade minimum react, react-dom, @types/react and @types/react-dom versions to match exactly what Next.js is using, various dependency cleanup (#7106) (f86e0ed)
- adds ability to upload files from a remote url (#7063) (d99bff9)
Bug Fixes
- ui: ctrl+s not triggering a save if autosave is enabled (#7120) (840e075)
- templates: website template gitignore issue for case sensitivity (#7118) (1baf775)
- richtext-lexical: export types as type-only exports (#7097) (edf743e)
BREAKING CHANGES
- upgrade minimum react, react-dom, @types/react and @types/react-dom versions to match exactly what Next.js is using, various dependency cleanup (#7106) (f86e0ed)
BREAKING:

Upgrades minimum supported @types/react version from npm:types-react@19.0.0-beta.2 to npm:types-react@19.0.0-rc.0

Upgrades minimum supported @types/react-dom version from npm:types-react-dom@19.0.0-beta.2 to npm:types-react-dom@19.0.0-rc.0

Upgrades minimum supported react and react-dom version from 19.0.0-rc-f994737d14-20240522 to 19.0.0-rc-6230622a1a-20240610
Contributors
- Jacob Fletcher (@jacobsfletch)
- Paul (@paulpopus)
- Elliot DeNolf (@denolfe)
- Alessio Gravili (@AlessioGr)
- Jarrod Flesch (@JarrodMFlesch)
- Patrik (@PatrikKozak)
Jul 10, 2024
v3.0.0-beta.60 (2024-07-10)

Features
- plugin-search: make search collection fields override into a function that provides defaultFields inline with other plugins (#7095) (2bc8666)
- cpa: add website template to CPA (#7079) (c1c12bc)
- replace qs with qs-esm (#6966) (6c99326)
- storage-azure: expose storage client (#7069) (f46ea01)
- richtext-lexical: remove unused json-schema dependency (#7072) (376a651)
- updated admin panel color palette (#7011) (c2022f6)
Bug Fixes
- ui: tooltips for fields rendered outside RenderFields not positioned correctly (#7074) (bd5f5a2)
- exports getSiblingData, getDataByPath, and reduceFieldsToValues from payload (#7070) (0a2ecf8)
- graphql query concurrency issues (#6925) (fb72d19)
- plugin-form-builder: make fields optional type in overrides (#7062) (cd9df73)
- plugin-redirects: make fields optional type in overrides (#7061) (b7acfe5)
BREAKING CHANGES
- plugin-search: make search collection fields override into a function that provides defaultFields inline with other plugins (#7095) (2bc8666)
  
  searchPlugin's searchOverrides for the collection now takes in a fields function instead of array similar to other plugins and patterns we use to allow you to map over existing fields as well if needed.
  
  // before searchPlugin({ searchOverrides: { slug: 'search-results', fields: [ { name: 'excerpt', type: 'textarea', admin: { position: 'sidebar', }, }, ] }, }), // current searchPlugin({ searchOverrides: { slug: 'search-results', fields: ({ defaultFields }) =[ ...defaultFields, { name: 'excerpt', type: 'textarea', admin: { position: 'sidebar', }, }, ] }, }),
- exports getSiblingData, getDataByPath, and reduceFieldsToValues from payload (#7070) (0a2ecf8)
  
  Exports getSiblingData, getDataByPath, reduceFieldsToValues, and unflatten from payload. These utilities were previously accessible using direct import paths from @payloadcms/ui—but this is no longer advised since moving to a pre-bundled UI library pattern. Instead of simply exporting these from the @payloadcms/ui package, these exports have been moved to Payload itself to provision for use outside of React environments.
  
  This is considered a breaking change. If you were previously importing any of these utilities, the imports paths have changed as follows:
  
  Old:
  
  import { getSiblingData, getDataByPath, reduceFieldsToValues } from '@payloadcms/ui/forms/Form' import { unflatten } from '@payloadcms/ui/utilities'
  
  New:
  
  import { getSiblingData, getDataByPath, reduceFieldsToValues, unflatten } from 'payload/shared'
  
  The is-buffer dependency was also removed in this PR.
- updated admin panel color palette (#7011) (c2022f6)
  
  Color values have changed and will have different contrasts. If you use any of Payload's colors in your apps, you may need to adjust your use of them to maintain proper styling/accessibility.
  
  Colors palettes changed:
  
  --theme-success-*
  
  --theme-error-*
  
  --theme-warning-*
  
  --color-success-*
  
  --color-error-*
  
  --color-warning-*
  
  --color-blue-*
  
  Updates the color palette used throughout Payload to be more consistent between dark and light values. Contrast values are now more in line with the theme-elevation contrasts. Some adjustments to the Toast components as well to match light/dark mode better.
Jul 8, 2024
v3.0.0-beta.59 (2024-07-08)

Features
- support latest Next.js versions, fix server-only props being passed to Client Document Views (#7026) (1cf7d4d)
- ui: support nested tabs, groups, collapsibles and rows in where filters in list view (#7044) (b6d85f6)
- avoid unnecessary config await in getPayloadHMR (#7045) (187813e)
Bug Fixes
- richtext-lexical: avoid conflicts between internal component/schema map paths and field names (#7042) (16c1d94)
BREAKING CHANGES
- support latest Next.js versions, fix server-only props being passed to Client Document Views (#7026) (1cf7d4d)
BREAKING: The minimum required Next.js version has been bumped from 15.0.0-rc.0 to 15.0.0-canary.53. This is because the way client components are represented changed somewhere between those versions, and it is not feasible to support both versions in our RSC detection logic.

Contributors
- Alessio Gravili (@AlessioGr)
- Wilson (@WilsonLe)
- Paul (@paulpopus)
Jul 3, 2024
v3.0.0-beta.58 (2024-07-03)

Features
- richtext-lexical: add EXPERIMENTAL_TableFeature, allow Client Features to register providers (#7010) (93bdc0e)
Bug Fixes
- ensures req has headers, passes it through in view rendering (#7012) (4a8d3a0)
Contributors
- Jacob Fletcher (@jacobsfletch)
- Alessio Gravili (@AlessioGr)
- Jarrod Flesch (@JarrodMFlesch)
Jul 2, 2024
v3.0.0-beta.57 (2024-07-02)

Features
- ui: allows filtering on group and tab fields from list controls (#6647) (d4d4101)
- richtext-lexical: upgrade lexical from 0.16.0 to 0.16.1 (#7009) (2a2ab53)
- allow users/plugins to modify and extend generated types for fields & config, add generated types for json field (#6984) (eb2f763)
- adds loginWithUsername option to auth config (#7000) (955b845)
- plugin-seo: export fields from plugin seo so that they can be imported freely in a collection fields config (#6996) (25d368a)
- ui: export iterateFields function (#6995) (cce1397)
- export missing utilities and types from payload (#6993) (d05a033)
- plugin-seo: russian translations (#6987) (2285624)
Bug Fixes
- richtext-lexical: auto link node escapes on second "." (98ff746)
- ui: content alignment in modal (#7003) (fd7d500)
- translation fallback language returning the label and not the language key (#7001) (9ab057d)
BREAKING CHANGES
- richtext-lexical: upgrade lexical from 0.16.0 to 0.16.1 (#7009) (2a2ab53)
BREAKING: Lexical may introduce undocumented breaking changes, if you use the lexical API directly. Please consult their changelog: https://github.com/facebook/lexical/releases/tag/v0.16.1
- simplify api handler (#6910) (0711f88)
Removes PayloadRequestWithData in favour of just PayloadRequest with optional types for data and locale

addDataAndFileToRequest and addLocalesToRequestFromData now takes in a single argument instead of an object

// before await addDataAndFileToRequest({ request: req }) addLocalesToRequestFromData({ request: req }) // current await addDataAndFileToRequest(req) addLocalesToRequestFromData(req)
Contributors
- Jessica Chowdhury (@JessChowdhury)
- Alessio Gravili (@AlessioGr)
- Ritsu (@r1tsuu)
- Paul (@paulpopus)
- Jarrod Flesch (@JarrodMFlesch)
- Harley Salas (@HarleySalas)
Jun 28, 2024
v3.0.0-beta.56 (2024-06-28)

Features
- richtext-lexical: simplify schemaMap handling (#6980) (368dd2c)
- show detailed validation errors in console (#6551) (8f346df)
- richtext-lexical: export SerializedHeadingNode, add default node types (#6978) (75a3040)
- ui: expose CheckboxInput, SelectInput and DatePicker (#6972) (9cdcf20)
- next: allows auth strategies to return headers that need to be… (#6964) (37e2da0)
- adds refresh hooks (#6965) (07f3f27)
- richtext-lexical: new FieldsDrawer utility, improve blocks feature performance (#6967) (0017c67)
- richtext-lexical: new FieldsDrawer utility (0a42281)
- ui: export SaveButton / SaveDraftButton components (#6952) (4404a3c)
- richtext-lexical: upgradeLexicalData function (#6949) (8e232e6)
Bug Fixes
- plugin-seo: data types plugin seo (#6979) (559c064)
- richtext-lexical: remove unnecessary JSON.parse(JSON.stringify()) of blocks feature formData (69a42fa)
- properly cases custom collection components (#6948) (70957b0)
BREAKING CHANGES
- show detailed validation errors in console (#6551) (8f346df)
ValidationError now requires the global or collection slug, as well as an errors property. The actual errors are no longer at the top-level.
- plugin-seo: data types plugin seo (#6979) (559c064)
Changed the data to correctly match type generic being sent to the generate functions. So now you can type your generateTitle etc. functions like this
```
// before
const generateTitle: GenerateTitle = async <Page>({ doc, locale }) => {
  return `Website.com — ${doc?.title?.value}`
}


// curent
import type { GenerateDescription, GenerateTitle, GenerateURL } from '@payloadcms/plugin-seo/types'
import type { Page } from './payload-types'

const generateTitle: GenerateTitle<Page> = async ({ doc, locale }) => {
  return `Website.com — ${doc?.title}`
}

const generateDescription: GenerateDescription<Page> = async ({ doc, locale }) => {
  return doc?.excerpt || 'generated description'
}

const generateURL: GenerateURL<Page> = async ({ doc, locale }) => {
  return `https://yoursite.com/${locale ? locale + '/' : ''}${doc?.slug || ''}`
}
```
Breaking change because it was previously a FormState value.
- next: allows auth strategies to return headers that need to be… (#6964) (37e2da0)
Some authentication strategies may need to set headers for responses, such as updating cookies via a refresh token, and similar. This PR extends Payload's auth strategy capabilities with a manner of accomplishing this.

This is a breaking change if you have custom authentication strategies in Payload's 3.0 beta. But it's a simple one to update.

Instead of your custom auth strategy returning the user, now you must return an object with a user property.

This is because you can now also optionally return responseHeaders, which will be returned by Payload API responses if you define them in your auth strategies. This can be helpful for cases where you need to set cookies and similar, directly within your auth strategies.

Before:
```
return user
```
After:
```
return { user }
```
- properly cases custom collection components (#6948) (70957b0)
Properties within the Custom Collection Components config were not properly cased. In the Payload Config, there are places where we expose an array of Custom Components to render. These properties should be cased in camelCase to indicate that its type is not a component, but rather, it's an array of components. This is how all other arrays are already cased throughout the config, therefore these components break exiting convention. The CapitalCase convention is reserved for components themselves, however, fixing this introduces a breaking change. Here's how to migrate:

Old:
```
{
 // ...
 admin: {
   components: {
     AfterList: [],
     AfterListTable: [],
     BeforeList: [],
     BeforeListTable: [],
   }
  }
}
```
New:
```
{
 // ...
 admin: {
   components: {
     afterList: [],
     afterListTable: [],
     beforeList: [],
     beforeListTable: [],
   }
 }
}
```
The docs were also out of date for the Root-level Custom Components. These components are documented in CaptalCase but are in fact cased correctly in Payload. This PR fixes that.

Contributors
- Elliot DeNolf (@denolfe)
- Alessio Gravili (@AlessioGr)
- Paul (@paulpopus)
- James Mikrut (@jmikrut)
- Frederic Perron (@FredPerr)
- Ritsu (@r1tsuu)
- Jacob Fletcher (@jacobsfletch) &prerelease=1
Jun 26, 2024
v3.0.0-beta.55 (2024-06-26)

Features
- richtext-lexical: new slate => lexical migration function which migrates all your documents at once (#6947) (5105676)
- add the ability to pass in a response to upload handlers (#6926) (6b7ec6c)
- ability to pass uploadActions to the Upload component (#6941) (35eb16b)
- ability to add custom upload component (#6927) (d8d5a44)
- richtext-lexical: improve lexical types (#6928) (0b2be54)
Bug Fixes
- richtext-lexical: properly set heading level translation for nb and pl (#6900) (abf6e9a)
- auth strategy exp (#6945) (5ffc5a1)
- should not display create/login view with disableLocalStrategy: true (#6940) (c34aa86)
Contributors
- Alessio Gravili (@AlessioGr)
- Anders Semb Hermansen (@andershermansen)
- James Mikrut (@jmikrut)
- Jacob Fletcher (@jacobsfletch)
- Jarrod Flesch (@JarrodMFlesch)
- Jessica Chowdhury (@JessChowdhury)
Jun 25, 2024
v3.0.0-beta.54 (2024-06-25)

Features
- replace bloated deep-equal dependency and minimize usage of qs (#6912) (2920a5d)
- various type improvements (#6385) (ccbaee4)
- richtext-lexical: properly define client-only and server-only exports (#6890) (8f977b9)
- richtext-lexical: simplify creation of features (#6885) (d66b348)
Bug Fixes
- ui: standardizes named field exports (#6907) (776e3f7)
- payload, ui: sends cropped image pixel values to server instead of percent values (#6903) (e782d99)
- prevent dependency version checker finding node_modules outside the project (#6892) (7333706)
- update select options when the options prop changes (#6878) (8773e3a)
- adjusts json field defaultValue joi validation (#6873) (6ba619f)
- allow req mutation inside upload handlers (#6855) (62b1332)
BREAKING CHANGES
- various type improvements (#6385) (ccbaee4)
  
  Type narrowing for relationTo props on filterOptions, relationship fields and upload fields
  
  Type narrowing for arguments of lexical relationship, link and upload features
- ui: standardizes named field exports (#6907) (776e3f7)
Standardizes all named field exports. This improves semantics when using these components by appending Field onto the end of their names. Some components were already doing this, i.e. ArrayField and BlocksField. Now, all field components share this same convention. And since bundled components were already aliasing most exports in this way, this change will largely go unnoticed because most apps were already importing the correctly named components. What is ultimately means is that there was a mismatch between the unbundled vs bundled exports. This PR resolves that conflict. But this also introduces a potentially breaking change for your app. If your app is using components that import from the unbundled @payloadcms/ui package, those import paths likely changed:

Old:
```
import { Text } from '@payloadcms/ui/fields/Text'
```
New:
```
import { TextField } from '@payloadcms/ui/fields/Text'
```
If you were importing direcetly from the bundled version, you're imports likely have not changed. For example:

This still works (the import path is top-level, pointing to the bundled code):
```
import { TextField } from '@payloadcms/ui'
```
- richtext-lexical: properly define client-only and server-only exports (#6890) (8f977b9)
A bunch of exports have been moved around. There are now two of them: @payloadcms/richtext-lexical and @payloadcms/richtext-lexical/client. The root export is server-only. If any imports don't resolve anymore after this version, simply change the import to one of those, depending on if you are on the server or the client
- richtext-lexical: simplify creation of features (#6885) (d66b348)
  
  ServerFeature: ClientComponent has been renamed to ClientFeature
  
  ServerFeature: The nested serverFeatureProps has been renamed to sanitizedServerFeatureProps
  
  ServerFeature: The FeatureProviderProviderServer type now expects 3 generics instead of 2. We have split the props generic into sanitized & unsanitized props
  
  ClientFeature: The FeatureProviderProviderClient type now expects 2 generics instead of 1. We have split the props generic into sanitized & unsanitized props
  
  ClientFeature: The nested clientFeatureProps has been renamed to sanitizedClientFeatureProps
Contributors
- Alessio Gravili (@AlessioGr)
- James Mikrut (@jmikrut)
- Jacob Fletcher (@jacobsfletch)
- Patrik (@PatrikKozak)
- Jarrod Flesch (@JarrodMFlesch)
Jun 19, 2024
v3.0.0-beta.53 (2024-06-19)

Features
- richtext-lexical: make req available to html converters, use req.dataLoader instead of payload.findByID for upload node population (#6858) (285835f)
- rename @payloadcms/ui/client to @payloadcms/ui, and other auto-suggestion & exports improvements (#6848) (bc98567)
Bug Fixes
- fix all ui imports in our plugins, and get rid of ui subpath exports within monorepo (#6854) (aef2a52)
- cannot use empty strings defaultValue in text-like fields (#6847) (317bc07)
- ui: unflattening json objects containing keys with periods (#6839) (3ddc2a0)
BREAKING CHANGES
- rename @payloadcms/ui/client to @payloadcms/ui, and other auto-suggestion & exports improvements (#6848) (bc98567)
BREAKING: All @payloadcms/ui/client exports have been renamed to @payloadcms/ui. A simple find & replace across your entire project will be enough to migrate. This change greatly improves import auto-completions in IDEs which lack proper support for package.json exports, like Webstorm.

Contributors
- Alessio Gravili (@AlessioGr)
- Dan Ribbens (@DanRibbens)
- Elliot DeNolf (@denolfe)
- Patrik (@PatrikKozak)
Jun 18, 2024
v3.0.0-beta.52 (2024-06-18)

Features
- payload, richtext-lexical: runtime dependency checks (#6838) (bf374a2)
Bug Fixes
- payload: generated types issues (#6840) (cf50eab)
- templates: set correct minimum node version in package.json engines (#6835) (223d726)
Contributors
- James Mikrut (@jmikrut)
- Alessio Gravili (@AlessioGr)
Jun 18, 2024
v3.0.0-beta.51 (2024-06-18)

Bug Fixes
- ui: react-datepicker inserting invalid require("react") calls in our bundle (#6833) (b7d5a6a)
- generated template imports (#6832) (040893f)
- corrects permission access reading for disabling fields (#6815) (cedd916)
Contributors
- Alessio Gravili (@AlessioGr)
- Elliot DeNolf (@denolfe)
- Jarrod Flesch (@JarrodMFlesch)
Jun 17, 2024
v3.0.0-beta.50 (2024-06-17)

Bug Fixes
- richtext-*: do not use different version of faceless-ui by importing prebundled faceless-ui from ui (#6816) (35a5d0c)
- ui: basePath not handled for logout route (#6817) (47ee40a)
Contributors
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
Jun 17, 2024
v3.0.0-beta.49 (2024-06-17)

Features
- prebundle payload, ui, richtext-lexical (#6579) (9e76c8f)
🚧 BREAKING CHANGES
- prebundle payload, ui, richtext-lexical (#6579) (9e76c8f)
New file import locations

Exports from the payload package have been significantly cleaned up. Now, just about everything is able to be imported from payload directly, rather than an assortment of subpath exports. This means that things like import { buildConfig } from 'payload/config' are now just imported via import { buildConfig } from 'payload'. The mental model is significantly simpler for developers, but you might need to update some of your imports.

Payload now exposes only three exports:
1. payload - all types and server-only Payload code
2. payload/shared - utilities that can be used in either the browser or in Node environments
3. payload/node - heavy utilities that should only be imported in Node scripts and never be imported into bundled code like Next.js
UI library pre-bundling

With this release, we've dramatically sped up the compile time for Payload by pre-bundling our entire UI package for use inside of the Payload admin itself. There are new exports that should be used within Payload custom components:
1. @payloadcms/ui/client - all client components
2. @payloadcms/ui/server - all server components
For all of your custom Payload admin UI components, you should be importing from one of these two pre-compiled barrel files rather than importing from the more deeply nested exports directly. That will keep compile times nice and speedy, and will also make sure that the bundled JS for your admin UI is kept small.

For example, whereas before, if you imported the Payload Button, you would have imported it like this:
```
import { Button } from '@payloadcms/ui/elements/Button'
```
Now, you would import it like this:
```
import { Button } from '@payloadcms/ui/client'
```
This is a significant DX / performance optimization that we're pretty pumped about.

However, if you are importing or re-using Payload UI components outside of the Payload admin UI, for example in your own frontend apps, you can import from the individual component exports which will make sure that the bundled JS is kept to a minimum in your frontend apps. So in your own frontend, you can continue to import directly to the components that you want to consume rather than importing from the pre-compiled barrel files.

Individual component exports will now come with their corresponding CSS and everything will work perfectly as-expected.

Specific exports have changed
- '@payloadcms/ui/templates/Default' and '@payloadcms/ui/templates/Minimal' are now exported from '@payloadcms/next/templates'
- Some components are now more explicitly named while being exported, such as the LogOut icon. Old: import { LogOut } from '@payloadcms/ui/icons/LogOut' New: import { LogOutIcon } from '@payloadcms/ui/icons/LogOut'
Background info

In effort to make local dev as fast as possible, we need to import as few files as possible so that the compiler has less to process. One way we've achieved this in the Admin Panel was to remove all .scss imports from all components in the @payloadcms/ui module using a build process. This stripped all import './index.scss' statements out of each component before injecting them into dist. Instead, it bundles all of the CSS into a single main.css file, and we import that at the root of the app.

While this concept is still the right solution to the problem, this particular approach is not viable when using these components outside the Admin Panel, where not only does this root stylesheet not exist, but where it would also bloat your app with unused styles. Instead, we need to keep these .scss imports in place so they are imported directly alongside your components, as expected. Then, we need create a new build step that separately compiles the components without their stylesheets—this way your app can consume either as needed from the new client and server barrel files within @payloadcms/ui, i.e. from within @payloadcms/next and all other admin-specific packages and plugins.

This way, all other applications will simply import using the direct file paths, just as they did before. Except now they come with stylesheets.

And we've gotten a pretty awesome initial compilation performance boost.

Contributors
- James Mikrut (@jmikrut)
- Jacob Fletcher (@jacobsfletch)
- Alessio Gravili (@AlessioGr)
Jun 17, 2024
v3.0.0-beta.48 (2024-06-17)

Features
- prevent setting column preferences unless edited (#6774) (7c35e88)
Bug Fixes
- date hydration error if user locale is different to server (#6806) (a3e1856)
- richtext-lexical: lexicalHTML field was persisted in database even though it should not (#6795) (6612bd1)
- loader windows path resolution (#6804) (ce2ae95)
- prevent clearing of language selection on account view (#6803) (1a03e9a)
- ui,richtext-*: path from context should always have precedence over path from props, even if it's an empty string (#6782) (e7159c0)
- ui: properly type Select element onChange type, as well as any components using it (#6785) (6287495)
- array row validation messages (#6781) (0920c8a)
- allows navigation to reset-pw route, adds customization for route (#6778) (680ed1d)
- passes toast success and error handlers to form handleResponse fn (#6775) (ddc3ab5)
Contributors
- Jacob Fletcher (@jacobsfletch)
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
- Dan Ribbens (@DanRibbens)
- Jarrod Flesch (@JarrodMFlesch)
Jun 13, 2024
v3.0.0-beta.47 (2024-06-13)

Features
- adds X-HTTP-Method-Override header (#6487) (7bb2e3b)
- plugin-stripe: add full req object to stripe webhook handlers (#6770) (78db50a)
- use Gravatar for default avatar (#6765) (11de4b0)
- warn if image resizing enabled but sharp is not passed to config (#6763) (ed0820f)
Bug Fixes
- adds translation for authentication:apiKey (#6771) (f36bf5e)
- attempt to use user locale preference when not set as query param (#6761) (082650c)
- adds siteName to openGraphSchema joi validation (#6764) (0162560)
- payload, ui: unable to save animated file types with undefined image sizes (#6757) (e148243)
- meta.icons type and schema validation (#6759) (8e56328)
BREAKING CHANGES
- use Gravatar for default avatar (#6765) (11de4b0)
Makes Gravatar the default
- meta.icons type and schema validation (#6759) (8e56328)
Contributors
- Anders Semb Hermansen (@andershermansen)
- Paul (@paulpopus)
- Jarrod Flesch (@JarrodMFlesch)
- Elliot DeNolf (@denolfe)
- Viet-Tien (@nvti)
- Patrik (@PatrikKozak)
- Jacob Fletcher (@jacobsfletch)
Jun 12, 2024
v3.0.0-beta.46 (2024-06-12)

Features
- diff generated types before write (#6749) (be0462d)
- richtext-lexical: sub-field hooks and localization support (#6591) (4e12705)
Bug Fixes
- corrects block duplicate action and add tests (#6589) (763a34f)
- unawaited emails (#6265) (6e55a2e)
- ui: hideGutter was ignored in group field (#6613) (de45e60)
- add missing export for useLeaf hook (#6693) (74159de)
- list sort preferences (#6731) (ba92d86)
BREAKING CHANGES
- richtext-lexical: sub-field hooks and localization support (#6591) (4e12705)
BREAKING

Our internal field hook methods now have new required schemaPath and path props. This affects the following functions, if you are using those: afterChangeTraverseFields, afterReadTraverseFields, beforeChangeTraverseFields, beforeValidateTraverseFields, afterReadPromise

The afterChange field hook's value is now the value AFTER the previous hooks were run. Previously, this was the original value, which I believe is a bug

Only relevant if you have built your own richText adapter: the richText adapter populationPromises property has been renamed to graphQLPopulationPromises and is now only run for graphQL. Previously, it was run for graphQL AND the rest API. To migrate, use hooks.afterRead to run population for the rest API

Only relevant if you have built your own lexical features: The populationPromises server feature property has been renamed to graphQLPopulationPromises and is now only run for graphQL. Previously, it was run for graphQL AND the rest API. To migrate, use hooks.afterRead to run population for the rest API

Serialized lexical link and upload nodes now have a new id property. While not breaking, localization / hooks will not work for their fields until you have migrated to that. Re-saving the old document on the new version will automatically add the id property for you. You will also get a bunch of console logs for every lexical node which is not migrated
Contributors
- Jessica Chowdhury (@JessChowdhury)
- Elliot DeNolf (@denolfe)
- Alessio Gravili (@AlessioGr)
- Anders Semb Hermansen (@andershermansen)
- Patryk Kowalczyk (@Patryk-Kowalczyk)
- Jarrod Flesch (@JarrodMFlesch)
Jun 11, 2024
v3.0.0-beta.45 (2024-06-11)

Features
- move from react-toastify to sonner (#6682) (cb3355b)
Bug Fixes
- toasts padding and button placement by 1px (#6730) (2ada6fc)
- only use metadata.pages for height if animated (#6728) (10c6ffa)
- create sharp file for fileHasAdjustments files or fileIsAnimated files (#6708) (6512d5c)
- corrects field-paths that were incorrectly being set (#6724) (57fcc91)
BREAKING CHANGES
- move from react-toastify to sonner (#6682) (cb3355b)
We now export toast from sonner instead of react-toastify. If you send out toasts from your own projects, make sure to use our toast export, or install sonner. React-toastify toasts will no longer work anymore. The Toast APIs are mostly similar, but there are some differences if you provide options to your toast

CSS styles have been changed from Toastify

/* before */ .Toastify /* current */ .payload-toast-container .payload-toast-item .payload-toast-close-button /* individual toast items will also have these classes depending on the state */ .toast-info .toast-warning .toast-success .toast-error

https://github.com/payloadcms/payload/assets/70709113/da3e732e-aafc-4008-9469-b10f4eb06b35
Contributors
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Jarrod Flesch (@JarrodMFlesch)
Jun 11, 2024
v3.0.0-beta.44 (2024-06-11)

Features
- type auto-generation (#6657) (7309d47)
Bug Fixes
- get auto type-gen to work on turbo, by running type gen in a child process outside turbo/webpack (#6714) (7b7dc71)
- corrects tab paths when nested within other row like fields (#6712) (ba513d5)
- re-exports graphql json types for external use (#6711) (a26d031)
- ui: removes array & blocks & group fields from sort (#6576) (9f52562)
- global draft validations (#6709) (45e8683)
- ui: set checkbox htmlFor by default, fixing some checkbox labels not toggling the checkbox (#6684) (ac34380)
BREAKING CHANGES
- type auto-generation (#6657) (7309d47)
Types are now auto-generated by default.

You can opt-out of this behavior by setting:

buildConfig({ // Rest of config typescript: { autoGenerate: false }, })
Contributors
- Alessio Gravili (@AlessioGr)
- Jarrod Flesch (@JarrodMFlesch)
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
- Jacob Fletcher (@jacobsfletch)
Jun 7, 2024
v3.0.0-beta.43 (2024-06-07)

Features
- adds draft validation option (#6677) (52c81ad)
- plugin-redirects: update fields overrides to use a function (#6675) (e4a9029)
- richtext-*: allow omitting the root editor property (#6660) (11c3a65)
- upgrade minimum node 20 version from 20.6.0 to 20.9.0 (#6659) (9bd9e7a)
Bug Fixes
- next: live preview device position when using zoom (#6665) (7c8d562)
- max versions config not being respected on globals (#6654) (8dd5e4d)
BREAKING CHANGES
- plugin-redirects: update fields overrides to use a function (#6675) (e4a9029)
Description

Updates the fields override in plugin redirects to allow for overriding

// before overrides: { fields: [ { type: 'text', name: 'customField', }, ], }, // current overrides: { fields: ({ defaultFields }) => { return [ ...defaultFields, { type: 'text', name: 'customField', }, ] }, },
- upgrade minimum node 20 version from 20.6.0 to 20.9.0 (#6659) (9bd9e7a)
This bumps the minimum required node version from node 20.6.0 to node 20.9.0. This is because 20.6.0 breaks type generation due to a CJS node bug, and 20.9.0 is the next v20 LTS version. The minimum node 18 version stays the same (18.20.2)
Contributors
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
- Jacob Fletcher (@jacobsfletch)
- Alessio Gravili (@AlessioGr)
Jun 6, 2024
v3.0.0-beta.42 (2024-06-06)

Bug Fixes
- ui: global documents disabled after save (#6652) (267c236)
Contributors
- Jacob Fletcher (@jacobsfletch)
- Alessio Gravili (@AlessioGr)
Jun 5, 2024
v3.0.0-beta.41 (2024-06-05)

Features
- support Next.js basePath config property (#6628) (b2751f7)
- ui: expose RowLabelProps (#6627) (1afd221)
- richtext-lexical: upgrade lexical from 0.15.0 to 0.16.0 and port over relevant playground changes (#6620) (da35afb)
Bug Fixes
- db-postgres: create predefined migration missing json schema output (#6641) (ff82bb5)
- update file-type dependency and fix dependency version mismatch (#6638) (2077da8)
- translations: explicitly declare date-fns v3 as a dependency (#6626) (aeb4df8)
- resizing animated images (#6623) (bcd277e)
- migration file cannot be imported (#6616) (cafc13a)
BREAKING CHANGES
- db-postgres: create predefined migration missing json schema output (#6641) (ff82bb5)
Fixes #6630

This only applies to you if you using db-postgres and have created the v2-v3-relationships migration released in v3.0.0-beta.39 from @payloadcms/db-postgres <= v3.0.0-beta.40.

Steps to fix

Delete the existing v2-v3-relationships migration file.

If changes were made to your config since the previous migration was made, you will need to revert those by checking out a previous commit in your version control.

Recreate the migration using payload migrate:create --file @payloadcms/db-postgres/relationships-v2-v3 to make the migration with the snapshot .json file.
- richtext-lexical: upgrade lexical from 0.15.0 to 0.16.0 and port over relevant playground changes (#6620) (da35afb)
BREAKING:

This upgrades the required version of lexical from 0.15.0 to 0.16.0. If you are using lexical directly in your project, possibly due to custom features, there might be breaking changes for you. Please consult the lexical 0.16.0 changelog: https://github.com/facebook/lexical/releases/tag/v0.16.0
Contributors
- Dan Ribbens (@DanRibbens)
- Alessio Gravili (@AlessioGr)
- Elliot DeNolf (@denolfe)
- Jacob Fletcher (@jacobsfletch)
- Patrik (@PatrikKozak)
- Paul (@paulpopus)
Jun 4, 2024
v3.0.0-beta.40 (2024-06-04)

Features
- match next.js env file loading behavior in bin scripts & importConfig, clean up installed packages & mismatching package versions (#6601) (59cde0d)
- richtext-lexical: configurable fixed toolbar (#6560) (f41bb05)
Bug Fixes
- pin ajv to 8.14.0, as 8.15.0 is broken (#6606) (45b02d8)
- plugin-form-builder: fix bug with optional chain operator in field overrides logic (#6602) (1aece39)
- db-postgres: type issue in migratePostgresV2toV3 call if ts strict mode is enabled (#6585) (c3589de)
- richtext-lexical: minor design improvements (#6575) (c7fbd76)
- critical getPredefinedMigration dependency error (#6578) (6b9c796)
- richtext-*: fix client features were not loaded properly, improve performance of LexicalProvider, slate cell component was non-functional, support richtext adapter Cell RSCs (#6573) (5cb49c3)
BREAKING CHANGES
- richtext-lexical: configurable fixed toolbar (#6560) (f41bb05)
BREAKING: useEditorFocusProvider has been removed and merged with useEditorConfigContext. You can now find information about the focused editor, parent editors and child editors within useEditorConfigContext

Contributors
- Alessio Gravili (@AlessioGr)
- Paul (@paulpopus)
May 30, 2024
v3.0.0-beta.39 (2024-05-30)

Features
- db-postgres: relationship column (#6339) (edfa85b)
Bug Fixes
- next: ssr live preview was not dispatching document save events (#6572) (e603c83)
BREAKING CHANGES 💥
- db-postgres: relationship column (#6339) (edfa85b)
Moves upload field and relationship fields with hasMany: false & relationTo: string from the many-to-many _rels join table to simple columns. This only affects Postgres database users.

TL;DR

We have dramatically simplified the storage of simple relationships in relational databases to boost performance and align with more expected relational paradigms. If you are using the beta Postgres adapter, and you need to keep simple relationship data, you'll need to run a migration script that we provide you.

Background

For example, prior to this update, a collection of "posts" with a simple hasMany: false and relationTo: 'categories' field would have a posts_rels table where the category relations would be stored.

This was somewhat unnecessary as simple relations like this can be expressed with a category_id column which is configured as a foreign key. This also introduced added complexity for dealing directly with the database if all you have are simple relations.

Who needs to migrate

You need to migrate if you are using the beta Postgres database adapter and any of the following applies to you.
- If you have versions enabled on any collection / global
- If you use the upload field
- If you have relationship fields that are hasMany: false (default) and relationTo to a single category (has one) relations
We have a migration for you

Even though the Postgres adapter is in beta, we've prepared a predefined migration that will work out of the box for you to migrate from an earlier version of the adapter to the most recent version easily.

It makes the schema changes in step with actually moving the data from the old locations to the new before adding any null constraints and dropping the old columns and tables.

How to migrate

The steps to preserve your data while making this update are as follows. These steps are the same whether you are moving from Payload v2 to v3 or a previous version of v3 beta to the most recent v3 beta.

Important: during these steps, don't start the dev server unless you have push: false set on your Postgres adapter.

⚠️ Step 1 - backup

Always back up your database before performing big changes, especially in production cases.

⚠️ Step 2 - create a pre-update migration

Before updating to new Payload and Postgres adapter versions, run payload migrate:create without any other config changes to have a prior snapshot of the schema from the previous adapter version

⚠️ Step 3 - if you're migrating a dev DB, delete the dev push row from your payload_migrations table

If you're migrating a dev database where you have the default setting to push database changes directly to your DB, and you need to preserve data in your development database, then you need to delete a dev migration record from your database.

Connect directly to your database in any tool you'd like and delete the dev push record from the payload_migrations table using the following SQL statement:
```
DELETE FROM payload_migrations where batch = -1
```
⚠️ Step 4 - update Payload and Postgres versions to most recent

Update packages, making sure you have matching versions across all @payloadcms/* and payload packages (including @payloadcms/db-postgres)

⚠️ Step 5 - create the predefined migration

Run the following command to create the predefined migration we've provided:
```
payload migrate:create --file @payloadcms/db-postgres/relationships-v2-v3
```
⚠️ Step 6 - migrate!

Run migrations with the following command:
```
payload migrate
```
Assuming the migration worked, you can proceed to commit this change and distribute it to be run on all other environments.

Note that if two servers connect to the same database, only one should be running migrations to avoid transaction conflicts.

Related discussion: https://github.com/payloadcms/payload/discussions/4163

Contributors
- Elliot DeNolf (@denolfe)
- Dan Ribbens (@DanRibbens)
- Jacob Fletcher (@jacobsfletch)
May 30, 2024
v3.0.0-beta.38 (2024-05-30)

Features
- next,ui: improves loading states (#6434) (92f458d)
- extracts buildFormState logic from endpoint for reuse (#6501) (321e97f)
Bug Fixes
- cpa: safer command exists check (#6569) (4884f0d)
- ui: adjusts sizing of remove/add buttons to be same size (#6529) (f1db24e)
- ui field validation error with admin.disableListColumn property (#6531) (7f15147)
- translations: adds new userEmailAlreadyRegistered translations (#6550) (e0a6db7)
- cpa: more package manager detection improvements (#6566) (0d7d3e5)
- duplicate options appearing in relationship where builder (#6557) (3474642)
- plugin-search: Render error on custom UI component (#6562) (aa02801)
- ensure relationship field pills respect isSortable property (#6561) (425576b)
- ability to query relationships not equal to ID (#6555) (043a91d)
Contributors
- Elliot DeNolf (@denolfe)
- Patrik (@PatrikKozak)
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
- Jessica Chowdhury (@JessChowdhury)
- Jacob Fletcher (@jacobsfletch)
May 29, 2024
v3.0.0-beta.37 (2024-05-29)

Features
- richtext-lexical: link markdown transformers (#6543) (33d5312)
- richtext-lexical: i18n (#6542) (a8000f6)
- plugin-form-builder: update form builder plugin field overrides to use a function instead (#6497) (7d0e909)
- cpa: update existing payload installation (#6193) (10c94b3)
- richtext-lexical: i18n support (#6524) (c383f39)
- richtext-lexical: update validation of custom URLs to include relative and anchor links (#6525) (8a91a7a)
Bug Fixes
- cpa: improve package manager detection (#6546) (8506385)
- multi value draggable/sortable pills (#6500) (e749529)
- richtext-lexical: various html converter fixes (#6544) (4a51f4d)
- richtext-lexical: user-defined html converters not taking precedence, and shared default html converters doubling in size after every field initialization (2c283bc)
- richtext-lexical: list converters and nodes being added duplicatively (a2e9bcd)
- richtext-lexical: link html converter: serialize newTab to target="_blank" (#6350) (e0b201c)
- deps: proper location for scheduler peer dep (#6537) (2ddd50e)
- Add missing He lang export in payload/i18n (#6484) (6f5d86e)
- next: unable to pass custom view client components (#6513) (eff5129)
- separate collection docs with same ids were excluded in selectable (#6499) (18bc4b7)
- richtext-lexical: localized sub-fields were omitted from the API output (#6489) (7a76814)
- ui: where builder issues (#6478) (42222cd)
BREAKING CHANGES
- plugin-form-builder: update form builder plugin field overrides to use a function instead (#6497) (7d0e909)
Changes the fields override for form builder plugin to use a function instead so that we can actually override existing fields which currently will not work.

//before fields: [ { name: 'custom', type: 'text', } ] // current fields: ({ defaultFields }) => { return [ ...defaultFields, { name: 'custom', type: 'text', }, ] }
Contributors
- Elliot DeNolf (@denolfe)
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
- Leo Hilsheimer (@linobino1)
- Paul (@paulpopus)
- zvizvi (@zvizvi)
- Dan Ribbens (@DanRibbens)
- Patrik (@PatrikKozak)
May 23, 2024
v3.0.0-beta.36 (2024-05-23)

Features
- next.js 15, react 19, react compiler support (#6429) (35f961f)
- add website template (#6470) (85bfca7)
- ui: split up Select component into Select and SelectInput (#6471) (661a4a0)
- richtext-lexical: various UX and performance improvements (#6467) (78579ed)
- richtext-lexical: improve block dragging UX (6b45cf3)
- next: server-side theme detection (#6452) (1fe9790)
- translations: add Hebrew translation (#6428) (3c0853a)
- richtext-lexical: various gutter, error states & add/drag handle improvements (#6448) (6c95287)
Bug Fixes
- adds host to initPage req creation (#6476) (72c0534)
- isHotkey webpack error (#6466) (73d0b20)
- richtext-lexical: order of add/drag handles was inconsistent between gutter and no-gutter mode (c93752b)
- ui: field errors aren't red in light mode (7a4dd58)
- next,ui: fixes global doc permissions and optimizes publish access data loading (#6451) (2b941b7)
- richtext-lexical: link drawer sending too many form state requests for actions unrelated to links (0bfbf9c)
- ui: disableListColumn fields not hidden in table columns (#6445) (bcc506b)
BREAKING CHANGES
- next.js 15, react 19, react compiler support (#6429) (35f961f)
BREAKING:

bumps minimum required next.js version from 14.3.0-canary.68 to 15.0.0-rc.0

bumps minimum required react and react-dom versions to 19.0.0 (19.0.0-rc-f994737d14-20240522 should be used)

@types/react and @types/react-dom have to be bumped to npm:types-react@19.0.0-beta.2 using overrides and pnpm overrides, if you want correct types. You can find an example of this here: https://github.com/payloadcms/payload/pull/6429/files#diff-10cb9e57a77733f174ee2888587281e94c31f79e434aa3f932a8ec72fa7a5121L32

Issues

Bunch of todos for our react-select package which is having type issues. Works fine, just type issues. Their type defs are importing JSX in a weird way, we likely just have to wait until they fix them in a future update.
- ui: uses consistent button naming conventions (#6444) (af7e12a)
Description

Renames the Save to SaveButton, etc. to match the already established convention of the PreviewButton, etc. This matches the imports with their respective component and type names, and also gives these components more context to the developer whenever they're rendered, i.e. its clearly just a button and not an entire block or complex component.

BREAKING:

Import paths for these components have changed, if you were previously importing these components into your own projects to customize, change the import paths accordingly:

Old:

import { PublishButton } from '@payloadcms/ui/elements/Publish' import { SaveButton } from '@payloadcms/ui/elements/Save' import { SaveDraftButton } from '@payloadcms/ui/elements/SaveDraft'

New:

import { PublishButton } from '@payloadcms/ui/elements/PublishButton' import { SaveButton } from '@payloadcms/ui/elements/SaveButton' import { SaveDraftButton } from '@payloadcms/ui/elements/SaveDraftButton'

[x] I have read and understand the CONTRIBUTING.md document in this repository.
Contributors
- Alessio Gravili (@AlessioGr)
- Paul (@paulpopus)
- Jarrod Flesch (@JarrodMFlesch)
- Elliot DeNolf (@denolfe)
- Jacob Fletcher (@jacobsfletch)
- zvizvi (@zvizvi)
- Patrik (@PatrikKozak)
May 21, 2024
v3.0.0-beta.35 (2024-05-21)

Features
- store focal point on uploads (#6436) (36fda30)
Bug Fixes
- user verification email broken (#6442) (23f9a32)
- ui: blocks browser save dialog from opening when hotkey used with no changes (#6366) (0190eb8)
- separate sort and search fields when looking up relationship. (#6440) (f482fdc)
- ui: tooltip positioning issues (#6439) (ed47661)
- ui: update relationship cell formatted value when when search changes (#6208) (e682cb1)
- richtext-lexical: field required validation not working if content was removed manually (#6435) (fa7cc37)
- attributes graphql packages, adds esm import path (#6431) (1d81eef)
- plugin-seo: white screen of death on choosing an existing media for meta image (#6424) (8fcfac6)
BREAKING CHANGES
- export DefaultListView as ListView (#6432) (a8a2dc2)
Change the exports of DefaultListView and DefaultEditView to be renamed without "Default" as ListView

// before import { DefaultEditView } from '@payloadcms/next/views' import { DefaultListView } from '@payloadcms/next/views' // after import { EditView } from '@payloadcms/next/views' import { ListView } from '@payloadcms/next/views'
Contributors
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
- Jessica Chowdhury (@JessChowdhury)
- Anders Semb Hermansen (@andershermansen)
- Ritsu (@r1tsuu)
- Elliot DeNolf (@denolfe)
- Jarrod Flesch (@JarrodMFlesch)
May 17, 2024
v3.0.0-beta.34 (2024-05-17)

Bug Fixes
- page metadata generation not working in turbopack (#6417) (147b50e)
Contributors
- Alessio Gravili (@AlessioGr)
May 17, 2024
v3.0.0-beta.33 (2024-05-17)

Features
- richtext-lexical: new aboveContainer and belowContainer plugin positioning options, fix incorrect placeholder positioning (#6410) (bf106db)
- upgrade minimum next version to 14.3.0-canary.68 & upgrade react packages, react-toastify (#6387) (9d5c0d3)
- allow client components and extra rsc props for custom edit and list views (#6395) (2762131)
- replaces admin.meta.ogImage with admin.meta.openGraph.images (#6227) (9556d1b)
- richtext-lexical: upgrade lexical from 0.14.5 to 0.15.0 (#6371) (fbea524)
- richtext-lexical: upgrade lexical from 0.14.5 to 0.15.0 and ensure peerDependencies force correct lexical version (22480a7)
Bug Fixes
- db-postgres: uuid custom db name (#6408) (c2571cf)
- db-postgres: query with like on id columns (#6414) (12c812d)
- ui: properly sets hasSavePermission on nested documents (#6394) (1800934)
- component is undefined error within isReactServerComponentOrFunction (#6411) (89b6055)
- turbopack RSC detection (#6405) (4dedd6e)
- next: removes initPage export from barrel file (#6403) (553bb4b)
- loader support for server-only (#6383) (5083525)
- react-select menu is hidden behind lexical fixed toolbar (#6396) (5323d76)
- richtext-lexical: upload, relationship and block node insertion fails sometimes (6083870)
- next: incorrect stepnav breadcrumbs after selecting existing upload (#6372) (a4deaf0)
- next: does not wrap custom views with template by default (#6379) (4adf01a)
- translations: type StripCountVariants not working in TS strict mode (#6374) (1abcdf9)
- safely access cookie header for uploads (#6373) (fbad39a)
- db-postgres: filter with ID not_in AND queries (#6359) (e8d1d36)
- loader throwing errors for client files imported using TS paths (#6369) (cb9a20f)
- richtext-lexical: autoLink node styles not inherited from original text node on creation (8db9664)
- multiselect relationship bug and improve accessibility (#6286) (5a4074e)
BREAKING CHANGES
- upgrade minimum next version to 14.3.0-canary.68 & upgrade react packages, react-toastify (#6387) (9d5c0d3)
BREAKING:

The minimum required next version is now 14.3.0-canary.68. This is because we are migrating away from the deprecated experimental.serverComponentsExternalPackages next config key to experimental.serverExternalPackages, which is not available in older next canaries

The minimum react and react-dom versions have been bumped to ^18.2.0 or ^19.0.0. This matches the minimum react version recommended by next
- next: removes initPage export from barrel file (#6403) (553bb4b)
- replaces admin.meta.ogImage with admin.meta.openGraph.images (#6227) (9556d1b)
- remove unused staticOptions config on uploads (#6378) (a6bf058)
Removes the unused staticOptions on upload config, it was previously typed to express configuration and is unused anywhere in the codebase
- richtext-lexical: upgrade lexical from 0.14.5 to 0.15.0 (#6371) (fbea524)
BREAKING: This upgrades all lexical packages from 0.14.5 to 0.15.0. If there are any breaking changes within lexical, this could break your project if you use lexical APIs directly (e.g. in custom features). We have not noticed any breaking changes within core. Please consult their changelog: https://github.com/facebook/lexical/releases/tag/v0.15.0"
- richtext-lexical: upgrade lexical from 0.14.5 to 0.15.0 and ensure peerDependencies force correct lexical version (22480a7)
Contributors
- James Mikrut (@jmikrut)
- Dan Ribbens (@DanRibbens)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Francis Turmel (@fturmel)
- Elliot DeNolf (@denolfe)
- Paul (@paulpopus)
- Patrik (@PatrikKozak)
- Jarrod Flesch (@JarrodMFlesch)
- Jessica Chowdhury (@JessChowdhury)
May 14, 2024
3.0.0-beta.32 (2024-05-14)

Features
- richtext-lexical: add rootFeatures prop to lexicalEditor (#6360) (c8a1cca)
- add missing server-only props to custom RSCs, improve req.user type, clean-up ui imports (#6355) (79f4907)
- consolidates admin.logoutRoute and admin.inactivityRoute into admin.routes (#6354) (6a0fffe)
Bug Fixes
- graphql: threads through correct draft value for upload relations (#6235) (6e116a7)
BREAKING CHANGES
- add missing server-only props to custom RSCs, improve req.user type, clean-up ui imports (#6355) (79f4907)
Previously, we were only passing payload to RSCs. Now, we are passing the following props for component rendered outside buildComponentMap:

i18n,

locale,

params,

payload,

permissions,

searchParams,

user

And the following props for components rendered within buildComponentMap:

i18n,

payload,

Breaking:

if you use the following components in your own project, these now require aforementioned additional, server-only props, instead of just the payload prop:

Account view

Default Dashboard view

DefaultTemplate

WithServerSideProps

RenderCustomComponent (optional)

Logo
Additionally, if you were using an HOC as a custom component, and the HOC passed props to the client component, you now have to filter out the additional server-only props we provide. You can use our withMergedProps helper, which filters them automatically, >or mark your HOC with 'use client'.
- consolidates admin.logoutRoute and admin.inactivityRoute into admin.routes (#6354) (6a0fffe)
The admin.logoutRoute and admin.inactivityRoute properties have been consolidated into a single admin.routes property. To migrate, simply move those two keys as follows:

Old way:

// payload.config.ts { // ... admin: { logoutRoute: '/custom-logout', inactivityRoute: '/custom-inactivity' } }

New way:

// payload.config.ts { // ... admin: { routes: { logout: '/custom-logout', inactivity: '/custom-inactivity' } } }
Contributors
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Jarrod Flesch (@JarrodMFlesch)
May 14, 2024
3.0.0-beta.31 (2024-05-14)

Features
- typed i18n (#6343) (f716122)
- replaces admin.favicon with admin.icons (7438812)
- ui: exports png favicons (7e4f50a)
- cpa: initialize git repo on project creation (#6342) (40d3078)
- adds translations for API view and select component (#6143) (b3df253)
Bug Fixes
- ui: step-nav breadcrumbs ellipsis (#6344) (353c2b0)
- collection labels with multiple locales showing incorrectly (#5998) (58bbbbd)
- depth field in api view throws error when no value present (#6106) (fcee13b)
- implements graphql schema generation (#6254) (3abc2e8)
- next: replaces default svg favicons with png (a48043c)
- named tab being required in generated types without any required fields (#6324) (aa5ad47)
- payload: loader alias issues (#6341) (890c21d)
- ui: properly adds readOnly styles to disabled radio fields (#6240) (c7635b2)
- db-postgres: too many clients already, cannot read properties 'transaction' of undefined (#6338) (47cd5f4)
- some custom components were not handled properly if they are RSCs (#6315) (0d98b4b)
- wrong translation key being used as upload:Sizes instead of upload:sizes (#6323) (2f02b3a)
BREAKING CHANGES
- typed i18n (#6343) (f716122)
BREAKING: all i18n functions are now strongly typed, which will create errors if you have custom translations. If you do, you will have to pass a generic to i18n containing the types of your custom translations

Example of adding your own translations to the default translations type on the client:

const linkTranslations = { en: { lexical: { link: { custom: 'Custom', internal: 'Internal', }, }, }, } type LinkTranslationKeys = NestedKeysStripped<typeof linkTranslations.en> type MyI18n = I18nClient<typeof linkTranslations.en, LinkTranslationKeys> const myI18n: MyI18n myI18n.t('lexical:link:custom') // custom translations have been ADDED to the default client translations

Example for the useTranslation hook within a component:

const linkTranslations = { en: { lexical: { link: { custom: 'Custom', internal: 'Internal', }, }, }, } type LinkTranslationKeys = NestedKeysStripped<typeof linkTranslations.en> export const MyComponent: React.FC = () => { const { i18n, t } = useTranslation<typeof linkTranslations.en, LinkTranslationKeys>() return t('lexical:link:custom') }
- replaces admin.favicon with admin.icons (#6347) (f603924)
The admin.favicon: string property has been succeeeded by admin.icons: string | Icons | Icon[]. See nextjs.org/docs/app/api-reference/functions/generate-metadata#icons for full details.
- some custom components were not handled properly if they are RSCs (#6315) (0d98b4b)
Breaking: The following, exported components now need the payload object as a prop rather than the config object:

RenderCustomComponent (optional)

Logo

DefaultTemplate

DefaultNav
Contributors
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Jessica Chowdhury (@JessChowdhury)
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
- James Mikrut (@jmikrut)
- Fredrik (@Livog)
May 10, 2024
3.0.0-beta.30 (2024-05-10)

Features
- storage-uploadthing package (#6316) (ed880d5)
- payload, ui: adds disableListColumn & disableListFilter to fields admin props (#6238) (ea84e82)
Bug Fixes
- richtext-slate: list item values returning null (#6291) (4216d69)
- ui: appends editDepth value to radio & checkbox IDs when inside drawer (#6252) (dcad500)
- next: respect fallback locale null value (#6207) (e96ff90)
Contributors
- Elliot DeNolf (@denolfe)
- Patrik (@PatrikKozak)
- Paul (@paulpopus)
- Ritsu (@r1tsuu)
May 9, 2024
3.0.0-beta.29 (2024-05-09)

Features
- fix non-functional custom RSC component handling, separate label and description props, fix non-functional label function handling (#6264) (cfeac79)
Bug Fixes
- plugin-form-builder: resolve labelValue from LabelFunction (#5817) (5065322)
- plugin-form-builder: export types correctly (#6287) (ad4796c)
- templates: yarn install broken for new template installs (#6283) (3785c79)
- templates: blank-3.0: pin next version, as it was breaking new installs (#6281) (9364f8d)
BREAKING CHANGES
- fix non-functional custom RSC component handling, separate label and description props, fix non-functional label function handling (#6264) (cfeac79)
Breaking Changes:

Globals config: admin.description no longer accepts a custom component. You will have to move it to admin.components.elements.Description

Collections config: admin.description no longer accepts a custom component. You will have to move it to admin.components.edit.Description

All Fields: field.admin.description no longer accepts a custom component. You will have to move it to field.admin.components.Description

Collapsible Field: field.label no longer accepts a custom component. You will have to move it to field.admin.components.RowLabel

Array Field: field.admin.components.RowLabel no longer accepts strings or records

If you are using our exported field components in your own app, their labelProps property has been stripped down and no longer contains the label and required prop. Those can now only be configured at the top-level
Contributors
- Alessio Gravili (@AlessioGr)
- Elliot DeNolf (@denolfe)
- Jacob Fletcher (@jacobsfletch)
- David Velasco (@davelsan)
- Paul (@paulpopus)
- Jarrod Flesch (@JarrodMFlesch)
May 8, 2024
3.0.0-beta.27 (2024-05-08)

Features
- release live-preview and live-preview-react
- ui: toggle sortable arrays and blocks (#6008) (4c6aaaf)
Contributors
- Kendell Joseph (@kendelljoseph)
- Elliot DeNolf (@denolfe)
May 8, 2024
3.0.0-beta.26 (2024-05-08)

Features
- ssr live preview (#6239) (731f023)
- improves crop rendering in thumbnail (#6260) (a7ac5ef)
- richtext-lexical: strongly typed PluginComponent types, remove LexicalBlocks, improve exports, fix e2e (#6255) (8e55a2a)
- richtext-lexical: improve draggable block indicator style and animations (f5fb095)
- richtext-lexical: add maxDepth property to various lexical features (#6242) (721919f)
Bug Fixes
- richtext-lexical: various UX improvements (#6241) (0f306da)
- richtext-lexical: fixed toolbar actions not ensuring editor focus, various link editor selection issues (ba9ea5c)
- richtext-lexical: fixed toolbar not wrapping correctly on small screen sizes (53b7d6f)
- properly extracts fallbackLang (#6237) (ac5d744)
- richtext-lexical: ensure inline toolbar is positioned between link editor and fixed toolbar (b94a265)
- richtext-lexical: text within relationship and upload node components was not able to be selected without selection resetting immediately (1ba3a92)
- richtext-lexical: inline editor is overlapping the clickable link editor for the first line (9814fd7)
- richtext-lexical: floating link editor did not properly hide if selection is not a range selection (20455f4)
BREAKING CHANGES
- richtext-lexical: strongly typed PluginComponent types, remove LexicalBlocks, improve exports, fix e2e (#6255) (8e55a2a)
BREAKING:

Narrows the type of the plugins prop of lexical features. Client props are now also automatically provided to the plugin components. To migrate, type your plugin as either PluginComponent or PluginComponentWithAnchor.

BlockQuoteFeature has been renamed to BlockquoteFeature

createClientComponent is now exported only from /components

The LexicalBlocks and FieldWithRichTextRequiredEditor types have been removed in favor of just Blocks & Fields, as well as improved validation.
- plugin-stripe: disables rest proxy by default (#6230) (e1ff92e)
Contributors
- Jacob Fletcher (@jacobsfletch)
- Elliot DeNolf (@denolfe)
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
May 6, 2024
3.0.0-beta.25 (2024-05-06)

Features
- translations: add Slovak translation (#6114) (d3bca57)
- richtext-lexical: add FixedToolbarFeature (#6192) (c462bf2)
```
editor: lexicalEditor({
  features: ({ defaultFeatures }) => [
    ...defaultFeatures,
    FixedToolbarFeature(),
  ],
}),
```
Bug Fixes
- threads draft arg through for child resolvers in GraphQL queries (#6196) (51149c7)
- plugin-form-builder: custom formSubmission hooks overriding core ones (#6204) (8a452c4)
BREAKING CHANGES
- plugin-stripe: add types exports and rename types to be more consistent with other plugins (#6216) (7f72006)
Some minor type renaming for consistency with other packages.
- richtext-lexical: add FixedToolbarFeature (#6192) (c462bf2)
BREAKING:

The default inline toolbar has now been extracted into an InlineToolbarFeature. While it's part of the defaultFeatures, you might have to add it to your editor features if you are not including the defaultFeatures and still want to keep the inline toolbar (floating toolbar)

Some types have been renamed, e.g. InlineToolbarGroup is now ToolbarGroup, and InlineToolbarGroupItem is now ToolbarGroupItem

The displayName property of SlashMenuGroup and SlashMenuItem has been renamed to label to match the label prop of the toolbars

The inlineToolbarFeatureButtonsGroupWithItem, inlineToolbarFormatGroupWithItems and inlineToolbarTextDropdownGroupWithItems exports have been renamed to toolbarTextDropdownGroupWithItems, toolbarFormatGroupWithItems, toolbarFeatureButtonsGroupWithItems
Contributors
- Elliot DeNolf (@denolfe)
- Paul (@paulpopus)
- Jarrod Flesch (@JarrodMFlesch)
- Friggo (@MrFriggo)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
May 3, 2024
3.0.0-beta.24 (2024-05-03)

Features
- next: supports custom login redirects in initPage (#6186) (ea917dd)
- richtext-lexical: finalize ClientFeature interface (#6191) (7ab156e)
Bug Fixes
- cascade graphql locales through relationships (#6166) (e25814e)
- only allow save after form is modified (#6189) (27ea117)
- ensures confirm password remains on form state (#6190) (f2d4156)
- moves ts-essentials to prod deps (#6187) (bdf08a1)
BREAKING CHANGES
- update all plugin exports to be named and consistent (#6195) (b642cb2)
All plugins have been updated to use named exports and the names have been updated to be consistent.

Please read the list below and rename your import accordingly
```
// before
import { cloudStorage } from '@payloadcms/plugin-cloud-storage'
// current
import { cloudStoragePlugin } from '@payloadcms/plugin-cloud-storage'

// before
import { payloadCloud } from '@payloadcms/plugin-cloud'
// current
import { payloadCloudPlugin } from '@payloadcms/plugin-cloud'

// before
import formBuilder from '@payloadcms/plugin-form-builder'
// current
import { formBuilderPlugin } from '@payloadcms/plugin-form-builder'

// before
import { nestedDocs } from '@payloadcms/plugin-nested-docs'
// current
import { nestedDocsPlugin } from '@payloadcms/plugin-nested-docs'

// before
import { redirects } from '@payloadcms/plugin-redirects'
// current
import { redirectsPlugin } from '@payloadcms/plugin-redirects'

// before
import search from '@payloadcms/plugin-search'
// current
import { searchPlugin } from '@payloadcms/plugin-search'

// before
import { sentry } from '@payloadcms/plugin-sentry'
// current
import { sentryPlugin } from '@payloadcms/plugin-sentry'

// before
import { seo } from '@payloadcms/plugin-seo'
// current
import { seoPlugin } from '@payloadcms/plugin-seo'
```
- richtext-lexical: finalize ClientFeature interface (#6191) (7ab156e)
If you have own, custom lexical features, there will be a bunch of breaking API changes for you. The saved JSON data is not affected.

floatingSelectToolbar has been changed to toolbarInline

slashMenu.dynamicOptions and slashMenu.options have been changed to slashMenu.groups and slashMenu.dynamicGroups

toolbarFixed.sections is now toolbarFixed.groups

Slash menu group options and toolbar group entries have both been renamed to items

Toolbar group item onClick has been renamed to onSelect to match slash menu properties

slashMenu item onSelect is no longer auto-wrapped inside an editor.update. If you perform editor updates in them, you have to wrap it inside an editor.update callback yourself. Within our own features this extra control has removed a good amount of unnecessary, nested editor.update calls, which is good

Slash menu items are no longer initialized using the new keyword, as they are now types and no longer classes. You can convert them to an object and add the key property as an object property instead of an argument to the previous SlashMenuItem constructor

CSS classnames for slash menu and toolbars, as well as their items, have changed

CheckListFeature is now exported as and has been renamed to ChecklistFeature

For guidance on migration, check out how we migrated our own features in this PR's diff: https://github.com/payloadcms/payload/pull/6191/files
Contributors
- Elliot DeNolf (@denolfe)
- Paul (@paulpopus)
- Jessica Chowdhury (@JessChowdhury)
- Jacob Fletcher (@jacobsfletch)
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
May 2, 2024
3.0.0-beta.23 (2024-05-02)

Features
- plugin-stripe: update plugin stripe for v3 (#6019) (75a9546)
Bug Fixes
- reset password validations (#6153) (c0ae287)
- ui: watch "where" query param inside route and reset WhereBuilder (#6184) (a2b92aa)
Contributors
- Elliot DeNolf (@denolfe)
- Paul (@paulpopus)
- Jarrod Flesch (@JarrodMFlesch)
- Patrik (@PatrikKozak)
- Friggo (@MrFriggo)
May 2, 2024
3.0.0-beta.22 (2024-05-02)

Bug Fixes
- templates: adds back missing CSS import in blank 3.0 template (#6183) (6d642fe)
- next: ensures admin access only blocks admin routes (3290376)
Contributors
- Yiannis Demetriades (@ydemetriades)
- Jacob Fletcher (@jacobsfletch)
- Alessio Gravili (@AlessioGr)
- Wilson (@WilsonLe)
- Tylan Davis (@tylandavis)
- Paul (@paulpopus)
May 1, 2024
3.0.0-beta.21 (2024-05-01)

Features
- richtext-lexical: various validation improvements (#6163) (d8f91cc)
- richtext-lexical: add validation to link and upload nodes (8829fba)
- richtext-lexical: link node: disable client-side link validation. This allows overriding validation behavior by providing your own url field to the Link feature. (01f38c4)
- richtext-lexical: change link fields handling (#6162) (5a82f34)
- richtext-lexical: initialize lexical during sanitization (#6119) (d9bb51f)
- richtext-lexical: implement relationship node click and delete/backspace handling (#6147) (181f82f)
- implement resend rest email adapter (#5916) (3d50caf)
Bug Fixes
- templates: updates payload app files (#6172) (04f1df8)
- deps: move file-type to deps (#6171) (1c490ae)
- various loader issues (#6090) (568b074)
- add missing error logger to buildFormState error catch (10b99ce)
- richtext-slate: do not add empty fields group if no custom fields are added (5420d88)
- richtext-lexical: floating toolbar caret positioned incorrectly for some line heights (#6149) (9a636a3)
- richtext-lexical: drag and add block handles disappear too quickly for smaller screen sizes. (#6144) (6a9cde2)
- blocks non-admin users from admin access (#6127) (4d7ef58)
- importWithoutClientFiles not working due to incorrect import path used (cd5e8d7)
- loader: typescript module resolver not resolving to source path of symlinked module (fa2083f)
BREAKING CHANGES
- richtext-lexical: various validation improvement (#6163) (d8f91cc)
This will now display errors if you're previously had invalid link or upload fields data - for example if you have a required field added to an uploads node and did not provide a value to it every time you've added an upload node
- richtext-lexical: change link fields handling (#6162) (5a82f34)
Drawer fields are no longer wrapped in a fields group. This might be breaking if you depend on them being in a field group in any way - potentially if you use custom link fields. This does not change how the data is saved

If you pass in an array of custom fields to the link feature, those were previously added to the base fields. Now, they completely replace the base fields for consistency. If you want to ADD fields to the base fields now, you will have to pass in a function and spread defaultFields - similar to how adding your own features to lexical works

Example Migration for ADDING fields to the link base fields:

Previous:

LinkFeature({ fields: [ { name: 'rel', label: 'Rel Attribute', type: 'select', hasMany: true, options: ['noopener', 'noreferrer', 'nofollow'], admin: { description: 'The rel attribute defines the relationship between a linked resource and the current document. This is a custom link field.', }, }, ], }),

Now:

LinkFeature({ fields: ({ defaultFields }) => [ ...defaultFields, { name: 'rel', label: 'Rel Attribute', type: 'select', hasMany: true, options: ['noopener', 'noreferrer', 'nofollow'], admin: { description: 'The rel attribute defines the relationship between a linked resource and the current document. This is a custom link field.', }, }, ], }), "
- richtext-lexical: initialize lexical during sanitization (#6119) (d9bb51f)
sanitizeFields is now an async function

the richText adapters now return a function instead of returning the adapter directly"
Apr 29, 2024
What's Changed
- fix(db-postgres): use locales suffix by @DanRibbens in https://github.com/payloadcms/payload/pull/6032
- docs: new packages by @denolfe in https://github.com/payloadcms/payload/pull/6041
- fix: version restoration by @JarrodMFlesch in https://github.com/payloadcms/payload/pull/6040
- ci: app build with packed by @denolfe in https://github.com/payloadcms/payload/pull/6051
- fix: properly handle external file url by @denolfe in https://github.com/payloadcms/payload/pull/6060
- fix(deps): dedupes react by @jacobsfletch in https://github.com/payloadcms/payload/pull/6064
- fix: bulk publish from collection list by @DanRibbens in https://github.com/payloadcms/payload/pull/6065
- fix: formData handling on Vercel by @JarrodMFlesch in https://github.com/payloadcms/payload/pull/6067
- fix: correct createPayloadRequest routeParams by @JarrodMFlesch in https://github.com/payloadcms/payload/pull/6059
- fix: file uploads, broken import path by @JarrodMFlesch in https://github.com/payloadcms/payload/pull/6069
- fix: issue with dupplicate ':' in email links by @paulpopus in https://github.com/payloadcms/payload/pull/6086
- fix(richtext-lexical): type errors for FeatureProviderServer with typescript strict mode by @AlessioGr in https://github.com/payloadcms/payload/pull/6091
- docs: storage-* and plugin-cloud-storage updates by @denolfe in https://github.com/payloadcms/payload/pull/6096
- feat(richtext-lexical)!: upgrade lexical from 0.13.1 to 0.14.5 and backport other changes by @AlessioGr in https://github.com/payloadcms/payload/pull/6095
- fix: conditions throwing errors break form state by @JarrodMFlesch in https://github.com/payloadcms/payload/pull/6113
- fix(next,ui): properly sets document operation for globals by @jacobsfletch in https://github.com/payloadcms/payload/pull/6116
- fix: validate user slug is an auth-enabled collection by @denolfe in https://github.com/payloadcms/payload/pull/6118
- test: add test email adapter, use for all tests by default by @denolfe in https://github.com/payloadcms/payload/pull/6120
- fix: logout-inactivity route was 404ing by @jmikrut in https://github.com/payloadcms/payload/pull/6121
- fix: local req missing url headers by @jmikrut in https://github.com/payloadcms/payload/pull/6126
⚠ BREAKING CHANGES:

@payloadcms/richtext-lexical

Upgrade lexical from 0.13.1 to 0.14.5 and backport other changes by @AlessioGr in https://github.com/payloadcms/payload/pull/6095
- Lexical may introduce breaking changes in their updates. Please consult their changelog. One breaking change I noticed is that the SerializedParagraphNode now has a new, required textFormat property.
- Now that lexical supports ESM, all CJS-style imports have been changed to ESM-style imports. You may have to do the same in your codebase if you import from lexical core packages
Full Changelog: https://github.com/payloadcms/payload/compare/v3.0.0-beta.18...v3.0.0-beta.20
Apr 25, 2024
What's Changed
- fix: bulk publish by @DanRibbens in https://github.com/payloadcms/payload/pull/6007
- fix(ui): renders stay logged in modal by @jacobsfletch in https://github.com/payloadcms/payload/pull/6009
- fix(next): ensures create-first user works by @jmikrut in https://github.com/payloadcms/payload/pull/6020
- fix(db-postgres): fully functional dbNames by @jmikrut in https://github.com/payloadcms/payload/pull/6023
- fix(db-postgres): postgres version id bug by @jmikrut in https://github.com/payloadcms/payload/pull/6026
- fix: disable api key beta by @DanRibbens in https://github.com/payloadcms/payload/pull/6021
Full Changelog: https://github.com/payloadcms/payload/compare/v3.0.0-beta.15...v3.0.0-beta.18
Apr 24, 2024
What's Changed

Features
- feat!: removed getDataAndFile and getLocales from createPayloadRequest in favour of new utilities addDataAndFileToRequest and addLocalesToRequest by @paulpopus in https://github.com/payloadcms/payload/pull/5999
- feat(richtext-lexical)!: rework population behavior and allow richText adapter field hooks by @AlessioGr in https://github.com/payloadcms/payload/pull/5893
Fixes
- fix: issues creating the first user by @paulpopus in https://github.com/payloadcms/payload/pull/5986
- fix: type collection config missing dbName by @DanRibbens in https://github.com/payloadcms/payload/pull/5983
- fix(db-postgres): postgres uuid by @denolfe in https://github.com/payloadcms/payload/pull/6003
⚠ BREAKING CHANGES
- feat!: removed getDataAndFile and getLocales from createPayloadRequest in favour of new utilities addDataAndFileToRequest and addLocalesToRequest by @paulpopus in https://github.com/payloadcms/payload/pull/5999
Custom handlers will no longer resolve data, locale and fallbackLocale for you. Instead you can use our provided utilities from the next package
```
// ❌ Before
{
  path: '/whoami/:parameter',
  method: 'post',
  handler: async (req) => {
    return Response.json({
      name: req.data.name, // data will be undefined
      // locales will be undefined
      fallbackLocale: req.fallbackLocale,
      locale: req.locale,
    })
  }
} 

// ✅ After
import { addDataAndFileToRequest } from '@payloadcms/next/utilities'
import { addLocalesToRequest } from '@payloadcms/next/utilities'

{
  path: '/whoami/:parameter',
  method: 'post',
  handler: async (req) => {
    // mutates req, must be awaited
    await addDataAndFileToRequest(req)
    
    // mutates req
    addLocalesToRequest(req)
	  
    return Response.json({
      name: req.data.name, // data is now available
      fallbackLocale: req.fallbackLocale, // locales available
      locale: req.locale,
    })
  }
} 
```
Full Changelog: https://github.com/payloadcms/payload/compare/v3.0.0-beta.14...v3.0.0-beta.15
Apr 23, 2024
v3.0.0-beta.14

⚠ BREAKING CHANGES

@payloadcms/db-postgres
- fix(db-postgres): shortens relation names (#5976)
Shortens the name of auto-generated Postgres relations. Should dramatically reduce errors for users in PG. Also handles an issue with HMR in Postgres by properly destroying the database adapter before re-initializing it.

This change will require anyone running @payloadcms/db-postgres to create a new migration and run it against their database.
- Run your application in development
- pnpm payload migrate:create will generate the new migration
- pnpm payload migrate will run the migration against your DB
Apr 23, 2024
v3.0.0-beta.12

Features
- feat: json field schemas by @kendelljoseph in https://github.com/payloadcms/payload/pull/5898
- feat(live-preview-vue): new live-preview-vue package by @DanRibbens in https://github.com/payloadcms/payload/pull/5933
- feat: adds count operation by @r1tsuu in https://github.com/payloadcms/payload/pull/5930
- feat!: email adapter by @denolfe in https://github.com/payloadcms/payload/pull/5901
- feat(plugin-cloud-storage): implement storage packages by @denolfe in https://github.com/payloadcms/payload/pull/5928
- feat: Update Ukrainian ("uk") translations and date-fns key by @BohdanK-W32 in https://github.com/payloadcms/payload/pull/5836
Fixes
- fix(db-postgres): validateExistingBlockIsIdentical for localized fields with the same name by @r1tsuu in https://github.com/payloadcms/payload/pull/5840
- fix: ensure body limit is respected by @JarrodMFlesch in https://github.com/payloadcms/payload/pull/5807
- fix(next): adds client-side field validations to login and forgot-password views by @PatrikKozak in https://github.com/payloadcms/payload/pull/5871
- fix(next): issue with password and confirm password fields not being type of password by @paulpopus in https://github.com/payloadcms/payload/pull/5870
- fix(next): check for matching passwords when creating the first user by @paulpopus in https://github.com/payloadcms/payload/pull/5869
- fix: postgres query hasMany in by @DanRibbens in https://github.com/payloadcms/payload/pull/5884
- fix(create-payload-app): uses baseUrl for payload config path in tsconfig by @JessChowdhury in https://github.com/payloadcms/payload/pull/5888
- fix(next): admin access control by @jacobsfletch in https://github.com/payloadcms/payload/pull/5887
- fix: accepts empty cell data by @kendelljoseph in https://github.com/payloadcms/payload/pull/5876
- fix(next): pass a corrent content-type header in getFile route by @r1tsuu in https://github.com/payloadcms/payload/pull/5799
- fix(next): do not require handlers, attempt to read filesystem or throw by @JarrodMFlesch in https://github.com/payloadcms/payload/pull/5896
- fix: adds type error validations for email and password in login operation by @PatrikKozak in https://github.com/payloadcms/payload/pull/5899
- fix(db-mongodb): ignore end session errors by @DanRibbens in https://github.com/payloadcms/payload/pull/5905
- fix(payload): Passes correct path to import modules on Windows started with file:// by @r1tsuu in https://github.com/payloadcms/payload/pull/5919
- fix: v3 update many with drafts by @DanRibbens in https://github.com/payloadcms/payload/pull/5900
- fix(db-postgres): v3 #5938 extra version suffix table names by @DanRibbens in https://github.com/payloadcms/payload/pull/5940
- fix(db-postgres): v3 nested groups in nested blocks by @DanRibbens in https://github.com/payloadcms/payload/pull/5941
- fix(plugin-cloud-storage)!: Pass filename to utility function getting file prefix by @SimonVreman in https://github.com/payloadcms/payload/pull/5934
- fix: add CORS headers to API Response by @jacobsfletch in https://github.com/payloadcms/payload/pull/5906
- fix(db-postgres): row table names were not being built properly by @PatrikKozak in https://github.com/payloadcms/payload/pull/5960
- fix: resave media using cloud storage plugin by @denolfe in https://github.com/payloadcms/payload/pull/5959
⚠ BREAKING CHANGES
- feat!: email adapter by @denolfe in https://github.com/payloadcms/payload/pull/5901
Providing an email configuration is now optional. If using nodemailer before, you will need to install a new package @payloadcms/email-nodemailer and use it in your config.

Email Configuration Before:
- Providing any email configuration was completely optional and would configure nodemailer and ethereal.email with a test account by default.
```
// via payload.init
payload.init({
  email: {
    transport: someNodemailerTransport
    fromName: 'hello',
    fromAddress: 'hello@example.com',
  },
})
// or via email in payload.config.ts
export default buildConfig({
  email: {
    transport: someNodemailerTransport
    fromName: 'hello',
    fromAddress: 'hello@example.com',
  },
})
```
Email Configuration After:
- All existing nodemailer functionality was abstracted into the @payloadcms/email-nodemailer package
- No longer configured with ethereal.email by default.
- Ability to pass email into the init function has been removed.
- Warning will be given on startup if email not configured. Any sendEmail call will simply log the To address and subject.
```
// Using new nodemailer adapter package

import { nodemailerAdapter } from '@payloadcms/email-nodemailer'

export default buildConfig({
  email: nodemailerAdapter() // This will be the old ethereal.email functionality
})

// or pass in transport

export default buildConfig({
  email: nodemailerAdapter({
    defaultFromAddress: 'info@payloadcms.com',
    defaultFromName: 'Payload',
    transport: await nodemailer.createTransport({
      host: process.env.SMTP_HOST,
      port: 587,
      auth: {
        user: process.env.SMTP_USER,
        pass: process.env.SMTP_PASS,
      },
    })
  })
})
```
```
// Create custom email adapter

// myAdapter.ts
import type { EmailAdapter, SendMailOptions } from 'payload/types'

export const myAdapter: EmailAdapter = ({ payload }) => ({
  defaultFromAddress: defaults.defaultFromAddress,
  defaultFromName: defaults.defaultFromName,
  sendEmail: async (message) => {
    // Perform any logic here
    console.log(`To: '${message.to}', Subject: '${message.subject}'`)
    return Promise.resolve()
  },
})

// payload.config.ts
export default buildConfig({
  email: myAdapter()
})
```

PayloadCMS releases filter

v3.45.0 (2025-07-03)

🚀 Features

🐛 Bug Fixes

🎨 Styles

🧪 Tests

📝 Templates

⚙️ CI

🏡 Chores

🤝 Contributors

v3.44.0 (2025-06-27)

🚨 Notice 🚨

🚀 Features

🐛 Bug Fixes

🛠 Refactors

📚 Documentation

🧪 Tests

📝 Templates

📓 Examples

⚙️ CI

🏡 Chores

🤝 Contributors

v3.43.0 (2025-06-16)

🚀 Features

🐛 Bug Fixes

⚡ Performance

🛠 Refactors

📚 Documentation

🏡 Chores

🤝 Contributors

v3.42.0 (2025-06-09)

🚀 Features

🐛 Bug Fixes

⚡ Performance

📚 Documentation

🏡 Chores

🤝 Contributors

v3.41.0 (2025-06-05)

🚀 Features

🐛 Bug Fixes

⚡ Performance

🛠 Refactors

📚 Documentation

📝 Templates

⚙️ CI

🏡 Chores

🤝 Contributors

v3.40.0 (2025-05-29)

🚀 Features

🐛 Bug Fixes

⚡ Performance

🛠 Refactors

📚 Documentation

📝 Templates

🏡 Chores

🤝 Contributors

v3.39.1 (2025-05-22)

🐛 Bug Fixes

📚 Documentation

📝 Templates

🤝 Contributors

v3.39.0 (2025-05-22)

🚀 Features

🐛 Bug Fixes

⚡ Performance

📚 Documentation

🧪 Tests

📝 Templates

🏡 Chores

🤝 Contributors

v3.38.0 (2025-05-15)

🚀 Features

🐛 Bug Fixes

⚡ Performance

📚 Documentation

📝 Templates

🏡 Chores

🤝 Contributors

v3.37.0 (2025-05-05)

🚀 Features