PayloadCMS Releases Filter

Apr 9, 2026
v3.82.1 (2026-04-09)

🐛 Bug Fixes
- next: use correct config key for disabling turbo server fast refresh (#16215) (11adc9d)
- plugin-nested-docs: await populateBreadcrumbs in resaveChildren (#15582) (0554b50)
⚡ Performance
- storage-s3: avoid getObject call if ETag matches (#15295) (7ccc3f0)
📚 Documentation
- fix incorrect select syntax example in querying docs (#14590) (be6c443)
📝 Templates
- bump to 3.82.0, remove --no-server-fast-refresh flag (#16212) (79c8d7e)
🤝 Contributors
- William Ding (@wingding12)
- Syazwan (@syazwanz)
- Alessio Gravili (@AlessioGr)
- Anders Semb Hermansen (@andershermansen)
Apr 8, 2026
v3.82.0 (2026-04-08)

🚀 Features
- disambiguate media files by prefix via query parameter (#15844) (05ddec1)
- add missing disableErrors to globals findOne operation (#14913) (c8332e7)
- improve default slugify utility by triming whitespace first (#14421) (fdaa051)
- add typescript.postProcess hook for type generation (#16103) (67b5dc3)
- plugin-redirects: add Portuguese translation (#15269) (122f4c1)
- plugin-search: pass collection slug to beforeSync hook (#11581) (ebbd6ad)
- ui: export drag-and-drop components (#12626) (23b0f1b)
🐛 Bug Fixes
- incorrect 24 hour format comment example (#15649) (f42b767)
- resolve 404/500 error when downloading files containing hash in filename (#15799) (3a09387)
- JSDoc string for focalPoint option in uploads so it correctly mentions defaults to true (#13070) (84090ac)
- skip validation for unpublish operations with localized required fields (#16120) (24b9e13)
- skip default validation for virtual fields (#16015) (e09c619)
- db-mongodb: update mongoose-paginate-v2 to fix collation pagination (#16049) (78a27ab)
- drizzle: convert equals/not_equals to in/not_in for hasMany relationship array values (#15766) (59af156)
- next: fix hmr, bump minimum required next.js 16 version to 16.2.2 (#16202) (7f83571)
- next: admin.meta.title object form renders [object Object] in browser tab (#16117) (0981cdc)
- plugin-mcp: add error handling to convertCollectionSchemaToZod (#16114) (6184b0c)
- plugin-multi-tenant: infinite api calling loop on user switch (#16065) (3da805f)
- storage-*: redundant re-uploads when file was already uploaded by the client and add comprehensive E2E tests for s3 and vercel-blob (#16115) (a6735f3)
- storage-azure: fix azure storage mime type handling for streaming uploads (#15949) (cd7fcea)
- templates: tailwind file extension is wrong in website template components.json file (#9342) (2011f28)
- templates: fixed forgot password link (#15037) (b505e36)
- templates: add generated files to ESLint ignores (#15716) (941a41f)
- templates: typo in with-cloudflare-d1 template (#14243) (14b708f)
- translations: fix Swedish unpublish translations and capitalization (#15353) (4e48706)
- translations: correct French translation for 'move' action (#14771) (750d29f)
- translations: update passive voice and newLabel wording in zh-TW translations (#13761) (e284ab5)
- translations: update Japanese translations related to localizeStatus (#15358) (7ab2881)
- ui: relationship filter duplicate options when switching operators (#16204) (3a1f31a)
- ui: unpublish button missing for globals and version count incorrectly incrementing after unpublish (#16203) (1ddeb60)
- ui: exclude unnamed tab labels from filter and groupBy field options (#9965) (b13c5c9)
- ui: update node to v20 (#15717) (b2593d6)
- ui: radio fields do not reliably trigger admin.condition re-evaluation on sibling fields (#16056) (7e2a126)
⚡ Performance
- skip validation for default timezones (#16129) (76f3693)
🛠 Refactors
- plugin-seo: rename non-JSX files from .tsx to .ts (#14418) (b67882c)
- translations: improve German translations for consistency and accuracy (#14439) (f3c0bc8)
📚 Documentation
- fix typo in Collection Config docs (collection → collections) (#16183) (ac085cd)
- remove JSX comment from content in dashboard (#16156) (05447b7)
- add warning about Cosmos dB incompatibility (#13350) (c4375bd)
- add info about custom errors via APIError to hooks overview (#13047) (d03054e)
- fix typo in storage-adapters documentation (#13648) (911f059)
- rename incorrect usage of the cloud storage plugin to align with the imported module in storage-adapters.mdx (#11475) (d491f29)
- add dev note about auth strategy hot-reload requirement (#14122) (c4da453)
- fix anchor link reference for settingsMenu (#14391) (8c748d6)
- nested plugin (#15230) (2e653ae)
- add getDataByPath to useForm table (#12098) (69a49e7)
- add missing comma to seo plugin doc (#11516) (df03ed0)
- fix typo in ecommerce template link in seo plugin docs (#15641) (e2cd07c)
- corrects Local API example in import export docs (#16128) (13a726a)
- update link to Custom Components Performance docs (#15723) (9141e34)
- update folders documentation with the right property (#14060) (b63198d)
📝 Templates
- fix tailwind typography config so that it works better with shadcn CLI (#16209) (4931458)
🏡 Chores
- upgrade vitest and @vitest/ui to 4.1.2 (#16154) (5af591c)
- export FieldAccessArgs from payload (#14755) (c3ec73f)
- extract sanitizeField from sanitizeFields (#16133) (b705af4)
- improve int summary counts when content-api is unavailable (#16127) (a65e715)
- add React component file structure conventions to CLAUDE.md (#16125) (9284441)
- richtext-lexical: improve Swedish translations (#15273) (ac16116)
- templates: add type detection on getGlobal utility (#11617) (b278a17)
- templates: remove redundant condition check (#12130) (cf0a883)
🤝 Contributors
- Alessio Gravili (@AlessioGr)
- Maxim Seshuk (@maximseshuk)
- Paul (@paulpopus)
- Jens Becker (@jhb-dev)
- JianJroh (@JianJroh)
- Pierre Cabrière (@pierrecabriere)
- Tyler Schwartz (@tschwartz)
- Jarrod Flesch (@JarrodMFlesch)
- Patrik (@PatrikKozak)
- Mohsen (@webgodo)
- German Jablonski (@GermanJablo)
- Anders Semb Hermansen (@andershermansen)
- Marcus Forsberg (@marcusforsberg)
- Sasha Rakhmatulin (@r1tsuu)
- Said Akhrarov (@akhrarovsaid)
- marketsystems (@marketsystems)
- Eduardo Würch (@ewurch)
- Matthieu (@RibeyrollesMatthieu)
- Riley Langbein (@rilrom)
- Matthew DeAbreu (@mdeabreu)
- Tim @ erdee (@tim-at-erdee)
- José Eduardo Dias (@josedudias)
- Rot4tion (@Rot4tion)
- Adebayo Ajayi (@Braggedtooth)
- Christian Wesselhoeft (@xtian)
- ab192130 (@ab192130)
- MichalKormanik (@MichalKormanik)
- Yi Chi (@chiyi4488)
- swenzel-arc (@swenzel-arc)
- roboin (@Robot-Inventor)
- Wes DiMiceli (@wesdimiceli)
- codeflorist (@codeflorist)
- Vincent Vu (@rubixvi)
- Ilham Saputrajati (@ilhamsj)
- Boyan Bratvanov (@bratvanov)
- Roman Ryzhikov (@yagee)
- spiner2000 (@spiner2000)
- Sean Zubrickas (@zubricks)
- Sebastian Blank (@blankse)
- Max Malm (@benjick)
- Omar Yusuf Abdi (@omar-y-abdi)
- Shaun Wallace (@ShaunMWallace)
Apr 1, 2026
v3.81.0 (2026-04-01)

🚀 Features
- add LLM eval suite for Payload conventions and code generation (#15710) (db4b00e)
- next: prevent admin panel errors when cacheComponents is enabled (#16020) (1ecd7dd)
🐛 Bug Fixes
- update file-type, ajv and jose packages (#16118) (d09ed54)
- add field-level access control to internal auth fields (#16119) (4ae5577)
- where querying by a join field with relationship nested to an array (#16101) (0f79eed)
- trashed documents still show as IDs in relationship responses (#16102) (aa143e6)
- db-mongodb: virtual fields within blocks (#16107) (77cdb17)
- db-postgres: stabilize read replicas support (#16083) (46ddf8d)
- db-postgres: handle blockType filters for versions (#16071) (727d74e)
- deps: resolve high severity audit vulnerabilities (#16104) (c5a3767)
- next: respect canAccessAdmin when a custom dashboard view is configured (#16105) (329090c)
- next: forgot password basePath was not respected (#16084) (3c40241)
- plugin-multi-tenant: forbidden error when logging in as a user with no tenant and no access to all tenants (#16047) (9c58e7c)
- richtext-lexical: prevent invalid h0 heading nodes when all heading sizes are disabled (#16090) (185548a)
- sdk: pass trash to request (#16092) (e0b3e81)
- storage-gcs: bump @google-cloud/storage (#16046) (5c06266)
- storage-vercel-blob: properly handle alwaysInsertFields and add comprehensive integration test suite with a vercel blob emulator (#16080) (8530b45)
- templates: add --no-server-fast-refresh to all dev scripts for Next.js 16.2+ compatibility (#16074) (8045887)
- ui: prevent data loss in copy-to-locale with drafts (#16073) (43b8de6)
- ui: tokenInMemory not set after refreshing cookie (#15928) (17266ab)
- ui: respect admin.dateFormat for list view filters (#16040) (d5fe0ce)
🛠 Refactors
- ui: live preview iframe loader (#16004) (167a01e)
📚 Documentation
- clarify unique field index behavior and add warnings for array/blocks nesting (#15969) (38c1d4d)
- document ListViewServerProps/ClientProps and custom list view component patterns (#15970) (eb3b227)
- adds code examples for how to fully implement textStateFeature (#16053) (80ae745)
🧪 Tests
- add defaultSort join field property integration tests (#16057) (b2a8917)
📝 Templates
- fix broken images on Next.js 16 by using relative paths for local media (#16058) (1a0f4d0)
- bump to Next.js 16.2.1 (#16032) (5c3244f)
⚙️ CI
- fix localstack startup (#16048) (0d15620)
🏡 Chores
- claude: update audit-dependencies skill with lockfile strategy and override rules (#16106) (974870a)
- deps: bump qs-esm from 7.0.2 to 8.0.1 (#16110) (d6862fe)
🤝 Contributors
- Dan Ribbens (@DanRibbens)
- Jarrod Flesch (@JarrodMFlesch)
- angus-msquared (@angus-msquared)
- Sean Zubrickas (@zubricks)
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Jake Fletcher (@jacobsfletch)
- Mahmoud Hamdy (@mahmoodhamdi)
- Elliot DeNolf (@denolfe)
- Sasha (@r1tsuu)
- Nathan Bo Wang (@nathanbowang)
- Jon Bockhorst (@jmbockhorst)
- Daniel Giljam (@DanielGiljam)
- Kendell (@kendelljoseph)
Mar 20, 2026
v3.80.0 (2026-03-20)

🚀 Features
- add disableUnique property to the slug field for better multi tenant plugin support (#15963) (395e1ed)
🐛 Bug Fixes
- unpublish updates existing version instead of creating a new one (#15985) (67063ab)
- use latest draft version data when trashing unpublished documents (#15981) (57a0edc)
- db-mongodb: fix pagination with collation in transactions (#15990) (5c935aa)
- db-postgres: near query can give incorrect results (#15907) (843306c)
- db-sqlite: scheduled publish does not show upcoming events because of wrong nested json querying (#15911) (3fa834a)
- deps: resolve high severity audit vulnerabilities (#15961) (da212fd)
- drizzle: pagination applied incorrectly when sorting by a field inside an array field (#15908) (0f67215)
- drizzle: groups inside localized tabs are not working correctly (#15936) (57bde77)
- graphql: force nullable for relationships to avoid errors when the related document is related (#15915) (560cabe)
- plugin-mcp: plugin can break next.js request handler because underlying Hono library modifies the global Request object (#15938) (4cfa495)
- plugin-multi-tenant: modal container blocks clicks on create-first-user page (#15973) (8157f4c)
- richtext-lexical: richtext fields don't respect RTL direction for Arabic and other RTL locales (#15964) (944a889)
- ui: defer live preview iframe rendering (#15999) (9999083)
- ui: stale data modal shown when onChange starts while save is in-flight (#15960) (dc98f0f)
📚 Documentation
- add custom admin location docs (#15581) (04a4b0a)
- updating lexical richtext fields (#15968) (8e5d56d)
- add copy and paste documentation for blocks (#15987) (747be91)
- warning for numeric field names (#15966) (99dcac1)
- storage adapters improvements (#15946) (9815d83)
📝 Templates
- bump templates to Next.js 16.2.0 (#16003) (4e34130)
⚙️ CI
- add audit-dependencies claude skill (#15967) (5efc2ff)
🏡 Chores
- add docker:clean script and fix docker:start reliability (#16000) (2646018)
- bump monorepo Next.js version to 16.2.0 (#15992) (a188556)
- consolidate docker scripts into single docker-compose with profiles (#15974) (f89e736)
- examples: update astro package.json name (#15118) (4e1c04e)
🤝 Contributors
- Alessio Gravili (@AlessioGr)
- Jarrod Flesch (@JarrodMFlesch)
- German Jablonski (@GermanJablo)
- Jake Fletcher (@jacobsfletch)
- Sasha (@r1tsuu)
- Patrik (@PatrikKozak)
- Sean Zubrickas (@zubricks)
- Riley Langbein (@rilrom)
- Elliot DeNolf (@denolfe)
Mar 16, 2026
v3.79.1 (2026-03-16)

🐛 Bug Fixes
- text field validation rejecting localized object values (#15932) (fac59c8)
- use Sec-Fetch-Site header for cookie authentication validation (#15751) (ef507a6)
- improved request origin retrieval (#15919) (f30d34f)
- generate:types inlines all blocks, add forceInlineBlocks property to use in plugin mcp (#15892) (6a9e367)
- update broken custom components docs link in config types jsdoc (#15794) (17aa1b5)
- run sanitizeWhereQuery for join query access result (#15891) (dc049fe)
- early return out of me access (#15883) (c6054c5)
- scope orderable join reordering by parent relation (#15842) (17a0d19)
- stricter input validation (#15868) (e474205)
- drizzle: avoid ts errors for payload generate:db-schema with circular references (#15895) (66a2efa)
- drizzle: error when using contains operator on hasMany select fields (#15865) (fba2438)
- drizzle: correctly apply query limit on polymorphic joins (#15652) (fe36dde)
- plugin-import-export: add space in zh translation for exportDocu… (#15833) (43d5596)
- plugin-mcp: bump @modelcontextprotocol/sdk from 1.25.2 to 1.27.1 (#15942) (94d2249)
- storage-azure: add stream aborts for error handling and connection closure (#15768) (b2a03c9)
- ui: stale data modal incorrectly shown when user saves their own document (#15933) (a5d9388)
- ui: copy & pasting block content duplicates array items in editor UI (#15941) (9bcedc8)
- ui: deleted array item reappears after reorder with autosave (#15906) (752c15a)
- ui: use consistent empty state styling in relationship table (#15914) (93b90da)
- ui: clicking filtered Combobox entries fails to trigger selection (#15788) (de3e5ae)
- ui: document status shows changed after publishing specific locale (#15765) (b95df0b)
- ui: split only on first colon in toast error messages (#15894) (fd64504)
- ui: block clipboard paste causes duplicate ID errors in Postgres (#15863) (e7d6331)
- ui: monomorphic relationship fields don't support multi-select with in/not_in operators (#15886) (f71ef61)
- ui: equal column widths for block-drawer blocks (#15867) (07f7802)
- ui: isolate join table column preferences from list view (#15846) (649f117)
- ui: falling back to UTC timezones in timezone picker (#15841) (70099b7)
⚡ Performance
- richtext-lexical: 3-15x less main thread blocking via centralized toolbar state (#15832) (2bdf7ce)
📚 Documentation
- correct type name in editMenuItems client component example (#15904) (03b20d0)
- adds req to available args and wraps examples with proper String type conversions in nested-docs (#15931) (d2a0740)
- adds docs for logger config (#15927) (46e43fc)
- fix links to virtual relationship documentation in both Blocks and Array field documentation (#15888) (fff60c8)
- broken anchor link in blocks field table (#15887) (36c051a)
- examples: clarify MongoDB prerequisites in Mongo-backed examples (#15860) (2aa973f)
- plugin-mcp: updates MCP plugin documentation (#15729) (b97b4e7)
🧪 Tests
- adjust total test count to exclude todo tests in summary output (#15943) (e46daec)
- fixes pagination and sorting list-view tests due to hydration timing issues (#15925) (b0f00c4)
- flaky timeout when clicking Create New button in versions test suite (#15850) (3fb10e1)
🏡 Chores
- bump next.js canary in monorepo (#15900) (62f2b7c)
🤝 Contributors
- Jessica Rynkar (@JessRynkar)
- Patrik (@PatrikKozak)
- German Jablonski (@GermanJablo)
- Copilot (@Copilot)
- Leon Gattermayer (@LeonGatt)
- Omar Yusuf Abdi (@omar-y-abdi)
- Sean Zubrickas (@zubricks)
- Eduardo Costa (@ed-cscosta)
- Jarrod Flesch (@JarrodMFlesch)
- Sasha (@r1tsuu)
- Alessio Gravili (@AlessioGr)
- Seiya (@silmin)
- Maxim Seshuk (@maximseshuk)
- Kendell (@kendelljoseph)
- Divyam gupta (@divyamdotfoo)
- deepshekhardas (@deepshekhardas)
- Paul (@paulpopus)
- zzz1220 (@zzz1220)
- Mikko Vänskä (@vanska)
Mar 4, 2026
v3.79.0 (2026-03-04)

🚀 Features
- richtext-lexical: separate configuration for lexical block icons (#15632) (f0498f2)
- richtext-lexical: upgrade lexical from 0.35.0 to 0.41.0 (#15760) (ba3bd74)
- translations: add i18n translations for modular dashboards (#15004) (cef2838)
Separate Block Icon Configuration (richtext-lexical) — Configure different images for Lexical block icons and block drawer thumbnails independently. Previously, imageURL served both contexts, forcing a compromise between a good 20x20px icon and a good drawer thumbnail. The new images property supports separate icon and thumbnail values with automatic fallback. Fully backwards compatible — imageURL still works but is deprecated. #15632
<img width="562" height="370" alt="image" src="https://github.com/user-attachments/assets/912e1482-0b37-40f7-a144-e21e43fc7aec" />
```
const QuoteBlock: Block = {
  slug: 'quote',
  images: {
    icon: 'https://example.com/icons/quote-20x20.svg',
    thumbnail: { url: 'https://example.com/thumbnails/quote-480x320.jpg', alt: 'Quote block' },
  },
  fields: [...],
}
```
Lexical Upgrade 0.35.0 → 0.41.0 (richtext-lexical) — Upgrades the Lexical rich text editor dependency from v0.35.0 to v0.41.0. Includes upstream fixes like normalizeMarkdown (facebook/lexical#7812). All Lexical breaking changes are handled internally by Payload — no action required for standard usage. If you installed lexical manually, update it to 0.41.0 (though using the re-exported versions from @payloadcms/richtext-lexical/lexical/* is recommended). #15760

Modular Dashboard Translations (translations) — Adds i18n translation support for the Modular Dashboards feature, covering all dashboard widget buttons and error messages. Previously, dashboard UI elements lacked translation keys, making them inaccessible for non-English users. Also updates the automatic translation script to use GPT-4.1 for improved cost efficiency. #15004
<img width="830" height="399" alt="image" src="https://github.com/user-attachments/assets/ca6cd857-e0dd-47b0-8b36-6242396f2c73" />
🐛 Bug Fixes
- restoreVersion validation for localized required fields (#15821) (e899182)
- draft doc validation when duplicating docs (#15816) (f470699)
- plugin-ecommerce: pass req to Payload API calls in Stripe adapter (#15839) (74799ea)
- plugin-import-export: automatically inherit locale and limit from URL queries (#15812) (ee083f0)
- plugin-import-export: fix imports with locales in a different column order than exported (#15808) (410912c)
- plugin-import-export: fix exports in other non-latin scripts being broken when opened in excel (#15813) (d931894)
- ui: drag and drop not working for sortable hasMany fields (#15845) (2c7ef3f)
- ui: prevent false positive stale data modal on autosave-enabled documents (#15817) (6aff717)
- ui: typo in CodeEditor export statement (#15795) (c5b2a91)
🛠 Refactors
- rename widget ComponentPath to Component for consistency (#15780) (f7d0d04)
📚 Documentation
- add documentation for conditional tabs (#15809) (a1d6733)
- fix table formatting in import-export plugin (#15792) (0dba95a)
🧪 Tests
- update suites selected by default in runTestsWithSummary (#15789) (07f2f05)
🏡 Chores
- prevent dev server from dirtying tracked files (#15826) (cb6f426)
- plugin-search: clean up .DS_Store file and resulting empty images directory (#14506) (f6f73dd)
⚠️ BREAKING CHANGES
- rename widget ComponentPath to Component for consistency (#15780) (f7d0d04)
  
  Renames Widget.ComponentPath to Widget.Component and types it as PayloadComponentinstead ofstring`
  
  This aligns dashboard widgets with every other component reference in (collections, globals, fields, admin components) - none of them path in the property name, and all of them are typed as PayloadComponent
  
  Enables new typescript plugin to work for widget paths (the plugin uses PayloadComponent contextual type detection - string-typed properties were invisible to it)
- ui: typo in CodeEditor export statement (#15795) (c5b2a91)
🤝 Contributors
- Patrik (@PatrikKozak)
- Jens Becker (@jhb-dev)
- Paul (@paulpopus)
- German Jablonski (@GermanJablo)
- Elliot DeNolf (@denolfe)
- Luiz Cláudio (@lcnogueira)
- Palamar Roman (@VeiaG)
- Sebastian Blank (@blankse)
- Alessio Gravili (@AlessioGr)
- Mahmoud Hassan (@Mhmod-Hsn)
Feb 27, 2026
v3.78.0 (2026-02-27)

🚀 Features
- typescript plugin for import paths (#15779) (7639664)
- move trash out of beta and delete access can now be limited to trash only (#15210) (2347cd9)
- next, ui: widget fields (#15700) (0a123b5)
- plugin-mcp: out of beta (#15711) (1b19d5f)
- plugin-mcp: ignore virtual fields in create and update operations (#15680) (cc8f888)
- richtext-lexical: add markdown transformer for upload nodes (#15630) (4af5a85)
- ui: adds dashed button style (#15728) (d570787)
- ui: make query-presets editable from the form view (#15657) (575f8e9)
Feature Details

TypeScript Plugin for Component Paths - New @payloadcms/typescript-plugin validates PayloadComponent import paths directly in your IDE. It checks that referenced files and exports exist, provides autocomplete for file paths and export names, supports go-to-definition on component path strings, and understands all Payload path conventions including absolute paths, relative paths, tsconfig aliases, and package imports. #15779

https://github.com/user-attachments/assets/2a8a8f73-a8fd-4e79-9dc4-795d817b5b75
```
pnpm add -D @payloadcms/typescript-plugin
```
```
{
  "compilerOptions": {
    "plugins": [{ "name": "next" }, { "name": "@payloadcms/typescript-plugin" }]
  }
}
```
Trash Out of Beta with Granular Delete Access - Trash is now a stable feature. Delete access control can now distinguish between trashing and permanently deleting — allowing you to permit users to soft-delete documents while restricting permanent deletion to admins. When data.deletedAt is being set, the operation is a trash; otherwise it's a permanent delete. #15210
```
import type { CollectionConfig } from 'payload'

export const Posts: CollectionConfig = {
  slug: 'posts',
  trash: true,
  access: {
    delete: ({ req: { user }, data }) => {
      // Not logged in - no access
      if (!user) {
        return false
      }

      // Admins can do anything (trash or permanently delete)
      if (user.roles?.includes('admin')) {
        return true
      }

      // Regular users: check what operation they're attempting
      // If data.deletedAt is being set, it's a trash operation - allow it
      if (data?.deletedAt) {
        return true
      }

      // Otherwise it's a permanent delete - deny for non-admins
      return false
    },
  },
  fields: [
    // ...
  ],
}
```
Widget Fields (next, ui) - Dashboard widgets can now declare configurable fields, similar to Blocks. Widget data is editable from a new drawer UI when in dashboard editing mode. Full type generation is included — WidgetInstance<T> is generic with typed data and width, and WidgetServerProps is generic so widget components receive typed widgetData. #15700

https://github.com/user-attachments/assets/b24d3635-8635-4d5f-84af-a6dcf801aa4f
```
import { buildConfig } from 'payload'

export default buildConfig({
  admin: {
    dashboard: {
      widgets: [
        {
          slug: 'sales-summary',
          ComponentPath: './components/SalesSummary.tsx#default',
          fields: [
            { name: 'title', type: 'text' },
            {
              name: 'timeframe',
              type: 'select',
              options: ['daily', 'weekly', 'monthly', 'yearly'],
            },
            { name: 'showTrend', type: 'checkbox' },
          ],
          minWidth: 'small',
          maxWidth: 'medium',
        },
      ],
    },
  },
})
```
```
import type { WidgetServerProps } from 'payload'

import type { SalesSummaryWidget } from '../payload-types'

export default async function SalesSummaryWidgetComponent({
  widgetData,
}: WidgetServerProps<SalesSummaryWidget>) {
  const title = widgetData?.title ?? 'Sales Summary'
  const timeframe = widgetData?.timeframe ?? 'monthly'

  return (
    <div className="card">
      <h3>
        {title} ({timeframe})
      </h3>
    </div>
  )
}
```
MCP Plugin Out of Beta (plugin-mcp) - @payloadcms/plugin-mcp is now stable and ready for production use. #15711

Virtual Field Filtering in MCP (plugin-mcp) - Virtual fields (virtual: true) are now automatically stripped from MCP tool input schemas and filtered from parsed data before create, update, and updateGlobal operations. This prevents non-stored fields from appearing as accepted MCP parameters. #15680

Markdown Transformer for Upload Nodes (richtext-lexical) - Upload nodes are now properly converted when using convertLexicalToMarkdown. Previously, upload nodes were silently dropped during markdown conversion. Now populated image uploads output ![alt text](/uploads/image.jpg), non-image uploads output link syntax, and non-populated uploads output a reference placeholder so data is never lost. #15630

Dashed Button Style (ui) - Adds a new dashed button style variant. Also replaces box-shadow with border on all buttons and fixes icon-only button padding. #15728
<img width="2021" height="1261" alt="Button styles overview" src="https://github.com/user-attachments/assets/8d97fb19-51c3-46a3-9148-c54b15d49723" />
Editable Query Presets from Form View (ui) - Query presets can now be created and edited directly from the document form view using a full WhereBuilder, column picker, and groupBy selector — no longer requiring the list view to build queries first. #15657

https://github.com/user-attachments/assets/d25b447b-c942-47ae-8878-47bd17a8a7fb

🐛 Bug Fixes
- getFieldsToSign crashes when user missing group/tab fields (#15775) (9f0c101)
- improve mobile touch support for dnd (#15771) (418bb92)
- prevent silent data overwrites on concurrent edits (#15749) (7a3f43f)
- preserve block metadata in mergeLocalizedData and filterDataToSelectedLocales (#15715) (6557292)
- return 400 for malformed JSON request bodies (#15706) (4861fa1)
- globals not updating updatedAt when saving drafts (#15764) (df17cb1)
- return early if pasteURL is not defined (#15748) (23d52a0)
- prevent req.file leak between sequential duplicate() calls on upload collections (#15620) (2baea2e)
- sanitize filenames in storage adapters (#15746) (45bd2f1)
- throw error for unknown query operators (#15739) (08226db)
- preserve locale data in unnamed groups with localizeStatus (#15658) (38b8c68)
- next: conditionally query snapshot field based on localization (#15693) (d5706ee)
- plugin-import-export: update docs on jobs and basic usage as well as visibility (#15695) (a40210c)
- plugin-mcp: use inline block schemas in JSON output (#15675) (a66e844)
- plugin-multi-tenant: hasMany tenant fields double-wrap arrays in filterOptions (#15709) (aaddeac)
- plugin-multi-tenant: return false instead of query when no tenants (#15679) (f5a5bd8)
- richtext-lexical: bump acorn to resolve type mismatch with transitive dep (#15791) (801e851)
- richtext-lexical: link markdown regex should not match similar looking image markdown (#15713) (0a0afb0)
- richtext-lexical: use headingLevel in danish heading label (#15685) (ad4c0f6)
- richtext-lexical: strip server-only properties from blocks in lexical client schema map (#15756) (c05ace2)
- templates: ecommerce find my order access functionality to use email (#15736) (b317eaa)
- ui: array field add button margin not applying consistently (#15773) (ee298f5)
- ui: respect custom Cell components on richText fields in list view (#15762) (139cf3e)
- ui: use correct translation key for collection version restore modal (#15757) (c1892eb)
- ui: encode HTML special characters in version diff view (#15747) (30fee83)
- ui: flash of border on list selection buttons (#15735) (7f3c6c8)
🛠 Refactors
- extract regex escape pattern into shared utility (#15676) (8ce389e)
- plugin-mcp: reduced code and de-duplication (#15705) (039e6c9)
🎨 Styles
- richtext-lexical: lists and quotes have inconsistent letter spacing (#15682) (f2397a8)
🧪 Tests
- fix flaky versions tests timing out on link clicks before hydration (#15790) (02da3fd)
- fix flaky lexical code block test with incorrect error expectations (#15776) (4e3e780)
- trash e2e list view clicks timing out in CI (#15778) (fd81fd5)
- fix flaky localization tests with race conditions (#15777) (bda5d0d)
- bulk upload button clicks timeout in CI (#15703) (8228a7d)
- field update access control test times out locally (#15691) (78e8e14)
- fix flaky account unlock test in postgres-uuid and custom-schema (#15696) (e3a76e3)
- fix flaky lexical e2e navigation timeouts and drawer clicks (#15694) (9ca5cda)
- fix flaky access-control bulk delete tests failing due to timing issues (#15692) (558345b)
- fix flaky drawer open and column sort timing issues (#15677) (00f763b)
📝 Templates
- fix cloudflare logger error in with-cloudflare-d1 template (#15752) (8791a72)
- ecommerce add missing access control on collections (#15744) (c74d91d)
- fix ecommerce webhooks url and update docs on using stripe webhooks (#15681) (677596c)
🏡 Chores
- make test:e2e agent-friendly with --grep support and dev server reuse (#15755) (929203c)
- deps: bump next.js canary in monorepo (#15708) (e3d8a94)
- plugin-mcp: improve schema sanitization and test coverage (#15704) (7e20b5c)
- templates: bump versions to 3.77.0 (#15678) (e26df27)
🤝 Contributors
- Elliot DeNolf (@denolfe)
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Sean Zubrickas (@zubricks)
- Benedikt Rötsch (@axe312ger)
- Shobhit Singhal (@shobhitsinghal624)
- The Mavik (@themavik)
- Divyesh Jain (@divyesh123-jain)
- Paul (@paulpopus)
- German Jablonski (@GermanJablo)
- Jens Becker (@jhb-dev)
- Jarrod Flesch (@JarrodMFlesch)
- Jessica Rynkar (@JessRynkar)
- Kendell (@kendelljoseph)
- Varun Chawla (@veeceey)
Feb 18, 2026
v3.77.0 (2026-02-18)

🚀 Features
- pass local API depth through to req.query.depth for consistency (#15023) (9a38469)
- db-*: add customID arg to db.create (#15653) (0935824)
- plugin-mcp: migrate from @vercel/mcp-adapter to mcp-handler (#15661) (24025fd)
Feature Details

Local API Depth Consistency - The depth option passed to Local API calls like payload.find() is now automatically set on req.query.depth. Previously, hooks relying on req.query.depth would behave differently between Local API and REST/GraphQL calls unless you manually passed req: { query: { depth: x } } in addition to depth: x. This change ensures consistent behavior across all API methods. #15023

Custom ID Support in db.create (db-*) - New customID argument on payload.db.create allows creating documents with a specific ID without requiring a custom ID field in your collection schema. #15653
```
payload.db.create({ collection: 'posts', customID: 'ce98d6c4-c3ab-45de-9dfc-bf33d94cc941', data: { } })
```
MCP Plugin Migration (plugin-mcp) - Migrates from the deprecated @vercel/mcp-adapter to mcp-handler and bumps @modelcontextprotocol/sdk to 1.25.2 addressing a security vulnerability. Exposes new handler options: disableSse, onEvent, and redisUrl. #15661
```
import { mcpPlugin } from '@payloadcms/plugin-mcp'

export default buildConfig({
  plugins: [
    mcpPlugin({
      // Optional: Enable SSE transport (disabled by default)
      disableSse: false,
      // Optional: Redis URL for SSE session management (defaults to REDIS_URL env)
      redisUrl: 'redis://localhost:6379',
      // Optional: Track MCP events for analytics/debugging
      onEvent: (event) => {
        console.log('MCP event:', event)
      },
    }),
  ],
})
```
🐛 Bug Fixes
- hasMany text fields cannot be filtered with contains operator (#15671) (4513a05)
- use consistent empty state styling between list and folder views (#15555) (8953b37)
- populate previousValue correctly in afterChange hooks for nested lexical fields (#15623) (1cc3bb9)
- add i18n support for dashboard edit mode buttons (#15564) (818e31d)
- next: handle undefined fieldTab in version diff tabs (#15590) (bbacab8)
- plugin-cloud-storage: ensure file data persists across operations (#15570) (6af3673)
- plugin-cloud-storage: generateFileURL only ran when disablePayloadAccessControl was true (#15667) (6c5611c)
- plugin-import-export: remove deprecated import (#15666) (733b1df)
- plugin-import-export: export and import issues when using custom IDs (#15518) (7e2a3ab)
- plugin-import-export: columns being duplicated when using toCSV hook (#15597) (28e07dc)
- plugin-mcp: resolve union type fields failing in update tool (#15660) (9ae89dd)
- plugin-multi-tenant: improve translation for "Tenant" (use "Mandant" instead of "Mieter") (#15537) (4d4033b)
- plugin-multi-tenant: tenant selector not appearing after login (#15617) (dd09f67)
- storage-r2: build error due to types issue in R2 Bucket type (#15670) (7d1e233)
- ui: fix broken polymorphic join edit drawer (#15621) (d450e99)
📚 Documentation
- update cell component docs (#15574) (c403b00)
- outline html lexical content conversion (#15601) (dc1b799)
- updates collection admin options (#14605) (8e92f7f)
- update custom components docs (#15576) (ae82294)
- clarify supported Next.js versions and optional dependencies in installation guide (#15604) (409bc0d)
🧪 Tests
- trash e2e tests check URL before navigation completes (#15599) (7fe5a8c)
🏡 Chores
- add md and mdx language block linting (#15309) (5415516)
- bump playwright to fix vscode run test indicators (#15626) (f74d288)
- only add publishAllLocales to publish when localizeStatus is enabled (#15610) (d57bc22)
🤝 Contributors
- Paul (@paulpopus)
- Patrik (@PatrikKozak)
- Jessica Rynkar (@JessRynkar)
- German Jablonski (@GermanJablo)
- Kendell (@kendelljoseph)
- Ahmad Yasser (@AhmadYasser1)
- Sasha (@r1tsuu)
- Philipp Schneider (@philipp-tailor)
- Philipp Brumm (@brumm)
- Sebastian Blank (@blankse)
- Sean Zubrickas (@zubricks)
- Alessio Gravili (@AlessioGr)
- Vaishnav Patil (@vaishnav-3)
- Divyesh Jain (@divyesh123-jain)
Feb 11, 2026
v3.76.1 (2026-02-11)

🐛 Bug Fixes
- use optional chaining for adminThumbnail size lookup to prevent crash (#15586) (6937eec)
- non-image files should not recieve 0 bytes with useTempFiles (#15538) (a313627)
- add CSP headers to SVG uploads to prevent XSS (#15506) (8283c25)
- richtext-lexical: link tooltip overflows outside viewport with long URLs (#15584) (af6b1a1)
- ui: prevent Tabs field crash when stored tabIndex exceeds tab count (#15588) (a9e296e)
- ui: copy to locale function swallowing errors (#15562) (8ce62d8)
- ui: ensure unpublish button only shows when drafts are enabled (#15459) (69dc5e6)
⚙️ CI
- releaser always pull latest on release (#15566) (84344a2)
Feb 9, 2026
v3.76.0 (2026-02-09)

🚀 Features
- plugin-import-export: adds new exportLimit, importLimit and per collection limit control (#15405) (a7beeca)
🐛 Bug Fixes
- drizzle: use dynamic import for typescript to avoid dependency in production (#15545) (98a756c)
- live-preview-vue: update build config to compile as esm (#14293) (60c65ed)
- next: drop support for Next.js versions with known CVEs, add canary 16.2.0 support (#15547) (2b3061a)
- next: suppress webpack "Critical dependency" warning in dynamicImport (#15534) (6158489)
- plugin-import-export: errors when import/export files were stored in a storage adapter such as S3 (#15441) (73a9650)
- ui: tab error badge not counting required array validation errors (#15563) (0ce6193)
- ui: folder view toggle button styles overridden due to equal specificity (#15544) (df42bec)
- ui: remove clearData call in dropzone drop handler (#10475) (b4e6761)
📝 Templates
- fix deprecation warnings during install (#15536) (5edba8e)
- bump to 3.75.0 (#15533) (8ea162c)
⚙️ CI
- do not wait for generating int and e2e matrix (#15546) (de43402)
🏡 Chores
- fix deprecation warning when running reinstall or clean:all monorepo script (#15535) (03bfaf4)
- drizzle: add logs indicating which migration statements are generated (#15374) (306974d)
🤝 Contributors
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Sasha (@r1tsuu)
- Paul (@paulpopus)
- Daniel Waltz (@danielwaltz)
- Said Akhrarov (@akhrarovsaid)
Feb 5, 2026
v3.75.0 (2026-02-05)

🚀 Features
- adds beforeNav and afterNav component slots (#15493) (f23a1df)
- next: pass full initReq context to server functions and dashboard widgets (#15427) (ce13e97)
🐛 Bug Fixes
- handle absolute paths correctly with tempFileDir upload option (#14436) (5ca9bd4)
- ungenerated image sizes should not store original URL (#15454) (fa1cd62)
- add safety check to redirects from external file URL uploads (#15458) (1041bb6)
- sass warning not hidden during webpack build (#15442) (dec0ea7)
- add collection property to auth documents, fixing multi tenancy access control issue (#15404) (d6aa6cc)
- graphql: blocks return null with select: true (#15464) (c2baef4)
- next: versions diff error when swapping blocks with relationship fields (#15478) (5ba0055)
- next: export SlugField from the client dir not rsc (#15461) (6c07f3b)
- next: sync modular dashboard widgets when server component re-renders (#15439) (5495b47)
- plugin-ecommerce: variant creation blocked by variants in trash (#15449) (3f01682)
- plugin-mcp: create and update resource tools now support point fields (#15381) (a28261d)
- ui: extra padding rendering in list view when no description exists (#15507) (3ff6be4)
- ui: remove slug field from rsc exports (#15480) (8f66035)
⚡ Performance
- next: avoid re-calculating permissions in some server functions, pass missing args (#15428) (9c8be5c)
📚 Documentation
- jobs queue improvements (#15318) (3d357b3)
🎨 Styles
- run lint-staged commands in correct order (#15446) (731037e)
🧪 Tests
- trash e2e URL regex too strict and blocks query parameters (#15498) (57e759c)
- additional admin e2e coverage for templates (#15477) (63d63be)
- reorganize helpers into shared/e2e/int subdirectories (#15479) (b901231)
- enable figma adapter testing (#15467) (f4920d8)
- improve script to reset tests (#15328) (399b579)
- richText fields serialization (#15465) (fc99048)
- update suites selected by default in runTestsWithSummary (#15463) (603897d)
- trash auth e2e tests have race condition on navigation (#15468) (9bd5123)
⚙️ CI
- cache propagation workaround (#15469) (df0a75d)
🏡 Chores
- fix eslint config lookup in formatting hooks (#15516) (38a88b3)
- remove duplicative agents.md, document ai tool compatibility (#15472) (6216f56)
- remove template lockfiles (#15494) (362bf2f)
- replace magic strings with centralized constants (#15475) (8422668)
- claude post-write hook causes error when IDE checks output and doesn't apply formatting correctly (#15445) (033b943)
- claude: add playwright mcp (#15447) (f15b9a3)
- plugin-multi-tenant: use beforeNav instead of beforeNavLinks for tenant selector (#15499) (5d7d544)
🤝 Contributors
- sanbrien (@sanbrien)
- Neha Prasad (@naaa760)
- Kendell (@kendelljoseph)
- Sean Zubrickas (@zubricks)
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Jarrod Flesch (@JarrodMFlesch)
- Jake (@jacobsfletch)
- Kurt Tomlinson (@kurttomlinson)
- Colum Kelly (@columk1)
- German Jablonski (@GermanJablo)
- Jessica Rynkar (@JessRynkar)
- Elliot DeNolf (@denolfe)
Jan 30, 2026
v3.74.0 (2026-01-30)

🚀 Features
- thread override access in doc level hooks (#15421) (85d5263)
- extend strictDraftTypes to all draft operations (#15292) (9239164)
- add support for custom UnpublishButton component (#15400) (94254da)
- storage-r2: client uploads using R2 multipart api (#14733) (5c38902)
- ui: allows opting out of popup closing logic (#15407) (fb2b602)
- ui: allows customizing Popup component portal className (#15406) (0f55464)
Override Access in Document-Level Hooks - Access the overrideAccess value inside collection and global hooks. Useful when hook logic needs to know whether access control was bypassed, such as when querying related documents up a hierarchy. #15421
```
export const Posts: CollectionConfig = {
  slug: 'posts',
  hooks: {
    beforeChange: [
      ({ overrideAccess, req }) => {
        if (overrideAccess) {
          // Access control was bypassed
        }
      },
    ],
  },
}
```
Extended strictDraftTypes to All Operations - When strictDraftTypes: true is enabled, TypeScript now enforces draft type safety across all Local API operations (not just queries). The draft option is forbidden for collections/globals without drafts enabled, preventing silent runtime behavior where draft flags are ignored. #15292
```
import { buildConfig } from 'payload'

export default buildConfig({
  typescript: {
    strictDraftTypes: true, // Enables compile-time draft enforcement
  },
  // ...
})
```
⚠️ Note: Generic collection slugs may require explicit type assertions when using draft options.

Custom UnpublishButton Component - Customize the UnpublishButton in collection and global configs, following the same pattern as PublishButton and SaveButton. Previously hardcoded. #15400
```
export const Posts: CollectionConfig = {
  slug: 'posts',
  admin: {
    components: {
      edit: {
        UnpublishButton: '/components/CustomUnpublishButton',
      },
    },
  },
}
```
R2 Multipart Client Uploads (storage-r2) - Upload large files directly from the client using R2's multipart API. Files are split into smaller parts and uploaded separately, avoiding Cloudflare Worker memory limits. #14733

Popup Prevent Close Attribute (ui) - Add interactive elements inside popups without triggering close behavior by adding the data-popup-prevent-close attribute. #15407
```
<Popup>
  <button data-popup-prevent-close onClick={handleClick}>
    Click me without closing
  </button>
</Popup>
```
Popup Portal className (ui) - Customize the Popup component's portal container with the new portalClassName prop. #15406
```
<Popup portalClassName="my-custom-portal-class">
  {/* content */}
</Popup>
```
🐛 Bug Fixes
- isolate payload-preferences by auth collection (#15425) (2dc2e7c)
- traverseFields returning wrong parentPath dot notation for non-localised tabs (#15394) (99b051e)
- widgets and other features failing with transitive dependency imports (#15392) (5561799)
- replace deprecated scmp with crypto.timingSafeEqual (#15322) (2511c02)
- find afterRead hooks should behave like findByID (#15357) (3e27155)
- remove depth from count operation types (#15356) (dfc1600)
- publish button incorrectly shown after saving draft when access denied (#15319) (e833fe6)
- next: version view throws useLocale() server error (#15380) (2ce26fa)
- next: ensure query preset from url is applied (#15323) (592f404)
- next: ensure save preset button is not shown when there are no changes (#15320) (e9af097)
- plugin-cloud-storage: prevent infinite loop when cropping media (#15393) (345a9c7)
- plugin-cloud-storage: adds beforeChange hook to generate url on create (#15401) (d269d39)
- richtext-slate: localized indicator not displaying in label (#15412) (126f713)
- ui: use the formatAdminUrl function to generate unpublish url (#15375) (453e8a6)
- ui: restore default columns after clearing query preset (#15360) (029699d)
- ui: prevent globals crash with arrays fields when lock state user is undefined in handleDocumentLocking (#15259) (ea76ca0)
- ui: getEntityConfig did not respect globalSlug if collectionSlug is undefined (#15362) (b54059c)
📚 Documentation
- clarify beforeValidate and beforeChange hook data behavior (#15300) (ba9605e)
- add payload.logger.error usage guidelines to CLAUDE.md (#15398) (cdbfda2)
- updated redirects plugin integration docs and postgres connection troubleshooting (#15383) (9b2221e)
- improve select jsdocs and empty select docs (#15336) (4181a12)
🧪 Tests
- make integration tests for the fields and select suites faster (#15434) (26ba779)
📝 Templates
- deps: bump Next.js versions (#15365) (5658ec2)
🔨 Build
- add node-gyp for native module rebuilds (#15396) (50c087f)
⚙️ CI
- enable retries for int and unit tests (#15397) (8b21263)
- cache e2e prod preparation to run once instead of per-shard, various improvements and flake fixes (#15368) (2b3b9d5)
- automatically shard int tests (#15367) (1041b15)
- disable playwright tracing for first test runs, to improve performance and reduce flakes (#15337) (ab603c3)
- automatically shard e2e tests (#15366) (2f19f8f)
- add missing value property to outputs (#15338) (479b057)
- bump monorepo Node.js version from 23.11.0 to 24.13.0 (#15364) (d95c365)
- add linked PR feature to popular-issues action (#15355) (614f13c)
🏡 Chores
- export getSafeFileName utility (#15424) (6b45fee)
- replace rmdirSync to rmSync (#15420) (17c0a3f)
- claude: add respond-to-discussion-features claude command (#15391) (1f7fe63)
- deps: bump form-data, tar, wrangler, and @opennextjs/cloudflare dependencies (#15435) (5875cd0)
- deps: bump tsx (#15363) (7043e3f)
- plugin-multi-tenant: removes basePath arg (#15202) (bd80784)
- ui: move unpublish actions into document controls dropdown (#15417) (99d61db)
🤝 Contributors
- Ricardo Tavares (@rjgtav)
- Patrik (@PatrikKozak)
- German Jablonski (@GermanJablo)
- Jessica Rynkar (@jessrynkar)
- Jarrod Flesch (@JarrodMFlesch)
- Tobias Odendahl (@tak-amboss)
- Paul (@paulpopus)
- Elliot DeNolf (@denolfe)
- Sean Zubrickas (@zubricks)
- Alessio Gravili (@AlessioGr)
- Georg Schelkshorn (@GeorgS)
- Muhammad Hassaan Farooq (@Muhammad-Hassaan-Farooq)
- RajeshKumar11 (@RajeshKumar11)
Jan 23, 2026
v3.73.0 (2026-01-23)

🚀 Features
- next.js 16 support (#14456) (18ca83b)
- db-sqlite: add busyTimeout option (#15317) (0c235c3)
- db-sqlite: add WAL mode support (#15278) (3357aa6)
- drizzle: predefined migration for blocksAsJSON: true (#15257) (1b7b13d)
- live-preview: expose requestHandler arg to hooks (#15302) (4f3c31f)
- plugin-mcp: adds select API with CRUD tools (#15301) (268b33a)
- ui: use native useEffectEvent if available (#15304) (f0458fb)
Feature Details

🔥 Next.js 16 Support - Full compatibility with Next.js 16, including Turbopack HMR and build support. Requires Next.js >16.1.1-canary.35 or 16.2.0+. Templates will be updated after Next.js 16.2.0 is released. Stable Next.js 16.1.* is not supported, as we depend on fixes released in the Next.js canary. Support for cache components will follow in a future release #14456

WAL Mode Support (db-sqlite) - Enable SQLite Write-Ahead Logging for improved concurrent read/write performance. Configurable synchronous mode and journal size limit. #15278

Busy Timeout Option (db-sqlite) - Set maximum wait time in milliseconds when the database is locked, preventing SQLITE_BUSY errors in high-concurrency scenarios. #15317

Predefined Migration for blocksAsJSON (drizzle) - Migrate existing projects to use blocksAsJSON: true with a single command. Automatically updates your Payload config and generates the required migration. #15257
```
pnpm payload migrate:create --file @payloadcms/db-postgres/blocks-as-json
```
Request Handler in Live Preview Hooks (live-preview) - The useLivePreview hook (React and Vue) now accepts a requestHandler argument, allowing customization of data fetching. Useful when your frontend proxies requests or uses external middleware. #15302

Select API for MCP Tools (plugin-mcp) - Find, Create, and Update tools for Globals and Collections now support the select API, reducing token usage and aligning with Payload's existing query capabilities. #15301

Native useEffectEvent (ui) - Uses React's native useEffectEvent when available (React 19.2.0+), falling back to the existing polyfill for older versions. #15304

🐛 Bug Fixes
- select hasMany prevent duplicate values (#15218) (f4e8990)
- orderable fractional indexing case-sensitivity issue with PostgreSQL (#14867) (ef27ad9)
- find distinct sort on a different field (#15233) (e95f26d)
- conditional tabs breaking in Next.js 16 due to unstable tab id (#15270) (f5a7a00)
- correct previousValue and value in afterChange when using seo-plugin (#15253) (b6b6bab)
- db-mongodb: fix projection handling for relationship fields in GraphQL queries with select (#14850) (ace3447)
- drizzle: d1 sqlite IN querying of id when any other join is present in the query (#15290) (4f5a9c2)
- next: relationship fields with maxDepth: 0 show "Untitled - ID" in diff view (#15305) (65238c5)
- plugin-mcp: auto-detect basePath from Payload config routes (#15189) (dbc06f6)
- richtext-lexical: internal links render as href="#" in versions view (#15308) (ab4102c)
- sdk: correct return types with select (#15289) (db40d7b)
- ui: diff view columns have unequal widths for nested fields causing text misalignment (#15330) (db72a65)
- ui: upsertPreferences did not return preferences when creating new preferences (#15321) (94d5728)
- ui: pass the locale to reorder endpoint in orderable table (#14839) (d6bb3de)
📚 Documentation
- add jsdocs to query presets api (#15306) (3dbaed8)
- small md fix (#15299) (9a1eb77)
- remove csv as a language for code blocks (#15265) (259eac4)
📝 Templates
- upgrade website template and examples tailwind to v4 (#11197) (e77f9b6)
⚙️ CI
- prevent rate limiting in release-commenter action (#15298) (71b35fa)
🏡 Chores
- removes never implemented readDrafts access arg on globals (#15297) (12b679f)
- export fractional indexing utilities (#15286) (02800b0)
🤝 Contributors
- Sasha (@r1tsuu)
- Patrik (@PatrikKozak)
- Alessio Gravili (@AlessioGr)
- Kendell (@kendelljoseph)
- David Murdoch (@dsm23)
- Rafau (@RafalFilipek)
- Aaron Claes (@AaronClaes)
- Jarrod Flesch (@JarrodMFlesch)
- German Jablonski (@GermanJablo)
- Elliot DeNolf (@denolfe)
- Jens Becker (@jhb-dev)
- Paul (@paulpopus)
- Vladyslav Prosolupov (@vladyslavprosolupov)
- Jessica Rynkar (@jessrynkar)
Jan 16, 2026
v3.72.0 (2026-01-16)

🚀 Features
- adds experimental option localizeStatus and allows unpublish per-locale functionality (#14667) (d77af00)
- plugin-mcp: add depth parameter support to all MCP find resource tools (#14931) (c979fb3)
Localized Status (Experimental) - Each locale can now track and manage its own publication status independently. Publish or unpublish individual locales without affecting others, with locale-aware UI and version history. Requires enabling at both config and collection level. #14667
```
// payload.config.ts
export default buildConfig({
  experimental: {
    localizeStatus: true,
  },
  // ...
})

// collections/Posts.ts
export const Posts: CollectionConfig = {
  slug: 'posts',
  versions: {
    drafts: {
      localizeStatus: true,
    },
  },
}
```
⚠️ Migration Required: If you have existing version data, run the provided migration helper to convert _status fields from strings to locale objects. See PR #14667 for full migration guide.

Depth Parameter Support (plugin-mcp) - MCP resource tools now support a depth parameter (0-10) to control relationship population depth. Use depth: 0 for lightweight ID-only responses or higher values for fully populated relationship data. Significantly reduces token count when reading documents. #14931

🐛 Bug Fixes
- thumbnailURL hook, virtually populate from thumbnail size (#15232) (beeb269) (https://github.com/payloadcms/payload/commit/4f452ac))
- select in findByID with draft: true may return a wrong version (#14742) (49c9fa9)
- use window.location.origin as fallback for API URL copy (#15220) (a46e3a2)
- folder creation errors when collection uses translation function labels (#15216) (1a3aeb8)
- correct image size URLs in beforeChange (#15214) (da12eed)
- db-mongodb: hasMany relationship filtering with equals operator returns no results (#15204) (1756c0d)
- deps: bump undici to 7.18.2 to mitigate chained decompression (#15221) (591f9d2)
- plugin-ecommerce: issue with slug map ignoring variants and threading through cart data (#15234) (4b6529f)
- plugin-ecommerce: translations not being mapped correctly (#15205) (3337403)
- templates: prevent jobs run if secret unset (#15207) (8f50f83)
- translations: correct Russian translations for UI states in general section (#14953) (454042e)
- ui: truncates long JSON cells in list view (#9214) (6827978)
📚 Documentation
- fix beforeChange field hook documentation to reflect actual behaviour (#14798) (533ae92)
🧪 Tests
- fix race condition in language switcher helper (#15206) (f98d915)
- add @payloadcms/storage-s3 clientUploads integration test suite (#15194) (4dce061)
- fields with defaultValue should not be overwritten in upsert (#15197) (c684c6b)
⚙️ CI
- announce releases in discord general channel (#15201) (734453d)
🏡 Chores
- adds generate-translations claude skill (#15215) (f1f2be6)
- enforce no-console rule for @payloadcms/ui (#15195) (54db43d)
- plugin-redirects: add Swedish translation (#15213) (e19f432)
- translations: fixes to Swedish translation (#15212) (d3b12a1)
🤝 Contributors
- Jarrod Flesch (@JarrodMFlesch)
- German Jablonski (@GermanJablo)
- Vincent Vu (@rubixvi)
- Sasha (@r1tsuu)
- Paul (@paulpopus)
- Kendell (@kendelljoseph)
- Elliot DeNolf (@denolfe)
- Jens Becker (@jhb-dev)
- Patrik (@PatrikKozak)
- spiner2000 (@spiner2000)
- Marcus Forsberg (@marcusforsberg)
- Jessica Rynkar (@jessrynkar)
- Said Akhrarov (@akhrarovsaid)
- Jeffery To (@jefferyto)
Jan 13, 2026
v3.71.1 (2026-01-13)

🐛 Bug Fixes
- ui: remove debug console.log from Form component (#15191) (5529f9b)
🤝 Contributors
- Patrik (@PatrikKozak)
Jan 13, 2026
v3.71.0 (2026-01-13)

🚀 Features
- supersedes option to job queue concurrency controls (#15179) (9aeb843)
- add support for custom Status component in document controls (#11154) (ef863e6)
- add exclusive concurrency controls for workflows and tasks (#15177) (35fe09d)
- add bulkOperations.singleTransaction config option (#14387) (92da9fa)
- add support for additional IANA timezones, custom UTC offsets and overriding the timezone field (#15120) (a8785ba)
- ability to cancel current job from within workflow or task handlers (#15119) (1bd3146)
- add typescript.strictDraftTypes flag for opt-in draft query type safety (#14388) (58faafd)
- drizzle: include collection and global slugs in validation errors (#15147) (910d274)
- plugin-ecommerce: new hooks, cart logic moved to the server and fixed several bugs (#15142) (dcd4030)
- plugin-ecommerce: add new method refreshCart in useCart (#14765) (#14767) (529726e)
- plugin-import-export: refactor plugin and add import functionality (#14782) (13e6035)
- plugin-mcp: add draft parameter support to MCP find resource tool (#14924) (744a593)
- plugin-mcp: adds tools that can find and update globals (#15091) (f6d9873)
- plugin-nested-docs: add req parameter to GenerateURL and GenerateLabel types in nested docs (#14617) (6821a09)
- plugin-redirects: add Japanese translations (#15080) (c5b57f7)
- plugin-search: enables skipping of document syncing (#14928) (dfcf15c)
- sdk: automatically fallback to generated types attempt (#15167) (ae50d39)
- sdk: add proper error handling (#15148) (bfe2154)
Feature Details

Job Queue Concurrency Supersedes - Newer jobs can automatically delete older pending jobs with the same concurrency key. Enables "last queued wins" behavior for scenarios where only the latest state matters. #15179
```
concurrency: {
  key: ({ input }) => `generate:${input.documentId}`,
  exclusive: true,
  supersedes: true,  // Newer jobs delete older pending ones (not yet completed and did not start processing yet)
}
```
Exclusive Concurrency Controls - Prevents race conditions when multiple jobs operate on the same resource. Jobs with the same concurrency key will not run in parallel. Requires enableConcurrencyControl: true (will default to true in v4.0). #15177
```
export default buildConfig({
  jobs: {
    enableConcurrencyControl: true,
    workflows: [{
      slug: 'syncDocument',
      concurrency: ({ input }) => `sync:${input.documentId}`,
      handler: async ({ job }) => {
        // Only one job per documentId runs at a time
      }
    }]
  }
})
```
Job Cancellation from Handlers - Throw JobCancelledError from within a task or workflow handler to stop the job without retrying. #15119

Custom Status Component - Replace the Status section in document or global edit views without replacing the entire Edit view. Useful for custom locale publishing logic or additional status indicators. #11154
```
admin: {
  components: {
    edit: {
      Status: '/components/Status/index.tsx#Status',
    },
  },
},
```
Bulk Operations Single Transaction (db-mongodb) - Handle database transaction limitations when processing large numbers of documents in bulk operations. Useful for DocumentDB and Cosmos DB which have cursor limitations within transactions. #14387

Additional IANA Timezones & Custom UTC Offsets - Support for additional IANA timezone names via DateTimeFormat API validation, custom UTC offsets in ±HH:mm format, and the ability to override the timezone field configuration. #15120
```
{
  name: 'eventTime',
  type: 'date',
  timezone: {
    supportedTimezones: [
      { label: 'UTC+5:30 (India)', value: '+05:30' },
      { label: 'UTC-8 (Pacific)', value: '-08:00' },
      { label: 'UTC+0', value: '+00:00' },
    ],
  },
}
```
Override the timezone field:
```
{
  name: 'publishedAt',
  type: 'date',
  label: 'Published At',
  timezone: {
    override: ({ baseField }) => ({
      ...baseField,
      admin: {
        ...baseField.admin,
        disableListColumn: true, // Hide from list view columns
      },
    }),
  },
}
```
Strict Draft Types (typescript) - Opt-in strictDraftTypes flag for correct type safety when querying drafts. When enabled, find operations with draft: true will correctly type required fields as optional. Will become default in v4.0. #14388
```
export default buildConfig({
  typescript: {
    strictDraftTypes: true,  // defaults to false
  },
})
```
Validation Error Context (drizzle) - Unique constraint ValidationErrors now include data.collection or data.global for better error context when debugging. #15147

Server-Side Cart Logic (plugin-ecommerce) - Cart logic moved to the server with new REST API endpoints. New hooks: onLogin (merge guest cart with user cart), onLogout (clear session), clearSession, mergeCart, and refreshCart. Support for custom cart item matchers and MongoDB-style $inc operator for quantity changes. #15142
```
/**
 * Custom cart item matcher that includes fulfillment option.
 */
const fulfillmentCartItemMatcher: CartItemMatcher = ({ existingItem, newItem }) => {
  const existingProductID =
    typeof existingItem.product === 'object' ? existingItem.product.id : existingItem.product

  const existingVariantID =
    existingItem.variant && typeof existingItem.variant === 'object'
      ? existingItem.variant.id
      : existingItem.variant

  const productMatches = existingProductID === newItem.product

  const variantMatches = newItem.variant
    ? existingVariantID === newItem.variant
    : !existingVariantID

  const existingFulfillment = existingItem.fulfillment as string | undefined
  const newFulfillment = newItem.fulfillment as string | undefined
  const fulfillmentMatches = existingFulfillment === newFulfillment

  return productMatches && variantMatches && fulfillmentMatches
}
```
refreshCart Method (plugin-ecommerce) - Manually refresh cart state after direct modifications, allowing the UI to stay in sync without being blocked by addItem's uniqueness validation. #14767

Import Functionality (plugin-import-export) - Complete plugin refactor with new import functionality. Config is now per-collection with required collections array. Supports disabling import/export per collection and custom collection overrides. #14782 ⚠️ BREAKING CHANGE
```
importExportPlugin({
  overrideExportCollection: (collection) => {
    collection.admin.group = 'System'
    collection.upload.staticDir = path.resolve(dirname, 'uploads')
    return collection
  },
  overrideImportCollection: (collection) => {
    collection.admin.group = 'System'
    collection.upload.staticDir = path.resolve(dirname, 'uploads')
    return collection
  },
  collections: [
    {
      slug: 'posts',
      import: false, // disables import functionality, export enabled by default
    },
    {
      slug: 'pages',
      export: ({ collection }) => {
        collection.admin.group = 'System'
        collection.upload.staticDir = path.resolve(dirname, 'uploads')
        return collection
      },
      disableJobsQueue: true, // disable jobs queue for this collection only
    },
  ],
  debug: true,
})
```
Draft Parameter for MCP Find (plugin-mcp) - Query draft/unpublished documents via the MCP plugin's find tool using the new draft boolean parameter. #14924

Globals Support (plugin-mcp) - New MCP tools to find and update globals. #15091

Request Parameter in Nested Docs (plugin-nested-docs) - req parameter added to generateURL and generateLabel functions for more flexibility (e.g., reading current locale). #14617

Skip Sync (plugin-search) - Conditionally skip syncing documents to the search index based on locale, document properties, or other criteria. #14928
```
skipSync: async ({ locale, doc, collectionSlug, req }) => {
  if (!locale) return false

  const tenant = await req.payload.findByID({
    collection: 'tenants',
    id: doc.tenant.id,
  })

  return !tenant.allowedLocales.includes(locale)
}
```
Automatic Type Inference (sdk) - The SDK automatically uses your generated types via module augmentation—no need to manually pass GeneratedTypes. #15167
```
import { PayloadSDK } from '@payloadcms/sdk'

const sdk = new PayloadSDK({}) // Types inferred automatically from payload-types.ts
```
Proper Error Handling (sdk) - The SDK now throws PayloadSDKError on failed API requests with status, errors, response, and message properties. #15148
```
import { PayloadSDKError } from '@payloadcms/sdk'

try {
  await sdk.create({ collection: 'posts', data: { ... } })
} catch (err) {
  if (err instanceof PayloadSDKError) {
    console.log(err.status)  // 400
    console.log(err.errors)  // [{ name: 'ValidationError', message: '...', data: {...} }]
  }
}
```
Japanese Translations (plugin-redirects) - Localized admin UI strings for Japanese users. #15080

🐛 Bug Fixes
- wrong construction of urlToUse leads to false alert with logger.error (#15190) (ec6bba5)
- adds missing transactions to login and logout operations (#15134) (dd494be)
- set basePath from next config as env variable (#15154) (a8bfade)
- throw error on empty relationTo array and allow disabling lockDocuments on all collections (#14871) (9521ec6)
- add distinct validate to richtext field type definition (#15069) (d68e75a)
- exclude files from being sent to the form-state action (#15174) (aaea133)
- full image urls stored in DB (#15089) (d462f9b)
- field schema map paths (#10852) (d288752)
- custom OPTIONS endpoints are intercepted and cannot set custom CORS headers (#15153) (c103667)
- upload drawer not loading data for uploads without files (#15150) (00fb6e8)
- cannot read private member #headers error on Node.js 24 when using isolateObjectProperty (#15116) (e214deb)
- db-mongodb: avoid unnecessary $lookup when a join field is not selected (#15149) (e39b1b5)
- db-mongodb: exists operator on fields that have an array value in the db (#15152) (0afe200)
- db-mongodb: find id field from flattened fields (#15110) (40081f4)
- db-postgres: add filenameCompoundIndex baseIndexes for upload collections (#15182) (01f90c9)
- db-postgres: localized and hasMany/polymorphic relationships/uploads inside blocks (#15095) (01e4412)
- drizzle: unique field errors were not thrown as ValidationErrors (#15146) (43c19cb)
- live-preview: remove payload import (#15160) (ec658a4)
- plugin-cloud-storage: should persist external data returned by handleUpload (#15188) (7d80d21)
- plugin-cloud-storage: prevent deleting original file when duplicating (#14961) (9d54267)
- plugin-mcp: handle defaultDepth: 0 in api key authentication (#15014) (e0e058c)
- plugin-multi-tenant: cannot clear selected tenant from dashboard view (#15141) (cd77e5d)
- richtext-lexical,ui: make uploadNode default to alt user-defined values. (#15097) (3290b04)
- storage-*: add range headers to storage adapters (#14890) (ef90811)
- storage-s3: respect upload limits with client uploads (#15176) (4a6189e)
- templates: fix mobile menu auth buttons overflow in ecommerce template (#15020) (6c1109f)
- templates: improve cli detection in cloudflare template (#15098) (5d21ed1)
- templates: add recommended serverExternalPackages to cloudflare (#15094) (0eed581)
- translations: improve Japanese translations for naturalness and consistency (#15077) (88a901c)
- ui: ensure up-to-date upload preview thumbnails in admin panel (#15029) (6f4b272)
- ui: use optional chaining for potentiallyStalePath (#15185) (38cd67a)
- ui: virtual fields with virtual: true show sort chevrons in list view (#15186) (33c3630)
- ui: prevent text overlap in breadcrumbs (#15040) (0e27f19)
- ui: avoid creating hasMany options during IME composition (#15086) (98bc876)
- ui: duplicate document has unused serverURL dependency (#15178) (6d212b8)
- ui: bulk upload error count (#15155) (0a46f4e)
- ui: margins on small screens when using hideGutter in group (#15041) (22f94cd)
- ui: preserve beforeInput/afterInput components in bulk edit (#14954) (c62dc2a)
- ui: prevent wrong scroll target when adding rows in repeated array blocks (#15047) (f13a741)
- ui: crop width and height inputs limited to -1 of max (#15101) (3a6d3bd)
⚡ Performance
- optimized collection create when versions are enabled (#14885) (25813a7)
- graphql: optimized join count when docs are not needed (#14872) (6025eff)
🛠 Refactors
- clean up generated type resolution (#15163) (51d6cd2)
- deprecate returning failed state from job queue handlers (#15102) (070ded7)
📚 Documentation
- clarify available operations for beforeOperation hook (#14774) (8c59762)
- update link for MDN docs on cookies in requests (#15075) (0859f1c)
- updates custom upload component examples (#14678) (d3d8b4e)
- add graphql multi-field sort note (#15123) (14ac061)
- task failure docs (#15096) (81df3d6)
🧪 Tests
- remove silly tests from accessComposition unit tests (#15158) (cc33129)
- fixes flaky form state test (#15128) (251fc68)
- adds assert helpers to the a11y suite (#15132) (daf8061)
- running a11y test suite sequentially (#15130) (536582f)
- update outdated hardcoded postgres connection strings (#15114) (7930f44)
- fixes lexical block test flakes (#15113) (13edb8a)
⚙️ CI
- remove website post release notification (#15133) (5ebda61)
- deps: bumps setup-node version from 4 to 6 (#15122) (fe9119b)
🏡 Chores
- deprecate skip parameter from db-adapters (#15183) (ea15f00)
- add v4 comments for relationTo types (#15187) (d7351d5)
- upgrade to pnpm 10 (#15137) (1c8d515)
- refactor withPayload back to js (#15159) (44af1ad)
- plugin-mcp: adds config.admin.user as an optional default userCollection (#14989) (cdabf79)
- templates: replace arbitrary tailwind values with utilities in ecommerce template (#14654) (67cc734)
⚠️ BREAKING CHANGES
- plugin-import-export: refactor plugin and add import functionality (#14782) (13e6035)
  
  This PR works to refactor the entire plugin so it's easier for us to work with it going forward and also implements import functionality.
🤝 Contributors
- Sasha (@r1tsuu)
- Jeffery To (@jefferyto)
- Alessio Gravili (@AlessioGr)
- tapartdev (@tapartdev)
- Paul (@paulpopus)
- Patrik (@PatrikKozak)
- Elmo (@Spreizu)
- Jarrod Flesch (@JarrodMFlesch)
- German Jablonski (@GermanJablo)
- Jessica Rynkar (@jessrynkar)
- roboin (@Robot-Inventor)
- Tobias Odendahl (@tak-amboss)
- Rick Geersing (@RickGeersing)
- Dan Ribbens (@DanRibbens)
- Riley Langbein (@rilrom)
- David Wensley (@wensleyio)
- Bernhard Frick (@baer95)
- Said Akhrarov (@akhrarovsaid)
- Kendell (@kendelljoseph)
- Jiayi Wang (@Jeromestein)
- Jake (@jacobsfletch)
- Jens Becker (@jhb-dev)
- Sean Zubrickas (@zubricks)
- Anton Timmermans (@atimmer)
- Ricardo Tavares (@rjgtav)
- Marcin Gierada (@teastudiopl)
- Colum Kelly (@columk1)
- Elliot DeNolf (@denolfe)
- Jonathan Elmgren (@jonathanelmgren)
- Thomas Coldwell (@thomas-coldwell)
Jan 5, 2026
v3.70.0 (2026-01-05)

🚀 Features
- support qs-esm sort arrays in REST API (#15065) (2ccf898)
- richtext-lexical: adds docs page for lexical blocks, adds new lexical block component types and styles (#14971) (329115c)
Multi-Column REST API Sorting

Sort by multiple columns in the REST API using array syntax, aligning REST API behavior with the Local API. Previously only string-based sorting was supported. #15065
```
// Sort by multiple fields via REST API query string
// GET /api/posts?sort[0]=createdAt&sort[1]=-title

// Equivalent to Local API:
const posts = await payload.find({
  collection: 'posts',
  sort: ['createdAt', '-title'],
})
```
Lexical Blocks Documentation & Component Styles (richtext-lexical)

New documentation page for Lexical blocks with comprehensive examples showing usage and customization. Also introduces new block component types and styles for enhanced rich text editing. https://github.com/payloadcms/payload/pull/14971

See the https://payloadcms.com/docs/rich-text/blocks for full details.

🐛 Bug Fixes
- s3 plugin uploads files before validation (#14988) (502947b)
- add beforeDocumentControls to globals generate importmap (#15036) (4468197)
- warning during Next.js build "the request of a dependency is an expression" (#15007) (cd87ab4)
- next: turbopack build version check not working for 16.1.1 canaries (#15005) (ab68a2f)
- plugin-mcp: pin modelcontextprotocol/sdk dependency version to 1.24.0 (#15017) (1a9d665)
- storage-*: allow prefix to always exist as a field via alwaysInsertFields flag (#14949) (23a8689)
- ui: invalid sass imports to support windows - add Stylelint to prevent regression (#15028) (c66e953)
🧪 Tests
- fix console logs not appearing on vitest (#15008) (e3879bf)
- ensure vitest vscode extension env variables match CI (#15009) (f6248f9)
- migrate from jest to vitest eslint plugin, remove remaining jest references (#14997) (418375c)
🏡 Chores
- adds comment in image component (#14663) (6459ebc)
- bump nodemailer to 7.0.12 (security) (#15062) (aa61b31)
- narrow down files affected by vitest lint rules (#15000) (b97a063)
- claude: fix typo in claude skills access control advanced file (#15060) (5cbdca1)
- deps: bump dnd-kit (#15083) (07c36a3)
⚠️ BREAKING CHANGES

@payloadcms/storage-s3

Only users with custom hooks on S3 upload fields are affected — standard plugin usage is unchanged.
- External upload process for the S3 plugin has moved from beforeChange to afterChange as a result of fix: s3 plugin uploads files before validation (#14988)
This change was necessary to ensure that files uploaded to S3 have passed all validations and been saved to the document, preventing orphaned external files.

🤝 Contributors
- Alessio Gravili (@AlessioGr)
- Sean Zubrickas (@zubricks)
- Vincent Vu (@rubixvi)
- Paul (@paulpopus)
- Jessica Rynkar (@jessrynkar)
- Jonathan Elmgren (@jonathanelmgren)
- Patrikbjoh (@Patrikbjoh)
- Anders Semb Hermansen (@andershermansen)
- Riley Langbein (@rilrom)
- Elliot DeNolf (@denolfe)
Dec 19, 2025
v3.69.0 (2025-12-19)

🚀 Features
- modular dashboards - widgets (#13683) (f111624)
- adds cursor rules and AGENTS.md to templates (#14889) (19fcf99)
Modular Dashboards with Widgets

Introduces customizable admin dashboards with draggable, resizable widgets. Build personalized dashboard layouts with full keyboard accessibility for reordering and resizing. Future updates will add widget fields (props) for configurable widgets and dashboard presets for sharing layouts. #13683

https://github.com/user-attachments/assets/6c08d8d6-c989-4845-b56f-6d3fbd30b1af

See the RFC discussion for background and roadmap.

AI Development Resources (templates)

All templates now ship with AGENTS.md and .cursor/rules/ directory for improved AI-assisted development with tools like Copilot and Cursor. #14889

See more about AGENTS.md

🐛 Bug Fixes
- basePath not working properly with admin routes (#14967) (fa6b503)
- get field by path for blocks (#14984) (519a3c6)
- improves upload security for PDFs and SVGs (#14929) (61298c6)
- missing range headers (#14887) (ec7c192)
- next: status component incorrectly shows as published status on new documents saved as drafts when readVersions permissions are false (#14950) (394c024)
- plugin-mcp: adds collection and strategy to user (#14981) (042d7eb)
- plugin-multi-tenant: relationTo arrays inflating filterOptions where query size (#14944) (98b6791)
- richtext-lexical: blocksFeature with relationship exposes other tenants (#14985) (3025377)
- storage-s3: encode filename in generated URL (#14438) (86855e1)
- ui: use portals for popup to prevent clipping, improve keyboard navigation (#14910) (af09932)
🛠 Refactors
- replace deprecated url.parse api usage (#14980) (446cbb1)
📚 Documentation
- fix duplicate anchor links (#14976) (4c91d04)
- update screenshot for fields/rich-text (#14979) (2117dbf)
🧪 Tests
- migrate to vitest (#14337) (4e45432)
- move mongodb to different port to avoid port conflicts (#14993) (b4abd04)
- improve database test setup (#14982) (e3c512a)
- multi-tenant login tiles (#14940) (47f63fa)
🏡 Chores
- storage-s3: add int tests for filename encoding (#14970) (ef710e3)
🤝 Contributors
- Sasha (@r1tsuu)
- Alessio Gravili (@AlessioGr)
- Sean Zubrickas (@zubricks)
- Jarrod Flesch (@JarrodMFlesch)
- German Jablonski (@GermanJablo)
- Kendell (@kendelljoseph)
- Jake (@jacobsfletch)
- Jessica Rynkar (@jessrynkar)
- Paul (@paulpopus)
- Jens Becker (@jhb-dev)
- Patrik (@PatrikKozak)
Dec 15, 2025
v3.68.5 (2025-12-15)

🐛 Bug Fixes
- next: omit server url from route matching (#14919) (38c2f89)
🛠 Refactors
- add relative flag to formatAdminURL util (#14925) (4f12bee)
🤝 Contributors
- Jake (@jacobsfletch)
Dec 14, 2025
v3.68.4 (2025-12-14)

🐛 Bug Fixes
- previousValue from hooks should be populated within lexical blocks (#14856) (bb1501e)
- deps: enforce Next.js 15.4.10 (#14908) (7c675fa)
- next: properly construct local req url (#14907) (471cd1b)
- ui: show localized locale name for publish specific locale button (#14906) (848ea65)
- ui: relationship add button unsafe permissions property access (#14903) (127e41a)
📚 Documentation
- remove unused variable from custom field label translation (#14911) (77f96a4)
- update collection access control reference link on collection config page (#14905) (3a1eb77)
⚠️ BREAKING CHANGES
- deps: enforce Next.js 15.4.10 (#14908) (7c675fa)
  
  Address CVE-2025-67779.
🤝 Contributors
- Jake (@jacobsfletch)
- Riley Langbein (@rilrom)
- Jeffery To (@jefferyto)
- Aaron Claes (@AaronClaes)
- kat (@puzzlesremixed)
- Jessica Rynkar (@jessrynkar)
Dec 11, 2025
v3.68.3 (2025-12-11)

⚠️ Security Issue
- deps: bump minimum next version to 15.4.9 (#14898) (2ba4ee0)
A high-severity Denial of Service (CVE-2025-55184) and a medium-severity Source Code Exposure (CVE-2025-55183) affect React 19 and frameworks that use it, like Next.js.

Full details here: https://vercel.com/kb/bulletin/security-bulletin-cve-2025-55184-and-cve-2025-55183#how-to-upgrade-and-protect-your-next.js-app

While this is not a Payload vulnerability, it may affect any Payload project running on the affected versions of Next.js. Payload does not install any of these dependencies directly, it simply enforces their versions through its peer dependencies, which will only warn you of the version incompatibilities.

You will need to upgrade React and Next.js yourself in your own apps to the patched versions listed below in order to receive these updates.

Resolution

You are strongly encouraged to upgrade your own apps to the nearest patched versions of Next.js and deploy immediately.

Quick steps:

If using pnpm as your package manager, here's a one-liner:
```
pnpm add next@15.4.9
```
For a full breakdown of the vulnerable packages and their patched releases, see https://vercel.com/kb/bulletin/security-bulletin-cve-2025-55184-and-cve-2025-55183#how-to-upgrade-and-protect-your-next.js-app.

🐛 Bug Fixes
- passes serverURL through to all formatAdminURL calls (#14869) (b82356b)
🤝 Contributors
- Jake (@jacobsfletch)
- Jarrod Flesch (@JarrodMFlesch)
Dec 10, 2025
v3.68.2 (2025-12-10)

🐛 Bug Fixes
- next: use fileURLToPath for cross-platform path resolution (#14877) (e86098d)
Fixes Windows users getting ENOENT errors on dev startup.
- next: unhandled error in renderListView server function when no user present (#14878) (10a8f0f)
- next: merge user serverExternalPackages in withPayload (#14881) (dcecc46)
🛠 Refactors
- replace generic Error('Unauthorized') with UnauthorizedError (#14879) (c9a8aa0)
- next: remove unnecessary react hooks from DefaultTemplate rsc (#14876) (7a94cc1)
🏡 Chores
- translations: improve Vietnamese translations (#14886) (25ef7d1)
🤝 Contributors
- Rot4tion (@Rot4tion)
- Alessio Gravili (@AlessioGr)
- Maxim Seshuk (@maximseshuk)
Dec 9, 2025
v3.68.1 (2025-12-09)

🏡 Chores
- do not suggest vulnerable Next.js release in turbopack build error message (#14873) (9e0f593)
🤝 Contributors
- Alessio Gravili (@AlessioGr)
Dec 9, 2025
v3.68.0 (2025-12-09)

🚀 Features
- support turbopack build on Next.js canaries (#14845) (5ad4ebd)
Turbopack Build Support (next) - Automatically enables Turbopack Build compatibility when using Next.js ≥ 16.1.0-canary.3. The withPayload wrapper now detects supported versions and enables transitive dependency externalization, unlocking significantly faster production builds with Turbopack. #14845

🐛 Bug Fixes
- adds read and readDistinct to hook mapping (#14853) (0da0da8)
- undefined drafts error in collections with join fields (#14855) (3a29cec)
- use hasDraftsEnabled utility instead of direct check (#14843) (9c9c7c5)
- file objects being serialized to plain objects in upload form state (#14818) (d86c174)
- db-mongodb: correctly pass through collation config in the adapter to be applied in queries via locales (#11242) (db59cb4)
- plugin-multi-tenant: simplified getTenantOptions function and added access control for regular users (#14620) (f7cc078)
- storage-*: upload filename respects prefix (#14566) (ccfaee0)
- ui: component AddNewRelation saves relationTo as first collection instead of selected collection (#14836) (8c5c1fb)
- ui: list drawer per-page dropdown resets to 10 instead of showing saved limit (#14830) (db13a60)
📚 Documentation
- add note about returning a query from a readVersions access control (#14822) (0860837)
🧪 Tests
- speed up mongo test resets by preserving indexes (#14861) (d97a822)
🔨 Build
- add build:all:force to clean all then build all (d90bccb)
- bump swc-related dependencies (#14834) (617311a)
⚙️ CI
- remove prepack and prepublishonly scripts (#14832) (20914cc)
- add internal-debug release mode (#14820) (ce934b4)
🏡 Chores
- claude: create triage command (#14791) (d50b60e)
🤝 Contributors
- Elliot DeNolf (@denolfe)
- Alessio Gravili (@AlessioGr)
- Riley Langbein (@rilrom)
- Jarrod Flesch (@JarrodMFlesch)
- Adrian Maj (@AdrianMaj)
- Patrik (@PatrikKozak)
- Paul (@paulpopus)
- Jeffery To (@jefferyto)
- Rot4tion (@Rot4tion)
Dec 5, 2025
v3.67.0 (2025-12-05)

🚀 Features
- add groupBy support to query presets (#14808) (2b7aa7a)
- plugin-ecommerce: add ability to enable guest carts with reworked access config (#14565) (90c92f4)
GroupBy Support for Query Presets - Query presets now save and restore groupBy state when switching between presets. Previously, groupBy settings would persist across preset switches and weren't saved as part of the preset configuration. #14808
<img width="711" height="684" alt="Preset creation with group-by added" src="https://github.com/user-attachments/assets/5fe6ee88-6ed7-40f6-b190-df6b2e89460c" />

Guest Carts (plugin-ecommerce) - Enable guest users to create and manage carts without authentication. Carts created by guests are secured with a generated secret stored in local storage. Configure with allowGuestCarts (enabled by default). Also adds isLoading status to all hooks for conditional UI state. #14565
```
// Before
ecommercePlugin({
  access: {
    adminOnly,
    adminOnlyFieldAccess,
    adminOrCustomerOwner,
    adminOrPublishedStatus,
    customerOnlyFieldAccess,
  }
})

// After
ecommercePlugin({
  access: {
    adminOnlyFieldAccess,
    adminOrPublishedStatus,
    customerOnlyFieldAccess,
    isAdmin,
    isDocumentOwner,
  }
})
```
🐛 Bug Fixes
- add missing beforeInput and afterInput properties to UploadAdmin type (https://github.com/payloadcms/payload/issues/14775) (https://github.com/payloadcms/payload/commit/22a0255)
- add missing afterOperation and beforeOperation hook calls (https://github.com/payloadcms/payload/issues/14778) (https://github.com/payloadcms/payload/commit/e9cd2a5)
- sanitized versions type was incorrect (https://github.com/payloadcms/payload/issues/14810) (https://github.com/payloadcms/payload/commit/51c951f)
- plugin-multi-tenant: moves getGlobalViewRedirect from utilities to rsc exports (https://github.com/payloadcms/payload/issues/14817) (https://github.com/payloadcms/payload/commit/1340818)
- ui: autosave not queued while background process is in flight (https://github.com/payloadcms/payload/issues/14805) (https://github.com/payloadcms/payload/commit/14f042f)
- ui: ensure block error css only gets applied to the affected block (https://github.com/payloadcms/payload/issues/14826) (https://github.com/payloadcms/payload/commit/7520140)
- ui: missing translation support in SelectMany component (https://github.com/payloadcms/payload/issues/14819) (https://github.com/payloadcms/payload/commit/8fa91a5)
⚡ Performance
- cpa: use AST for templates (https://github.com/payloadcms/payload/issues/14648) (https://github.com/payloadcms/payload/commit/bad6680)
⚙️ CI
- clean up bug report template for auto-labeling (https://github.com/payloadcms/payload/commit/ebee8e1)
🏡 Chores
- claude: add coding patterns and best practices section (https://github.com/payloadcms/payload/issues/14829) (https://github.com/payloadcms/payload/commit/c5d8e68)
- deps: bump @types/react and @types/react-dom to 19.2.1 (https://github.com/payloadcms/payload/issues/14815) (https://github.com/payloadcms/payload/commit/d56796b)
- deps: bump next to 15.4.8 in root and test dirs (https://github.com/payloadcms/payload/issues/14811) (https://github.com/payloadcms/payload/commit/1c3417d)
⚠️ BREAKING CHANGES
- plugin-ecommerce: add ability to enable guest carts with reworked access config (https://github.com/payloadcms/payload/issues/14565) (https://github.com/payloadcms/payload/commit/90c92f4)
This PR introduce a breaking change into the plugin as it was necessary in order to provide more secure guest carts.

🤝 Contributors
- Paul (@paulpopus)
- Jake (@jacobsfletch)
- Jessica Rynkar (@jessrynkar)
- Elliot DeNolf (@denolfe)
- Patrik (@PatrikKozak)
- Jarrod Flesch (@JarrodMFlesch)
- Jens Becker (@jhb-dev)
Dec 3, 2025
v3.66.0 (2025-12-03)

⚠️ Security Issue

A critical-severity vulnerability in React Server Components (CVE-2025-55182) affects React 19 and frameworks that use it, including Next.js (CVE-2025-66478).

You are strongly encouraged to immediately upgrade your own apps to the nearest patched versions of React and Next.js.

While this is not a Payload vulnerability, it may affect any Payload project running on the affected versions of React or Next.js. Payload does not install any of these dependencies directly, it simply enforces their versions through its peer dependencies, which will only warn of the version incompatibilities.

You will need to upgrade React and Next.js yourself in your own apps to the patched versions listed below in order to receive these updates.

Quick steps:

If using pnpm as your package manager, here's a one-liner:
```
pnpm add react@19.2.1 next@15.4.8
```
To do this manually:
1. In your package.json:
  
  Bump react to 19.2.1
  
  Bump next to 15.4.8
2. Reinstall node modules, e.g. pnpm i
3. Redeploy your app
Here's a full breakdown of the vulnerable packages and their patched releases:

| Vulnerable package | Patched release | | ------------- | ------------- | | React | 19.0, 19.1, 19.2 19.0.1, 19.1.2, and 19.2.1 | | Next.js | 14.3.0-canary, 15.x, and 16.x (App Router) 14.3.0-canary.88, 15.0.5, 15.1.9, 15.2.6, 15.3.6, 15.4.8, 15.5.7, 16.0.7 |

See https://github.com/payloadcms/payload/issues/14807 for more details.

🚀 Features
- support custom slugify functions (#14117) (59a1607)
- accessibility testing and improvements (#14454) (42cbd70)
- support external JSON schema file references in type generation (#14749) (cb3a078)
- cpa: assume adapter for with-cloudflare-d1 template (#14799) (4f03016)
- richtext-lexical: add align support to upload nodes (#14720) (a21c47b)
Feature Details

Custom Slugify Functions - Override the default slug field behavior with your own slugify function. Useful for special character encoding, additional language support, or custom slug formatting. Also deprecates fieldToUse in favor of useAsSlug for consistency with useAsTitle. #14117
```
import type { CollectionConfig } from 'payload'
import { slugField } from 'payload'
import slugify from 'slugify';

export const MyCollection: CollectionConfig = {
  // ...
  fields: [
    // ...
    slugField({
      slugify: ({ valueToSlugify }) => slugify(valueToSlugify, {
        // ...additional `slugify` options here
      })
    })
  ]
}
```
Accessibility Testing and Improvements - Adds automated accessibility testing infrastructure including axe a11y scans, focus indicator checks, and horizontal scroll overflow detection. Covers all fields, major views, components, plugins, and Lexical editor. See the a11y report discussion for tracked issues. #14454

External JSON Schema References in Type Generation - Enables $ref pointers to external .json schema files in typescriptSchema field config. External references are resolved relative to process.cwd(). #14749
```
// payload.config.ts
{
  typescript: {
    schema: [
      ({ jsonSchema }) => {
        jsonSchema.definitions.MyType = {
          $ref: './schemas/my-type.json'
        }
        return jsonSchema
      },
    ]
  }
}
```
Auto-detect D1 Adapter (cpa) - The with-cloudflare-d1 template now automatically assumes the D1 database adapter, eliminating the database selection prompt during project creation. #14799

Upload Node Alignment (richtext-lexical) - Adds alignment support to upload nodes in the Lexical editor. Upload/media blocks can now be aligned left, center, or right using the FORMAT_ELEMENT_COMMAND. #14720

🐛 Bug Fixes
- remove "all" from JSDoc comment on supported http methods in endpoints (#14777) (8c8def9)
- should exclude svg files from file buffer mime validation (#14751) (015b363)
- deps: bump minimum react and next versions (#14807) (2dfe464)
- plugin-import-export: incorrect user type in Export causing runtime type mismatch (#14790) (61f5aee)
- plugin-multi-tenant: tenant modal not appearing when autosave is off (#14806) (b96e928)
- plugin-multi-tenant: auto assign tenant when autosave is enabled (#14745) (b0674fa)
- richtext-lexical: copying and pasting a single block in Lexical results in an error due to duplicate ID (#14738) (cd9addf)
- richtext-lexical: export serverInlineBlock modules (#14739) (becceb7)
- translations: translate slug field actions (#14784) (5542e56)
- ui: prevent NaN page parameter in polymorphic relationship pagination (#14795) (bbdfdb8)
- ui: reduce spacing between checkbox and first column when few columns shown (#14776) (6ae1bc8)
📚 Documentation
- documents block field image aspect ratio (#14679) (b6a336e)
- document default password reset URL (#14688) (a68423b)
- adds strongly typed examples (#14513) (abe8563)
🧪 Tests
- deflake sort e2e (#14746) (a07cf47)
📝 Templates
- update with-cloudflare-d1 to the latest OpenNext and wrangler (#14509) (5150388)
⚙️ CI
- auto-label issues (#14792) (ee632d4)
🏡 Chores
- claude: enable obra/superpowers plugin (#14789) (32df641)
⚠️ BREAKING CHANGES
- deps: bump minimum react and next versions (#14807) (2dfe464)e
🤝 Contributors
- Jarrod Flesch (@JarrodMFlesch)
- Jake (@jacobsfletch)
- German Jablonski (@GermanJablo)
- Elliot DeNolf (@denolfe)
- Sean Zubrickas (@zubricks)
- Patrik (@PatrikKozak)
- Paul (@paulpopus)
- Jessica Rynkar (@jessrynkar)
- Tobias Odendahl (@tak-amboss)
- Ricardo Tavares (@rjgtav)
Nov 25, 2025
v3.65.0 (2025-11-25)

❗️Breaking Change

This release disables Turbopack Build support. Please use Webpack to build your app for now. You can do so by using pnpm build on Next.js 15 and pnpm build --webpack on Next.js 16.

🚀 Features
- add augmentable interfaces for collection and global custom properties (#14729) (850c252)
- allow to specify payload instance cache key in handleEndpoints (#14675) (efa2fd2)
- db-mongodb: add afterCreateConnection and afterOpenConnection hooks (#14649) (af6ba86)
- plugin-mcp: add localization support to MCP resource operations (#14334) (a3f490b)
- plugin-mcp: adds a PayloadRequest to custom tool, prompt, and resource handlers (#14644) (0d14b06)
- ui: extract block selector from blocks drawer (#14697) (b9b11f0)
Type-Safe Custom Properties - Add augmentable interfaces for collection and global custom properties: CollectionCustom, CollectionAdminCustom, GlobalCustom, and GlobalAdminCustom. Enables type-safe plugin configuration at the collection/global level with full autocomplete support, matching the existing FieldCustom pattern. #14729
```
// Augment interfaces in your plugin or project
declare module 'payload' {
  export interface CollectionAdminCustom {
    disabledFields?: string[]
  }

  export interface CollectionCustom {
    myPluginConfig?: {
      enabled: boolean
      settings: Record<string, any>
    }
  }
}

// Now get full type safety in collections
export const Posts: CollectionConfig = {
  slug: 'posts',
  admin: {
    custom: {
      disabledFields: ['status'] // ✅ Type-safe!
    }
  },
  custom: {
    myPluginConfig: {
      enabled: true,
      settings: {}
    }
  }
}
```
Payload Instance Cache Key - Specify payloadInstanceCacheKey in handleEndpoints and createPayloadRequest to control which cached Payload instance is used for custom endpoints. Useful for multi-tenant scenarios or when managing multiple Payload instances. #14675

MongoDB Connection Lifecycle Hooks (db-mongodb) - Add afterCreateConnection and afterOpenConnection hooks to the MongoDB adapter for performing setup logic after connection/pool initialization. Enables use cases like connection pooling in serverless environments. #14649
```
export const databaseAdapter = mongooseAdapter({
  // ...
  afterOpenConnection: async (adapter) => {
    const client = adapter.connection.getClient()
    attachDatabasePool(client);
  },
})
```
MCP Localization Support (plugin-mcp) - Add full localization support to MCP resource operations (create, update, find, delete). All MCP tools now accept locale and fallbackLocale parameters, bringing feature parity with Payload's REST API for multilingual content management. #14334
```
// Create content in English
{ "name": "createPosts", "arguments": { "title": "Hello", "locale": "en" }}

// Add Spanish translation
{ "name": "updatePosts", "arguments": { "id": "123", "title": "Hola", "locale": "es" }}

// Retrieve all translations
{ "name": "findPosts", "arguments": { "id": "123", "locale": "all" }}
```
PayloadRequest in MCP Handlers (plugin-mcp) - Custom tool, prompt, and resource handlers now receive a PayloadRequest object, enabling access to the Payload instance and consistent access control patterns without additional lookups. #14644
```
// Previously
handler: async (args: Record<string, unknown>) => {}

// Now with req parameter
handler: async (args: Record<string, unknown>, req: PayloadRequest, _extra) => {
  // Access payload instance, user, locale, etc.
  const { payload, user, locale } = req
}
```
Reusable Block Selector Component (ui) - Extract BlockSelector component from BlocksDrawer and export for external use. Includes new onSelect callback for custom side effects when blocks are selected. #14697

🐛 Bug Fixes
- trigger login hooks after reset password (#14711) (32560e9)
- ensure restoreAsDraft only updates the published doc when draft is false (#14658) (3f3f5db)
- remove init of transaction for global doc access (#14693) (c455f58)
- count versions should allow querying on localized fields (#14695) (e1168a0)
- prevent upload mimeType error when useTempFiles is true (#14689) (fe8a3e8)
- autoRefresh not working due to stale closure and missing in client config (#14612) (8a3c6dc)
- type TypeWithVersion missing latest property (#14676) (9b6e1a3)
- graphql version error in production (#14622) (cd5b344)
- corrects outgoing localized data from afterRead (#14603) (87137fe)
- relationships should not fallback if fallbackLocale is false (#14641) (9f55254)
- hide turbopack warnings (#14640) (03f19bc)
- logout-inactivity route gets stuck on loading indicator when inactivity and isLoggedIn are true (#14596) (7a31c02)
- tighten up error visibility handling (#14606) (c74a40f)
- claude: properly structure claude plugin (#14432) (3198bbe)
- db-*: do not exit process on error during connect (#14647) (ab03163)
- db-mongodb,drizzle: prevent race condition in transaction session cleanup (#14651) (a7cf30d)
- drizzle: postgres 18 support (#14700) (294ebf5)
- next: remove turbopack build support to fix bundle size regression (#14696) (c484a05)
- next: prevent transaction race condition in renderDocument parallel operations (#14652) (802a21a)
- plugin-multi-tenant: fix infinite sync tenant network calls (#14604) (8901c7b)
- richtext-lexical: block names were not loaded (#14698) (c7a87c0)
- ui: ensures modal closes on route change (#14718) (a044a08)
- ui: query preset crash with empty filters in postgres/sqlite (#14722) (42a4384)
- ui: app header overflow on mobile (#14704) (91d3e04)
- ui: shows minRowsProp instead of minRows (#14681) (e40a4b7)
- ui: publish label regression from 14690 (#14692) (ba5834b)
- ui: publish button shows locale-specific text without localized fields (#14690) (caf68e4)
- ui: equals filter shows no results when value is cleared (#14673) (220a18f)
- ui: select/relationship field values have no tooltip on hover (#14662) (bc23084)
- ui: bulk uploads silently skips files without filenames (#14621) (8f14359)
- ui: relationship field label not updated when document is updated from other drawer (#14609) (0cc06a1)
- ui: duplicate should duplicate as draft by default (#14619) (fb05840)
⚡ Performance
- up to 5000% faster permissions calculation (#14631) (0d9ec91)
- plugin-mcp: removes 'override' config (#14598) (89ab526)
🛠 Refactors
- db-mongodb,drizzle: reduce race condition window between retrieving and using a session (#14653) (bd9f15f)
- ui: strongly type render-list server action (#14611) (337409b)
📚 Documentation
- clarify draft parameter and _status field interaction (#14723) (00d9156)
- add info about imports and ui best practices (#14702) (38f370a)
- adds examples for sending email attachments (#14665) (61547f9)
- updates node version in docker file (#14664) (276685d)
🧪 Tests
- deflakes localization e2e suite (#14639) (6e364fa)
- fix auth e2e test suite flakiness (#14655) (78d5be6)
- adjust test targeting to wait for input (#14614) (36f3cad)
- fix flaky toast assertions in draft validation tests (#14615) (62508ca)
🏡 Chores
- getLocalizedPaths should filter fields with locale-like names (#14661) (fd7c94c)
- updates MCP docs (#14625) (61c61fe)
- claude: further improve payload skill (#14705) (89be107)
- db-mongodb: export transform function (#14677) (51898f5)
⚠️ BREAKING CHANGES
- plugin-mcp: removes 'override' config (#14598) (89ab526)
  
  Removes override from the plugin config
  
  Updates documentation
🤝 Contributors
- Patrik (@PatrikKozak)
- MrLijan (@MrLijan)
- Jessica Rynkar (@jessrynkar)
- Alessio Gravili (@AlessioGr)
- Paul (@paulpopus)
- Sean Zubrickas (@zubricks)
- Elliot DeNolf (@denolfe)
- Jacob Fletcher (@jacobsfletch)
- Violet Rosenzweig (@6TELOIV)
- Kendell (@kendelljoseph)
- Dan Ribbens (@DanRibbens)
- Steven Ceuppens (@stevenceuppens)
- Jarrod Flesch (@JarrodMFlesch)
- Sasha (@r1tsuu)
- Zvonimir Bušić (@ZvonimirBusic)
Nov 13, 2025
v3.64.0 (2025-11-13)

🚀 Features
- add support for UTC timezone in date fields (#14586) (8b34e40)
- next: turbopack build support, fix incorrect handling of external packages (#14475) (3a975d7)
- plugin-mcp: adds MCP context to req.payloadAPI (#14595) (860bdf2)
- plugin-mcp: adds custom auth config (#14538) (73a18dc)
- plugin-redirects: support translations (#14548) (ad8f0b2)
UTC Timezone Support - Add support for 'UTC' as a timezone value in date fields. Previously unsupported due to validation against Intl API runtime values. Also fixes issue where having only one timezone would make it selected by default. #14586
```
import { buildConfig } from 'payload'

const config = buildConfig({
  admin: {
    timezones: {
      supportedTimezones: [
        {
          label: 'UTC',
          value: 'UTC',
        },
      ],
      defaultTimezone: 'UTC',
    },
  },
})
```
Turbopack Build Support - Full support for Turbopack builds (now default in Next.js 16). Properly externalizes database adapter entry points to prevent production failures. Resolves issues with direct dependency externalization causing runtime errors. #14475

MCP Context Detection - Detect when Payload API calls originate from MCP context using req.payloadAPI === 'MCP'. Enables conditional logic in hooks based on MCP usage. #14595
```
export const Posts: CollectionConfig = {
  slug: 'posts',
  hooks: {
    beforeRead: [
      ({ doc, req }) => {
        if (req.payloadAPI === 'MCP') {
          doc.title = `${doc.title} (MCP Hook Override)`
        }
        return doc
      },
    ],
  },
}
```
Custom Auth Configuration - Override default API key authentication with custom authorization logic using overrideAuth. Provides granular control over MCP access permissions. #14538
```
import { type MCPAccessSettings, mcpPlugin } from '@payloadcms/plugin-mcp'

plugins: [
  mcpPlugin({
    overrideAuth: (req) => {
      return {
        posts: { find: true },
        products: { find: true, update: true },
      } as MCPAccessSettings
    },
  })
]
```
Redirect Plugin Translation Support - Enable translations for plugin fields, eliminating need for verbose field overrides configuration. Configure field labels in multiple languages directly through i18n config. #14548
```
export default buildConfig({
  i18n: {
    translations: {
      en: {
        'plugin-redirects': {
          fromUrl: 'Source URL (Custom)',
        },
      },
      de: {
        'plugin-redirects': {
          fromUrl: 'Quell-URL',
          internalLink: 'Interner Link',
        },
      },
    },
  },
  plugins: [redirectsPlugin({ collections: ['pages'] })],
})
```
🐛 Bug Fixes
- previous value undefined for nested fields in afterChange (#14582) (d60ea6e)
- default values inconsistent between Local and REST APIs (#14556) (8f7ef35)
- findGlobalVersionByID id type (#14534) (99ed0e5)
- localized block fields (#14587) (2295c89)
- add secondary PDF mimeType validation and tests (#14529) (ce479ab)
- unlock access not being correctly denied when using a where query (#14585) (f63e34e)
- error when calling jobs.handleSchedules when there are no schedules defined (#14519) (072cb97)
- changing the language of the admin panel does not work for "radio" and "select" fields. (#14569) (bb520d6)
- inject custom translations into supportedLanguages in sanitization (#14549) (d7f1ea2)
- db-mongodb: localization transforms on nested localized fields (#14600) (6070d8d)
- db-mongodb: findVersions/findGlobalVersions not respecting limit of 0 (#14573) (43dcf84)
- graphql: avoid errors with sort as empty string (#14594) (fad476d)
- next: turbopack error when using db-d1-sqlite package (#14558) (bd6decf)
- next, ui: show status "changed" in List View (#14555) (565680d)
- plugin-form-builder: expose formSubmissionID as a variable to be used in emails (#14429) (ad74386)
- plugin-mcp: correctly uses local access controls (#14457) (fc2becf)
- richtext-lexical: urls being wrongly encoded by incomplete URL validation (#14557) (2cb0c59)
- storage-r2: respect data.prefix in handleUpload path construction (#14485) (454d0d3)
- ui: error on inserting new documents on uploads with hasMany (#14567) (fd44d2b)
- ui: save button becomes disabled after failed save with draft validation (#14584) (6fda71a)
- ui: invalid req.locale shows incorrect data (#14537) (f29a07f)
⚡ Performance
- ui: don't return full documents on bulk UI operations (#14145) (4430739)
🛠 Refactors
- richtext-slate: deprecate slate editor (#14536) (1a4ce44)
📚 Documentation
- updates Jobs queue docs (#14552) (dff3d1b)
🧪 Tests
- move draft validation tests from form-state to field error states test suite (#14599) (e1f07ff)
- run cpa against create-next-app latest and canary (#14583) (cca97c6)
- 21x faster versions int suite (#14510) (844f99f)
📝 Templates
- update next.js 15.4.4 to 15.4.7 (#14533) (d3b934c)
⚙️ CI
- fix ERR_PNPM_ADDING_TO_ROOT in create-payload-app int (#14581) (6789939)
🏡 Chores
- add .worktrees to .gitignore (87f2bd9)
- fix serverExternalPackages errors in monorepo (#14535) (e76da3f)
🤝 Contributors
- Kendell (@kendelljoseph)
- Jarrod Flesch (@JarrodMFlesch)
- Patrik (@PatrikKozak)
- Paul (@paulpopus)
- German Jablonski (@GermanJablo)
- Jessica Rynkar (@jessrynkar)
- Sasha (@r1tsuu)
- Sam (@damnsamn)
- Alessio Gravili (@AlessioGr)
- Tobias Odendahl (@tak-amboss)
- Elliot DeNolf (@denolfe)
- Jens Becker (@jhb-dev)
- Sean Zubrickas (@zubricks)
Nov 7, 2025
v3.63.0 (2025-11-07)

🚀 Features
- add support for polymorphic uploads (#14363) (df40d0e)
- adds new UI option Duplicate In [Select Locales] (#13803) (53d8557)
Polymorphic Uploads

Upload fields can now reference multiple upload collections, similar to polymorphic relationships. This enables more flexible media management where a single field can accept different types of files from various collections. Works seamlessly with bulk upload and hasMany options. #14363
```
import type { CollectionConfig } from 'payload'

export const ExampleCollection: CollectionConfig = {
  slug: 'example-collection',
  fields: [
    {
      name: 'media',
      type: 'upload',
      relationTo: ['images', 'documents', 'videos'], // references multiple upload collections
    },
  ],
}
```
Can also be combined with hasMany:
```
import type { CollectionConfig } from 'payload'

export const ExampleCollection: CollectionConfig = {
  slug: 'example-collection',
  fields: [
    {
      name: 'media',
      type: 'upload',
      relationTo: ['images', 'documents', 'videos'], // references multiple upload collections
      hasMany: true, // allows multiple uploads
    },
  ],
}
```
🐛 Bug Fixes
- use TSiblingData for previousSiblingDoc in FieldHook (#14503) (339a0c3)
- support generic types for kv.get (#14494) (f6194c6)
- group-by sticky pagination not rendering for virtual relationship fields (#14470) (648021c)
- ensure importMap is reliably generated during HMR (fixes Next.js 16 issue) (#14474) (61a7095)
- hmr not working in next.js 16 (#14462) (0231a8d)
- disable lockedDocuments if the kv adapter uses a collection (#14453) (827c9a1)
- drizzle: postgesql where in jsonb (#13742) (207295b)
- graphql: sort by multiple fields (#14486) (b925d34)
- next: withPayload wrapper next.js 16 support (#14473) (c0de75e)
- next: version._status field queried/returned for entities without drafts (#14423) (a22dff3)
- plugin-cloud-storage: file sizes use correct mime type (#11633) (2410296)
- richtext-lexical: prevent unnecessary requests for inline blocks (#14522) (69408f0)
- richtext-lexical: bulk upload drawer rendered at the wrong depth if already in a drawer (#14472) (4fd8d03)
- ui: virtual fields disappearing from filter/groupBy dropdowns with access control (#14514) (a3c0e84)
- ui: safely access fieldPermissions (#14458) (2393721)
- ui: simplify UI orderable collections table by allowing only ascending order (#14433) (eba6cfc)
⚡ Performance
- ui: avoid unnecessary remounting of DraggableSortable (#14463) (91e64b3)
🛠 Refactors
- use formatNames utility for interface name generation (#14481) (39bead7)
📚 Documentation
- hooks terminology update (#13847) (245576b)
- plugin-mcp: clarify example (#14325) (c8d6cf0)
🧪 Tests
- use new chromium headless browser for playwright, bump playwright (#14464) (2bb5535)
- multi-tenant flake (#14447) (80d7781)
📝 Templates
- remove payload cloud template, remove cloud plugin from templates (#14479) (76ba2df)
- remove outdated cloning and payload cloud information (#14484) (d4d9622)
🔨 Build
- add kv-redis to publishList (#14416) (6420927)
⚙️ CI
- speed up workflow reruns, remove run_number from build cache key (#14448) (f67d031)
- add kv and plugin-mcp to valid PR scopes (be0943a)
🏡 Chores
- standardize query param parsing (#14498) (3c9f56e)
- enables folders on website template (#14116) (219fba2)
- bump kv-redis version (ff670c0)
- claude: update claude PostToolUse hook to only format on write (9f2adeb)
- claude: set some sane defaults (#14445) (aa14d86)
- claude: add analyze-issue command (#14435) (f1456a0)
🤝 Contributors
- Sasha (@r1tsuu)
- Elliot DeNolf (@denolfe)
- Chris Rieckmann (@c-riq)
- Sam Wheeler (@swheeler7)
- Alessio Gravili (@AlessioGr)
- Slava Nossar (@slavanossar)
- Jacob Fletcher (@jacobsfletch)
- Patrik (@PatrikKozak)
- Paul (@paulpopus)
- Tobias Odendahl (@tak-amboss)
- Kendell (@kendelljoseph)
- Jessica Rynkar (@jessrynkar)
- German Jablonski (@GermanJablo)
- Sean Zubrickas (@zubricks)
- Violet Rosenzweig (@6TELOIV)
Nov 3, 2025
v3.62.1 (2025-11-03)

🐛 Bug Fixes

The KV implementation was requiring all postgres users to have to create a new migration. The following fix prevents that.
- disable lockedDocuments if the kv adapter uses a collection (#14453) (6930aaf)
Oct 30, 2025
v3.62.0 (2025-10-30)

🚀 Features

Jobs Access Control

Adds role-based access control for job queue and cancel operations, allowing you to restrict who can manage background jobs in your application. Both operations now support overrideAccess parameter and respect custom access control functions defined in your jobs configuration. #14404
```
// Configure access control
jobs: {
  access: {
    queue: ({ req }) => req.user?.roles?.includes('admin'),
    cancel: ({ req }) => req.user?.roles?.includes('admin'),
  }
}

// Use in Local API
await payload.jobs.cancel({
  where: { workflowSlug: { equals: 'sync' } },
  overrideAccess: false,
  req,
})
```
Per-Field Timezone Configuration

Date fields can now have individual timezone settings, allowing different date fields to support their own list of supported timezones with custom default values. This enables more flexible date handling across your application. #14410
```
{
  name: 'date',
  type: 'date',
  timezone: {
    defaultTimezone: 'America/New_York',
    supportedTimezones: [
      { label: 'New York', value: 'America/New_York' },
      { label: 'Los Angeles', value: 'America/Los_Angeles' },
      { label: 'London', value: 'Europe/London' },
    ],
  },
}
```
You can also enforce a specific timezone by specifying just one with a default value:
```
{
  name: 'date',
  type: 'date',
  timezone: {
    defaultTimezone: 'Europe/London',
    supportedTimezones: [
      { label: 'London', value: 'Europe/London' },
    ],
  },
}
```
KV Storage Adapters

Introduces a new key-value storage system with multiple adapter options (Database, In-Memory, Redis) for enhanced data persistence and performance. This provides the foundation for the upcoming Realtime API and other features requiring fast key-value access. #9913

Access the KV store via payload.kv with the following interface:
```
interface KVAdapter {
  /**
   * Clears all entries in the store.
   * @returns A promise that resolves once the store is cleared.
   */
  clear(): Promise<void>

  /**
   * Deletes a value from the store by its key.
   * @param key - The key to delete.
   * @returns A promise that resolves once the key is deleted.
   */
  delete(key: string): Promise<void>

  /**
   * Retrieves a value from the store by its key.
   * @param key - The key to look up.
   * @returns A promise that resolves to the value, or `null` if not found.
   */
  get(key: string): Promise<KVStoreValue | null>

  /**
   * Checks if a key exists in the store.
   * @param key - The key to check.
   * @returns A promise that resolves to `true` if the key exists, otherwise `false`.
   */
  has(key: string): Promise<boolean>

  /**
   * Retrieves all the keys in the store.
   * @returns A promise that resolves to an array of keys.
   */
  keys(): Promise<string[]>

  /**
   * Sets a value in the store with the given key.
   * @param key - The key to associate with the value.
   * @param value - The value to store.
   * @returns A promise that resolves once the value is stored.
   */
  set(key: string, value: KVStoreValue): Promise<void>
}
```
Configure the adapter using the kv property:
```
buildConfig({
  kv: adapter()
})
```
Database KV adapter (default) - Uses your existing database with a hidden payload-kv collection:
```
import { databaseKVAdapter } from 'payload'

buildConfig({
  kv: databaseKVAdapter({
    kvCollectionOverrides: {
      slug: 'custom-kv',
      ...(process.env.DEBUG === 'true' && {
        admin: { hidden: false },
        access: {},
      }),
    },
  }),
})
```
In Memory KV adapter - Fast memory-based storage for development:
```
import { inMemoryKVAdapter } from 'payload'

buildConfig({
  kv: inMemoryKVAdapter(),
})
```
Redis KV Adapter - Production-ready Redis integration:
```
pnpm add @payloadcms/kv-redis
```
```
import { redisKVAdapter } from '@payloadcms/kv-redis'

buildConfig({
  kv: redisKVAdapter({
    keyPrefix: "custom-prefix:", // defaults to 'payload-kv:'
    redisURL: "redis://127.0.0.1:6379" // defaults to process.env.REDIS_URL
  }),
})
```
Configurable Toast Position

Toast notifications can now be positioned anywhere on the screen (top-left, top-center, top-right, bottom-left, bottom-center, bottom-right), giving you control over where important messages appear to your users. This is particularly useful for applications with large screens or specific UI layouts. #14405

The position configuration is a direct pass-through of the Sonner library's position options, with 'bottom-right' remaining the default.

Feature PRs
- add access control for jobs queue and cancel operations (#14404) (0a37edb)
- timezone config can now be added on a per field basis (#14410) (a3df837)
- add KV storage adapters (#9913) (ffb9a2e)
- make toast position configurable (#14405) (d5fab43)
- ui: export useQueue React hook (#14396) (612880d)
🐛 Bug Fixes
- globals with versions return _status field when access denied (#14406) (b766ae6)
- custom dashboard component causes runtime error on create-first-user and account views (#14393) (d5f4e72)
- claude: remove invalid frontmatter fields (#14411) (118d005)
- db-*: findMigrationDir in projects without src folder (#14381) (059185f)
- db-mongodb: migration fails for cosmosDB (#14401) (10a640c)
- db-mongodb: type error with prodMigrations (#14394) (8e5e23a)
- db-mongodb: duplicate ids in sanitizeQueryValue (#11905) (36bb188)
- db-postgres: hasMany relationship/number/text fields inside blocks are incorrectly returned when using select (#14399) (850cc38)
- drizzle: number fields in generated schema with defaultValue (#14365) (8996b35)
- plugin-multi-tenant: remove unused syncTenants from useEffect deps (#14362) (906a3dc)
- richtext-lexical: do not run json.parse if value is undefined or null (#14385) (09a6140)
- richtext-lexical: prevent TS CodeBlocks from sharing Monaco model (useId) (#14351) (5caebd1)
- storage-*: update the client cache to use a map instead with cache keys per bucket config (#14267) (38f2e1f)
- ui: where builder crashing with invalid queries (#14342) (6c83046)
🛠 Refactors
- deprecate job queue depth property (#14402) (1341f69)
- ui: simplify ConfigProvider, improve useControllableState types and defaultValue fallback (#14409) (255320e)
⚙️ CI
- add claude as valid scope (560f2f3)
🤝 Contributors
- Dan Ribbens (@DanRibbens)
- Alessio Gravili (@AlessioGr)
- Paul (@paulpopus)
- Elliot DeNolf (@denolfe)
- Sasha (@r1tsuu)
- Patrik (@PatrikKozak)
- Ossaid Qadri (@imossaidqadri)
- Philipp Schneider (@philipp-tailor)
- Kholiavko Roman (@kholiavko-roman)
- Jacob Fletcher (@jacobsfletch)
- Séalan Cronin (@sealan)
- Jarrod Flesch (@JarrodMFlesch)
- Justus Blönnigen (@technicaldirector)
Oct 24, 2025
v3.61.1 (2025-10-24)

🐛 Bug Fixes
- ui: ask before closing doc drawer with edits (#14324) (c1d017a)
- filteredLocales in the client config are stale (#14326) (5a37909)
- db-*: querying joins with $exists on mongodb and improve performance when querying multiple times on postgres (#14315) (1f166ba)
- db-postgres: regression in migrations in the _rels table (#14341) (a2b1c9b)
- plugin-search: add locale to key in syncedDocsSet (#14289) (c29e1f0)
- ui: account for array values in transformWhereToNaturalLanguage (#14339) (f2cabe7)
- ui: preview button not responding to conditional URL (#14277) (ad0e7b2)
- ui: use depth: 0 for publish specific locale request (#14313) (b68715e)
📚 Documentation
- various grammar and typo fixes (#14170) (c96d50d)
- adds example for name or label on groups field (#14323) (6d88f7d)
🤝 Contributors
- Jarrod Flesch (@JarrodMFlesch)
- Boyan Bratvanov (@bratvanov)
- Sasha (@r1tsuu)
- Sean Zubrickas (@zubricks)
- Said Akhrarov (@akhrarovsaid)
- Paul (@paulpopus)
Oct 23, 2025
v3.61.0 (2025-10-23)

🚀 Features
- @payloadcms/plugin-mcp Released (BETA) - New plugin that enables Payload to function as an MCP server, allowing AI models to interact with your collections through a standardized protocol. The plugin provides built-in tools for CRUD operations on collections and supports custom tools. #13674
  
  MCP Documentation
  
  GitHub Discussion for feedback
🐛 Bug Fixes
- user updatedAt modified during session operations (#14269) (a1671ec)
- document header text clipping (#14291) (db973e9)
- typescript requires fields when draft: true despite passing draft: true (#14271) (1016cd0)
- blocks access control not respecting update access whether on collection or on a per field basis (#14226) (88cb687)
- allow slugField to accept localized argument and fixed slug generation with custom field names (#14234) (2ced43d)
- db-postgres: limit index and foreign key names length (#14236) (a63b4d9)
- drizzle: folders with trash enabled don't display documents in polymorphic joins (#14223) (6d3aaaf)
- plugin-form-builder: display full textarea content in form submissions (#14161) (24dad01)
- plugin-multi-tenant: block references issue (#14320) (4f8b7d2)
- plugin-search: exclude skipped drafts in reindex handler (#14224) (0dc782c)
- richtext-lexical: ensure block node form displays up-to-date value when editor remounts (#14295) (f8e6b65)
- richtext-lexical: node replacements ignored for block, inline block, upload, unknown and relationship nodes (#14249) (1561853)
- richtext-lexical, ui: ui errors with Slash Menu in Lexical and SearchBar component in RTL (#14231) (fed3bba)
- ui: document locked modal blocks interaction after clicking Go Back (#14287) (5782a41)
- ui: change password button being hidden and unlock button being shown incorrectly on account page (#14220) (bcb4d8e)
⚡ Performance
- richtext-lexical: decrease size of field schema, minor perf optimizations (#14248) (e25ce1c)
- richtext-lexical: do not return i18n from editor adapter (#14228) (54224c3)
🛠 Refactors
- richtext-lexical: ensure classNames of all nodes can be customized (#14294) (e1ef1d2)
📚 Documentation
- improve slate to lexical migration docs (#14309) (6838c56)
- db indexes - code example missing const (#14171) (3b37f4a)
- add explanation about re-renders in useFormFields (#14288) (8cdb5dc)
- add jsdocs to RichText adapter (#14246) (8b0ac01)
- clarify admin.timezones list configuration with example (#14238) (de5f3db)
- fix link to slug-overrides in text.mdx (#14211) (8136a84)
- add mention of the useUploadHandlers error and steps to remedy it with a mention to monorepos (#14233) (8663024)
🔨 Build
- add plugin-mcp to publishList (#14319) (894cf0c)
- add README sync for top-level -> packages/payload (#14316) (2aba827)
🏡 Chores
- extract snapshot logic, correct types in version ops (#14290) (c2dcd12)
- bump pino to v9.14.0 and pino-pretty (#14283) (b252658)
- refresh CLAUDE.md (#14268) (05a869d)
- cleanup, short-circuit .split calls (#14245) (d57be12)
🤝 Contributors
- Jarrod Flesch (@JarrodMFlesch)
- Elliot DeNolf (@denolfe)
- Kendell (@kendelljoseph)
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
- Boyan Bratvanov (@bratvanov)
- Paul (@paulpopus)
- German Jablonski (@GermanJablo)
- Bogdan Covrig (@bogdaaamn)
- Romain Pironneau (@romainpi)
- Sasha (@r1tsuu)
- Ahmed Abdellahi Abdat (@ahmed-abdat)
- Said Akhrarov (@akhrarovsaid)
Oct 16, 2025
v3.60.0 (2025-10-16)

🚀 Features
- accept multiple locales in fallbackLocale (#13822) (623a1b8)
- adds settingsMenu to admin navigation sidebar (#14139) (ee8b3cf)
- plugin-multi-tenant: allow collection access to be overridden via callback (#14127) (c40eec2)
- plugin-multi-tenant: allow hasMany on tenant field overrides (#14120) (fb93cd1)
- plugin-multi-tenant: user collection access overrides (#14119) (38b7a60)
- richtext-lexical: add collection filtering to UploadFeature, refactor relationship hooks (#14111) (6defba9)
- richtext-lexical: client-side block markdown shortcuts, code block (#13813) (07a1eff)
Localization
- Multiple fallback locales - fallbackLocale now accepts an array of locales for queries and locale configs. Payload will check each locale in order until finding a value, eliminating the need for manual fallback handling. #13822
  
  /** Local API **/ await payload.findByID({ id, collection, locale: 'en', fallbackLocale: ['fr', 'es'], }) /** REST API **/ await fetch(`${baseURL}/api/${collectionSlug}?locale=en&fallbackLocale[]=fr&fallbackLocale[]=es`) /** GraphQL **/ await restClient.GRAPHQL_POST({ body, query: { locale: 'en', fallbackLocale: ['fr', 'es']}, }) /** Locale Configs **/ locales: [ { code: 'en', label: 'English', fallbackLocale: ['fr', 'es'], }, ]
Admin UI
- Settings menu in navigation - New admin.components.settingsMenu config option adds a gear icon above the logout button. Click to open a popup menu with custom admin-level utilities and actions that don't fit into collection or global navigation. #14139
  <img width="174" height="239" alt="Screenshot 2025-10-14 at 11 43 37 AM" src="https://github.com/user-attachments/assets/5dca8ea7-ed99-4bc1-89c2-bc6da7d8f323" />
Multi-Tenant Plugin
- Collection access overrides - New accessResultOverride callback allows modifying multi-tenant access control results per operation (read, create, update, delete, readVersions, unlock). Enables custom logic like allowing shared content across tenants. #14127
  
  multiTenantPlugin<ConfigType>({ collections: { posts: { accessResultOverride: async ({ accessResult, accessKey, req }) => { // here is where you can change the access result or return something entirely different if (accessKey === 'read') { return { or: [ { isShared: { equals: true, } }, accessResult ] } } else { return accessResult } } } } })
- Multiple tenants per document - Tenant field overrides now support hasMany relationships, allowing documents to belong to multiple tenants. #14120
- User collection access overrides - New usersAccessResultOverride callback enables customizing access control on the users collection, overriding default tenant privacy when needed. #14119
  
  usersAccessResultOverride: ({ accessKey: 'read', // 'create', 'read', 'update', 'delete', 'readVersions', 'unlock' accessResult: AccessResult, // the `AccessResult` type ...args, // AccessArgs }) => { // this is where you could adjust what gets returned here. if (accessKey === 'read') { return true // over simplified example } // default to returning the result from the plugin return accessResult }
Lexical Rich Text
- Upload collection filtering - UploadFeature now supports disabledCollections and enabledCollections to control which collections appear in the upload drawer. Also refactors enabled relationships logic with cleaner useEnabledRelationships hook. #14111
- Client-side markdown shortcuts & code blocks - Blocks with admin.jsx now support markdown shortcuts on the client (previously server-only). Includes pre-made CodeBlock component for use in BlocksFeature. Also fixes readOnly handling across nested fields. #13813
  
  https://github.com/user-attachments/assets/cfc0d2a8-ffb3-4926-b097-ad9c2b133586
🐛 Bug Fixes
- findDistinct by explicit ID paths in relationships and virtual fields (#14215) (2b1b6ee)
- hasMany / polymorphic relationships to custom number IDs (#14201) (a3b3865)
- hide fields with read: false in list view columns, filters, and groupBy (#14118) (bcd40b6)
- validate Point Field to -180 to 180 for longitude and -90 to 90 for latitude (#14206) (13a1d90)
- urls in upload sizes are not encoded (#14205) (747a049)
- restoring trashed drafts with empty required fields fails validation (#14186) (3317207)
- db-d1-sqlite: add missing blocksAsJSON property (#14103) (f14a38e)
- db-mongodb: documents not showing in folders with useJoinAggregations: false (#14155) (e613a78)
- db-mongodb: improve check for ObjectId (#14131) (32e2be1)
- graphql: bump tsx version to get around esbuild vulnerability (#14207) (d7ec48f)
- next: custom views not overriding built-in single-segment routes (#14066) (691f810)
- plugin-multi-tenant: object reference mutations in addFilterOptionsToFields (#14150) (e62f1fe)
- richtext-lexical: state key collisions when multiple TextStateFeatures are registered (#14194) (f01a6ed)
- richtext-lexical: editor throws an error if OrderedList is registered but not UnorderedList or CheckList (#14149) (1fe75e0)
- richtext-lexical: editing a copied inline block also modifies the original (#14137) (5bacb38)
- richtext-lexical: correctly type field property of RenderLexical (#14141) (cd94f8e)
- richtext-lexical: improve type autocomplete and assignability for lexical nodes (#14112) (a46faf1)
- sdk: pagination is not passed to search params (#14126) (ee9f160)
- storage-gcs: bump @google-cloud/storage for vulnerability (#14199) (1077aa7)
- storage-r2: uploads with prefix don't work, add test/storage-r2 (#14132) (4fd4cb0)
- templates: encoding and decoding slugs in website template (#14216) (cacf523)
- templates: ecommerce seeding issue (#14196) (d65b8c6)
🛠 Refactors
- richtext-lexical: add jsdoc to deprecated HTMLConverterFeature (#14193) (0b718bd)
📚 Documentation
- revert sentry docs change (#14113) (8844eaf)
- incorrect pg driver injection example in Sentry integration docs (#14088) (95dbaed)
🧪 Tests
- allows running Jest tests through Test Explorer in VSCode and other improvements (#13751) (0d92a43)
⚙️ CI
- notify website repo on release [skip ci] (#14140) (a36e5d2)
- add website dispatch event, testing for releases [skip ci] (#14138) (b0d31ba)
- add missing labels to bug report template [skip ci] (#14134) (3069e5b)
- update generate-template-variations script to cover cloudflare template (#14105) (e78057b)
🏡 Chores
- better audit dependencies script (#14189) (f9e75a4)
- ignore agent local files [skip ci] (#14184) (7ecb5a0)
- drizzle: bump drizzle-orm and drizzle-kit for vulnerabilities (#14200) (4afa286)
- email-nodemailer: bump nodemailer dependencies to latest (#14121) (077c6f5)
🤝 Contributors
- Sasha (@r1tsuu)
- Patrik (@PatrikKozak)
- Paul (@paulpopus)
- Jessica Rynkar (@jessrynkar)
- German Jablonski (@GermanJablo)
- Elliot DeNolf (@denolfe)
- Elliott W (@elliott-w)
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
- Diogo Gaspar (@shadowoff09)
Oct 7, 2025
v3.59.1 (2025-10-07)

🐛 Bug Fixes
- revert drizzle-orm (#14108) (ee78eb2)
- plugin-multi-tenant: not setting cookie properly on login (#14107) (5590535)
- ui: update memory user when autoLogin enabled (#14018) (c2fa629)
⚙️ CI
- update activity notification channels (72be9d3)
🏡 Chores
- update lock (7e12880)
🤝 Contributors
- Jarrod Flesch (@JarrodMFlesch)
- Elliot DeNolf (@denolfe)
Oct 7, 2025
v3.59.0 (2025-10-07)

🚀 Features
- slug field (#14007) (b09ae67)
- support any depth for relationships in findDistinct (#14090) (e4f8478)
- adds disableGroupBy to fields admin props (#14017) (537f58b)
- allow findDistinct on fields nested to relationships and on virtual fields (#14026) (9d6cae0)
- bundle types (#14020) (9bcb7b0)
- cpa: add cloudflare template to create-payload-app command (#14091) (e8140ed)
- db-*: adds support for readReplicas in D1 adapter config (#14040) (5a6f361)
- db-mongodb,drizzle: add atomic array operations for relationship fields (#13891) (7eacd39)
- next: export views, pass all props to custom dashboard view (#14094) (abebd24)
- plugin-nested-docs: pass collection config as an arg to generateURL and generateLabel (#14086) (db6ec30)
- ui: add support for disabling join field row types (#12738) (cd546b3)
- ui: live preview conditions (#14012) (2be6bb3)
🐛 Bug Fixes
- add detection for --experimental-https flag (#14085) (3cf3f93)
- missing cross-env in deploy:database (#14076) (709ee58)
- support USE_HTTPS for local hmr (#14053) (feaa395)
- update packages list for pnpm payload info (#14030) (4b6b0c5)
- autosave: true doesn't work on payload.update with where (#14001) (5d86d5c)
- db-d1-sqlite: avoid bound parameter limit when querying relationships and inserting rows (#14099) (444ca0f)
- db-mongodb: localized blocks with fallback and versions (#13974) (1e654c0)
- db-postgres: drizzle doesn't recognize types from the generated types (#14058) (ef84b20)
- db-postgres: querying multiple hasMany text or number fields (#14028) (95bdffd)
- db-postgres: joins count with hasMany relationships (#14008) (1510e12)
- drizzle: generate DB schema syntax is deprecated (#14031) (ef57d24)
- graphql: error querying hasMany relationships when some document was deleted (#14002) (48e9576)
- next: force inactive live preview after passing conditions (#14048) (ca3f054)
- next: prevent locale upsert when not authenticated (#13621) (ece5a95)
- plugin-ecommerce: variants validateOptions errors with SQLite when creating a new variant (#14054) (3b9e759)
- plugin-multi-tenant: rm chalk dep (#14003) (d017499)
- plugin-search: handle trashed documents in search plugin sync (#13836) (de352a6)
- richtext-lexical: field.admin overrides were ignored in RenderLexical helper (#14024) (810da54)
- richtext-lexical: slash menu arrows keys not respected when block nearby (#14015) (54b6f15)
- sdk: incorrect fetch initialization on cloudflare (#14009) (a5c8b5b)
- storage-r2: upload with the correct contentType (#13988) (066997d)
- storage-uploadthing: hide key field from filters and columns (#14004) (2ce6e13)
- templates: ignore wrangler when bundling to fix template styles (#14067) (c135bf0)
- templates: added missing CLOUDFLARE_ENV in cloudflare template when optimizing database (#14064) (9fcd1fa)
- templates: don't use remote bindings in cloudflare template when developing locally (#14063) (9d3e540)
- templates: ecommerce wrong links in readme and docs and issue with missing graphql dependency (#14045) (e4f90a2)
- templates: correct typo in footer text (#14021) (a938ad6)
- translations: refine Persian (fa) translations for clarity and natural tone (#14082) (990603c)
- translations: fixes to Icelandic translations (#14038) (7088d25)
- translations: fixes to Swedish translation (#13994) (4b193da)
- ui: phantom fields when duplicating rows with rows (#14068) (08f6d99)
- ui: invalid time value error when document locking with autosave enabled (#14062) (394000d)
- ui: undefined access with polymorphic joins and fix joins test config (#14057) (cb7a24a)
- ui: popup list controls overlap with table in list view (#13967) (1e23882)
- ui: upload dropzone error when collectionConfig is undefined (#14043) (62fcf18)
- ui: saving empty code editor throw error (#14019) (bffb9ef)
- ui: add support back for custom live preview components (#14037) (d826159)
- ui: array fields not respecting width styles in row layouts (#13986) (accd95e)
⚡ Performance
- graphql: select only the requested columns (#13711) (c819083)
- templates: added cloudflare cache headers for static files (#14069) (c59df45)
📚 Documentation
- readme changes - add one-click deployment options and improve templates section (#14092) (a88e3c5)
- update README.md (#11297) (c8661da)
- adds comprehensive virtual field configuration documentation (#13942) (10e5042)
- db-mongodb: fix note on indexing localized fields (#14071) (9c08fb8)
📓 Examples
- fix revalidation hook in localization example (#14014) (267ea9e)
⚙️ CI
- update pr-title commit scopes (#14055) (fa28dca)
- add linked PRs to new issue notifications (#14059) (bbff65c)
🏡 Chores
- ci changes to add compatibility for mongodb alternates (#13898) (9ceee8e)
- update d1 cloudflare template package versions (#13977) (7601835)
- eslint: set reportUnusedDisableDirectives to error (#14011) (209b1f1)
- templates: bump sharp version in ecommerce template (#14089) (836e0f7)
🤝 Contributors
- Jacob Fletcher (@jacobsfletch)
- Sasha (@r1tsuu)
- Paul (@paulpopus)
- Alessio Gravili (@AlessioGr)
- Dan Ribbens (@DanRibbens)
- Nate Caminata (@ncaming)
- Marwin Hormiz (@marwinhormiz)
- rfwn࿐ (@rfwn)
- Jeffery To (@jefferyto)
- Ricardo Tavares (@rjgtav)
- Patrik (@PatrikKozak)
- Kamal (@kamal0620040)
- Elliot DeNolf (@denolfe)
- gursh (@gurshdev)
- Said Akhrarov (@akhrarovsaid)
- Jarrod Flesch (@JarrodMFlesch)
- Riley Langbein (@rilrom)
- Valur Sverrisson (@Valur)
- Marcus Forsberg (@marcusforsberg)
- Aurimar Lopes (@AurimarL)
- Jan Beck (@jancbeck)
- Tobias Odendahl (@tak-amboss)
Sep 30, 2025
v3.58.0 (2025-09-30)

🚀 Features

Ecommerce plugin and template (#8297) (ef4874b)

The Ecommerce Template and Plugin is now ready in beta, you can get started by running the Payload CPA command below
```
pnpx create-payload-app my-project -t ecommerce
```
Full docs are available on our website

Payload SDK package (#9463) (92a5f07)

Allows querying Payload REST API in a fully type safe way. Has support for all necessary operations, including auth, type safe select, populate, joins properties and simplified file uploading. Its interface is very similar to the Local API.
```
import { PayloadSDK } from '@payloadcms/sdk'
import type { Config } from './payload-types'

// Pass your config from generated types as generic
const sdk = new PayloadSDK<Config>({
  baseURL: 'https://example.com/api',
})

// Find operation
const posts = await sdk.find({
  collection: 'posts',
  draft: true,
  limit: 10,
  locale: 'en',
  page: 1,
  where: { _status: { equals: 'published' } },
})
```
New Cloudflare D1 SQLite adapter, R2 storage adapter and Cloudflare template (#12537) (99043ee)

You can now deploy directly to Cloudflare using our 1-click template or click the deployment button below

🐛 Bug Fixes
- ensure blocks filterOptions are awaited (#13960) (41aa201)
- sanitize collection labels to inherit defaults when only a partial config is provided (#13944) (1752043)
- avoid relying on Function.prototype.name to detect react components (#13931) (4652bd0)
- next: static live preview url corrupt after save (#13949) (3c4f8a3)
- plugin-multi-tenant: properly localize labels (#13943) (2cc34d1)
- richtext-lexical: editor re-mounting on save due to json key order not being preserved in postgres (#13962) (6a2e814)
- ui: query preset where field not displaying array values (#13961) (9248fc4)
- ui: move collection description below title in document view (#13946) (ae34b6d)
⚙️ CI
- add @payloadcms/sdk to publish list (#13964) (f9743b4)
- add cron to activity notifications [skip ci] (#13959) (6d995ff)
- proper path for activity notifications [skip ci] (2514e4d)
- activity-notifications debug inputs (ba33f2f)
- github activity slack notifications (#13955) (4562df7)
🏡 Chores
- update templates and docs links (#13971) (d7888df)
- rename activity notifications workflow (f7b1b7b)
- sdk: add README (#13975) (2e1fb57)
🤝 Contributors
- Elliot DeNolf (@denolfe)
- Sasha (@r1tsuu)
- Paul (@paulpopus)
- Patrik (@PatrikKozak)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Jarrod Flesch (@JarrodMFlesch)
- Luke Sandberg (@lukesandberg)
Sep 25, 2025
v3.57.0 (2025-09-25)

🚀 Features
- adds admin.formatDocURL function to control list view linking (#13773) (1d1240f)
- conditional blocks (#13801) (d8dace6)
- support hasMany virtual relationship fields (#13879) (1072171)
- next: regenerate live preview url on save (#13631) (00a673e)
- plugin-form-builder: allow creating form submissions from the admin panel (#11222) (104a5fc)
- plugin-multi-tenant: improves tenant assignment flow (#13881) (fcb8b5a)
- richtext-lexical: support copy & pasting and drag & dopping files/images into the editor (#13868) (59414bd)
- richtext-lexical: utility render lexical field on-demand (#13657) (1c89291)
- translations: add Tamil translations (#13788) (7975fe3)
🐛 Bug Fixes
- server component readonly state issues with document locking (#13878) (512a8fa)
- make input/output encoding explicit in auth/crypto's encrypt/decrypt (#13710) (7f35213)
- pagination returning duplicate results when timestamps: false (#13920) (062c1d7)
- add missing translation key (#13902) (39143c9)
- findDistinct with polymorphic relationships (#13875) (e99e054)
- admin.hidden not respected for RSCs, render-field server function not respecting field-overrides client-side (#13869) (228e8f2)
- exits handlers loop if response is returned (#13866) (425172c)
- support hasMany: true relationships in findDistinct (#13840) (d0543a4)
- removes select argument from create operation db calls (#13841) (a26d8d9)
- db-postgres: localized relationships inside blocks (#13760) (22ae9fa)
- db-sqlite: exists operator in createJSONQuery (#13907) (f980a86)
- graphql: graphql tab schema not handling tabs correctly (#13850) (83b6e37)
- next: clear bfcache on forward/back (#13913) (f868ed9)
- next: groupBy for polymorphic relationships (#13781) (9c20eb3)
- plugin-import-export: collectionSlug field regression from hidden field changes (#13917) (96c6612)
- plugin-multi-tenant: ensure relationship filter filters based on doc.tenant (#13925) (cbbf98e)
- plugin-multi-tenant: improve Norwegian translation for "tenant" (#13923) (dea91f3)
- plugin-search: transaction state errors in parallel reindex operations (#13915) (79b2557)
- plugin-search: returns doc instead of empty return (#13916) (68882aa)
- plugin-seo: allow number ids & resolved relations for image auto-generation (#13906) (abbe38f)
- richtext-lexical: remove unexpected spaces in link html converter (#13924) (c230005)
- richtext-lexical: richtext field duplicates description custom component (#13880) (66f5d14)
- richtext-lexical: prevent disallowed headings to be pasted (#13765) (207caa5)
- translations: adjust some zh translations (#13867) (ae7b75a)
- translations: correct Ukrainian language translations (#13639) (5b5eaeb)
- translations: missing noLabelGroup translation key for Tamil translations (#13896) (cb23aaf)
- ui: opening relationship field with appearance: "drawer" inside rich text inline block closes drawer (#13830) (7bbd07c)
- ui: corrects url for publish specific url (#13922) (662bab2)
- ui: array field state to return empty array instead of 0 (#11283) (3f5c989)
- ui: folder filters hidden behind results (#13908) (5c81342)
- ui: custom folder slug in browse-by (#13909) (4975b8d)
- ui: query folder children with depth and select (#13910) (984f1b3)
- ui: revert-to-published button showing on new drafts (#13897) (82d98ab)
- ui: bulk upload with locale param (#13865) (667c4f1)
- ui: ensures visible list view thumbnails with enableListViewSelectAPI (#13864) (82aade2)
- ui: respect editorOptions, prevent field from flashing on save (#13848) (5241113)
- ui: set prefetch false on Link buttons (#13846) (33228d9)
⚡ Performance
- graphql: use depth 0 in auth/apiKey for graphQL requests (#13895) (9a59562)
- ui: use select API in RelationshipProvider to speed up load times in RelationshipCell (#13832) (77cac30)
🛠 Refactors
- richtext-lexical: new upload node design (#13901) (bea77f2)
- translations: correct i18n translation for Norwegian (#13854) (b7f6e3c)
📚 Documentation
- corrects link for experimental features topic (#13862) (b1e5bd9)
- clarify JWT token encryption / decryption in configuration docs (#13816) (0a5b7b0)
⚙️ CI
- remove v2 issue template (f39c7bf)
🏡 Chores
- revert docs label change (c33c037)
- update documentation issue template (ae95d58)
- consolidate canAccessAdmin logic (#13849) (42b5935)
- deps: bump @faceless-ui/modal to v3.0.0 (#13842) (9a8e3f8)
🤝 Contributors
- Alessio Gravili (@AlessioGr)
- Elliot DeNolf (@denolfe)
- Dan Ribbens (@DanRibbens)
- roboin (@Robot-Inventor)
- Jacob Fletcher (@jacobsfletch)
- Anders Semb Hermansen (@andershermansen)
- Jie Wang (@escwxyz)
- aptt (@apttx)
- Ricardo Tavares (@rjgtav)
- Patrik (@PatrikKozak)
- Jarrod Flesch (@JarrodMFlesch)
- Sasha (@r1tsuu)
- Jessica Rynkar (@jessrynkar)
- Паламар Роман (@VeiaG)
- Anil Shebin S J (@AnilShebin)
- German Jablonski (@GermanJablo)
- Jens Becker (@jhb-dev)
- Sean Zubrickas (@zubricks)
- Kwan Jun Wen (@junwen-k)
Sep 17, 2025
v3.56.0 (2025-09-17)

🚀 Features
- pass args to task onSuccess and onFail callbacks (#13269) (3acdbf6)
- crons for all bin scripts, new jobs:handle-schedules script, more reliable job system crons (#13564) (cdeb828)
- expose multipart/form-data parsing options (#13766) (8282031)
- global beforeOperation hook (#13768) (3af546e)
- ui: export FieldPathContext (#13806) (a3acfeb)
🐛 Bug Fixes
- add missed pagination property to findVersions and findGlobalVersions and handle it properly (#13763) (a955392)
- skip validation when trashing documents with empty required fields (#13807) (3b13867)
- versions created with incomplete data when using select parameter (#13809) (faed3aa)
- error accessing sanitizedPermissions during docAccess operation: "Cannot read properties of undefined" (#13800) (c7795fa)
- typo in the description of the isTemp field of query presets (#13728) (e75bfb0)
- fully sanitize unauthenticated client config (#13785) (e2632c8)
- client config context inheritance (#13790) (dfb0021)
- db-mongodb: support 2x and more relationship sorting (#13819) (24ace70)
- db-mongodb: localized arrays inside blocks with versions (#13804) (09dec43)
- examples: secure mt example users collection (#13810) (9a841df)
- live-preview: client-side live preview failed to populate localized fields (#13794) (b34e5ea)
- live-preview: reset cache per subscription and ignore invalid preview messages (#13793) (b62a30a)
- next: unnamed, unlabeled groups displayed without label in version view (#13831) (8d3b146)
- next: sparse block and arrays diffs were not rendered correctly (#13829) (433c513)
- next: exclude permissions from page response when unauthenticated (#13796) (8113d3b)
- next: richtext field is read-only for expired lock (#13789) (4278e72)
- next: login redirect crashes page (#13786) (13af91f)
- next: resolve filterOptions by path (#13779) (8a7124a)
- translations: use correct Dutch terms for "clear" and "close" (#13748) (fce94d6)
- ui: pass locale arg in query params for folder operations (#13837) (c0684e3)
- ui: correct field path in inline create drawer for auth fields (#13815) (91e7f0c)
- ui: populate nested fields for enableListViewSelectAPI (#13827) (dc732b8)
- ui: cross-domain server-side live preview throws postMessage error (#13825) (731c4fb)
- ui: undefined operators for virtual field with unsupported field types (#13820) (5c02d17)
- ui: prevent form validation after draft submit error (#12918) (a2c31fa)
- ui: show loading state in relationship field during search and pagination (#13805) (555228b)
- ui: safely access preferences when loading list view (#13771) (4482eaf)
📚 Documentation
- improvements and fixes to blocks documentation (#13782) (3c5aa1b)
📝 Templates
- fix experimental-build-mode compile generating invalid code (#13828) (ba2ab2f)
⚙️ CI
- adjust audit-dependencies cron time (898e937)
🤝 Contributors
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
- Jonathan Elmgren (@jonathanelmgren)
- Sasha (@r1tsuu)
- Jacob Fletcher (@jacobsfletch)
- Patrik (@PatrikKozak)
- Slava Nossar (@slavanossar)
- Philipp Schneider (@philipp-tailor)
- Elliot DeNolf (@denolfe)
- Amelia (@LimChorngUan)
- BrannanKovachev (@BrannanKovachev)
- Robbe Vaes (@Robbe95)
- Robbert Stevens (@robbertstevens)
- Anders Semb Hermansen (@andershermansen)
- German Jablonski (@GermanJablo)
Sep 10, 2025
v3.55.1 (2025-09-10)

🐛 Bug Fixes
- presentational-field types incorrectly exposing hooks (#11514) (285fc8c)
- graphql: pass collectionSlug to nested join fields in tabs, collapsible and group resolvers (#13752) (e52b757)
- next: error after logging in and navigating to different page in production (#13758) (e40c821)
- ui: listSearchableFields can resolve to multiple fields with the same name when using tabs (#13668) (ffed540)
📝 Templates
- ensure blank template installs matching react-dom version (#13757) (15e462b)
🤝 Contributors
- Dallas Opelt (@DallasO)
- Alessio Gravili (@AlessioGr)
- German Jablonski (@GermanJablo)
- timeo-schmidt (@timeo-schmidt)
- Elliot DeNolf (@denolfe)
Sep 9, 2025
v3.55.0 (2025-09-09)

🚀 Features
- adds disableListColumn and disableListFilter to imageSize admin props (#13699) (e1ea074)
- unauthenticated client config (#13714) (e49005f)
- adds new experimental.localizeStatus option (#13207) (0f6d748)
- live-preview: client-side live preview: simplify population, support hooks and lexical block population (#13619) (6e203db)
- richtext-lexical: upgrade lexical from 0.34.0 to 0.35.0 (#13715) (7a8bcdf)
- richtext-lexical: upgrade lexical from 0.28.0 to 0.34.0 (#13622) (1a1696d)
- richtext-lexical: add options to hide block handles (#13647) (fdab271)
- ui: save collection folder tab preferences (#13702) (6a0637e)
- ui: adds admin.autoRefresh root config property (#13682) (f288cf6)
🐛 Bug Fixes
- ensure client-side live preview correctly updates for globals (#13718) (03f7102)
- set X-Payload-HTTP-Method-Override as allowed cross origin header (#13717) (a4a0298)
- update user session on reset (#13667) (d9e1832)
- prevent enabling trash on folders (#13675) (be47f65)
- db-sqlite: convert Date to ISO 8601 string in queries (#11694) (917c66f)
- next: version diff view not handling all field permissions correctly (#13721) (911f17a)
- next: display deleted relations and uploads in version diff views (#12955) (bbcdea5)
- next: version diff view shows correct document title in step nav (#13713) (794bf82)
- plugin-multi-tenant: hide watchTenant column field (#13740) (a0112d7)
- plugin-multi-tenant: skip baseFilter if user has access to all tenants (#13633) (65b3845)
- plugin-nested-docs: prevent phantom breadcrumb row (#13628) (a231a05)
- plugin-nested-docs: crumbs not syncing on non-versioned collections (#13629) (4600c94)
- plugin-search: update with db adapter on create (#13670) (1293019)
- richtext-lexical: fix picture closing tag in html converter (#13100) (24e436b)
- richtext-lexical: add internationalization support for default style label in textStateFeature (#13662) (0c44c3b)
- storage-vercel-blob: filename is incorrectly stored encoded when addRandomSuffix is true (#13746) (b2f9d4e)
- templates: URI encode the cacheTag in getMediaUrl utility - Website template (#13558) (008a52d)
- ui: consistent searchbar across folders and lists (#13712) (09e3174)
- ui: cannot filter by virtual relationship fields in WhereBuilder (#13686) (7e98fbf)
- ui: undefined permissions passed in create-first-user view (#13671) (5146fc8)
- ui: don't populate on auto save (#13649) (7794541)
- ui: use consistent row ids when duplicating array and block rows (#13679) (b8d7ccb)
- ui: field.admin.condition data attribute missing document ID when document is being edited (#13676) (a115868)
- ui: await for publish success to update the UI (#13673) (9b10933)
- ui: sidebar missing sticky top offset (#13652) (1c68ed5)
- ui: should not show publish specific locale button when no localized fields exist (#13459) (ac691b6)
- ui: json field type ignoring editorOptions (#13630) (426f99c)
⚡ Performance
- plugin-search: reindex collections in parallel, up to 80% faster (#13608) (b99c324)
- ui: opt-in to the select api in the list view (#13697) (d2d2df4)
📚 Documentation
- missing comma in custom-strategies example (#13701) (27cfe77)
- plugin-form-builder: add RadioField documentation (#13529) (4e972c3)
🧪 Tests
- increase timeout in uploads cors test (#13743) (a528a55)
⚙️ CI
- deps: bump the github_actions group across 3 directories with 4 updates (#13654) (cfb70f0)
🏡 Chores
- add AGENTS.md (#13688) (d109b44)
- ui: prevent loading orphaned documents when viewing root collection folders (#13684) (9f0573d)
🤝 Contributors
- Patrik (@PatrikKozak)
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
- Jacob Fletcher (@jacobsfletch)
- Ilham Saputrajati (@ilhamsj)
- Cedric Delacombaz (@cdelacombaz)
- Said Akhrarov (@akhrarovsaid)
- Aapo Laakkio (@ApsiV11)
- Anders Semb Hermansen (@andershermansen)
- German Jablonski (@GermanJablo)
- Yazal Ulloa (@yazalulloa)
- Elliot DeNolf (@denolfe)
- Jessica Rynkar (@jessrynkar)
- reiv (@reiv)
- Riley Langbein (@rilrom)
Aug 28, 2025
v3.54.0 (2025-08-28)

🚀 Features
- support parallel job queue tasks, speed up task running (#13614) (e0ffada)
- configurable toast notifications (#13609) (0a18306)
- allow multiple, different payload instances using getPayload in same process (#13603) (13c24af)
- db-*: support atomic array $push db updates (#13453) (5ded64e)
- plugin-multi-tenant: allow custom tenant field per collection (#13553) (6db07f0)
- plugin-multi-tenant: re-enable global selector on all views (#13575) (f260d0a)
🐛 Bug Fixes
- restore as draft function was passing a published status (#13599) (a670438)
- hide jobs stats global by default (#13566) (a92c251)
- deeply merge array and block rows from server form state (#13551) (1e13474)
- ensure updates to createdAt and updatedAt are respected (#13335) (5c16443)
- db-*: add delete version id for non-mongodb (#10613) (ddb8ca4)
- graphql: invalid enum names when values include brackets (#13597) (1dc346a)
- next: richtext fields not read-only for locked documents (#13579) (344ad69)
- next: update rest route handler types for Next.js 15.5 compatibility (#13521) (763cb61)
- plugin-multi-tenant: prevent duplicate filters on referenced blocks (#13607) (03a00ca)
- plugin-multi-tenant: autosave global documents not rendering (#13552) (409dd56)
- richtext-lexical: toolbar dropdown items are disabled when selecting via double-click (#13544) (3bc1d08)
- ui: prevent infinite redirect if no user (#13615) (303381e)
- ui: bulk edit overwriting fields within named tabs (#13600) (138938e)
- ui: autosave in document drawer overwrites local changes (#13587) (bd81936)
- ui: multiple logout requests being made in parallel (#13595) (cf37433)
- ui: auth-fields container renders despite no visible auth/API key/verify content (#13554) (8101842)
- ui: correctly pass query params to locked document requests (#10802) (598ff4c)
🛠 Refactors
- deprecate job queue runHooks property (#13617) (97c41ce)
📚 Documentation
- adds default populate video (#13586) (ded8ec4)
- blank-template-url-fix (#13580) (45c3be2)
- fix small typo in documentation (#13545) (3408d7b)
⚙️ CI
- remove run-e2e-turbo flow (#13611) (5c41966)
- ignore template bump commits in release notes [skip ci] (60cfc31)
🤝 Contributors
- Alessio Gravili (@AlessioGr)
- Jarrod Flesch (@JarrodMFlesch)
- Jacob Fletcher (@jacobsfletch)
- Jessica Rynkar (@jessrynkar)
- Sean Zubrickas (@zubricks)
- Elliot DeNolf (@denolfe)
- Patrik (@PatrikKozak)
- Rodrigo Solís (@sorodrigo)
- Logan Stellway (@lstellway)
- Yunsup Sim (@SimYunSup)
- Vincent Vu (@rubixvi)
Aug 21, 2025
v3.53.0 (2025-08-21)

🚀 Features
- add icelandic translations (#13423) (2bdd669)
- plugin-import-export: use groupBy as SortBy when present and sort is unset (#13491) (a7ed88b)
- plugin-import-export: adds sort order control and sync with sort-by field (#13478) (efdf002)
- plugin-multi-tenant: visible tenant field on documents (#13379) (5cf215d)
🐛 Bug Fixes
- server edit view components don't receive document id prop (#13526) (9607453)
- uploads update unnecessarily resizing with sharp (#13528) (a94cd95)
- accept computed array and block rows from server form state (#13501) (f382c39)
- 'front-end' spelling typo in JSDocs for overrideAccess (#13515) (f44e276)
- imports (part 2/2) (#13520) (cf427e5)
- select field component value prop type does not support array values (#13510) (4f6d0d8)
- unable to query versions on latest key (#13512) (73ba4d1)
- avoid re-uploading the file unless changed (#13500) (92d459e)
- copy to locale with localized fields inside tabs (#13456) (ec5b673)
- omit trashed documents from appearing in folder results (#13492) (1909063)
- update docker base image in templates (#13020) (64f4b0a)
- db-mongodb: disable join aggregations in DocumentDB compatibility mode (#13270) (c7b9f0f)
- db-postgres: camelCase point fields (#13519) (aa90271)
- next: no client field found error when accessing version view in some configurations (#13339) (393b4a0)
- next: add missing translations to version view (c8ef924)
- plugin-form-builder: export radio field type (#11908) (fea6742)
- richtext-lexical: use thumbnail component for uploads (#12540) (7699d02)
- storage-s3: validate Content-Length before appending header (#13472) (9d08f50)
- templates: plugin template correct paths for exports (#13427) (b714e6b)
- translations: stale version.versionCreatedOn key in translation (#13530) (a04bc9a)
- ui: thread id through instead of from routeParams (#13539) (b65ca68)
- ui: logout type error when user is null during locale switch (#13514) (b3e48f8)
- ui: replace deprecated document.execCommand('copy') API with navigator (#13431) (368cd90)
- ui: local image src changing when title changes (#13442) (406a09f)
- ui: double ? in gravatar url (#13511) (332b2a9)
- ui: nested fields with admin.disableListColumn still appear as columns in list view (#13504) (9f7d8c6)
- ui: blocks field not respecting width styles in row layouts (#13502) (30ea8e1)
- ui: cannot replace the file if the user does not have delete access (#13484) (3dd142c)
- ui: bulk upload action bar buttons wrapping (#13486) (b7243b1)
⚡ Performance
- storage-s3: stream files and abort s3 request from static handler (#13430) (36fd6e9)
- ui: do not fetch doc permissions on autosave (#13477) (c67ceca)
- ui: reduce number of field renders on submit (#13524) (5e433aa)
📚 Documentation
- fix typo in custom views (#13522) (a840fc9)
- clarify pagination and improve cross-referencing (#13503) (f9bbca8)
- db-mongodb: note on indexing localized fields & per-locale growth (#13469) (379ef87)
🧪 Tests
- add array field helpers (#13493) (adb83b1)
- fix link imports (#13513) (9e7bb24)
🏡 Chores
- plugin-multi-tenant: missing collections warning (#13538) (76741eb)
🤝 Contributors
- Jarrod Flesch (@JarrodMFlesch)
- Jónas G. Sigurðsson (@jonnigs)
- Patrik (@PatrikKozak)
- Alessio Gravili (@AlessioGr)
- Dan Ribbens (@DanRibbens)
- Anders Semb Hermansen (@andershermansen)
- Jacob Fletcher (@jacobsfletch)
- Said Akhrarov (@akhrarovsaid)
- Sasha (@r1tsuu)
- Gregor Billing (@gregorbg)
- Bob Bass (@robertjbass)
- Boyan Bratvanov (@bratvanov)
- German Jablonski (@GermanJablo)
- Jan Huenges (@jhuenges)
- Паламар Роман (@VeiaG)
- chenxi-debugger (@chenxi-debugger)
- id3er0 (@id3er0)
- Anatoly Kopyl (@anatolykopyl)
- Elliot DeNolf (@denolfe)
Aug 15, 2025
v3.52.0 (2025-08-15)

🚀 Features
- plugin-import-export: adds limit and page fields to export options (#13380) (c1c68fb)
🐛 Bug Fixes
- filter payload- cookies in getExternalFile only if the URL is external (#13475) (8d4e7f5)
- db-postgres: ensure index names are not too long (#13428) (047519f)
- plugin-import-export: csv export & preview showing full documents for hasMany monomorphic relationships instead of just ID (#13465) (3e65111)
- ui: significantly more predictable autosave form state (#13460) (0b60bf2)
📚 Documentation
- updates image paths to new screenshots (#13461) (cdd90f9)
🧪 Tests
- skip cookies filter for internal URLs in getExternalFile (#13476) (46699ec)
- fix import-export plugin int (#13474) (b426052)
📝 Templates
- bump for v3.51.0 (#13457) (0e8a6c0)
🤝 Contributors
- jacobsfletch (@jacobsfletch)
- Sasha (@r1tsuu)
- Sean Zubrickas (@zubricks)
- Dan Ribbens (@DanRibbens)
- Patrik (@PatrikKozak)
- Elliot DeNolf (@denolfe)
Aug 13, 2025
v3.51.0 (2025-08-13)

🚀 Features
- plugin-multi-tenant: allow tenant field overrides (#13316) (995f96b)
- ui: update query presets ux (#13095) (255bba9)
🐛 Bug Fixes
- upload with no filename gives vague error (#13414) (5a99d8c)
- version view breaks when tab field has function for label (#13415) (35ca98e)
- ensure scheduling by default only handles default queue, add allQueues config to autoRun (#13395) (ad2564e)
- use thumbnailUrl for upload documents in folder view (#13368) (2211f3d)
- next: group by boolean values (#13382) (d4f1986)
- next: group by dates with null values (#13381) (7344d64)
- richtext-lexical, plugin-multi-tenant: text editor exposes documents from other tenants (#13229) (9c8f320)
- templates: only generate slug from title on demand (#12956) (2bc9a2d)
- translations: update traditional chinese (zh-TW) localization (#13370) (5d8f8dc)
- ui: autosave form state discards local changes (#13438) (8173180)
- ui: misalignment of nested toggles on document API tab (#13424) (306b7f6)
- ui: field elements showing over the top of Preview content (#13148) (72f5763)
- ui: bulk upload issues (#13413) (a374aab)
- ui: autosave hooks are not reflected in form state (#13416) (1d81b0c)
- ui: search in select fields with filterOptions (#13397) (c9a1590)
📚 Documentation
- add dependency troubleshooting docs (#13385) (e870be0)
🧪 Tests
- group-by reset and navigation tests in trash view (#13401) (3258e78)
⚙️ CI
- update release-commenter permissions (#13373) (ac40185)
🏡 Chores
- templates: fix typo in e2e tests (headging -> heading) (#13391) (161769e)
🤝 Contributors
- Jessica Rynkar (@jessrynkar)
- Jacob Fletcher (@jacobsfletch)
- Patrik (@PatrikKozak)
- Alessio Gravili (@AlessioGr)
- Jarrod Flesch (@JarrodMFlesch)
- Paul (@paulpopus)
- Marcus Michaels (@marcusmichaels)
- Luke Bennett (@lukebennett)
- German Jablonski (@GermanJablo)
- Rodrigo Antunes (@rodrigoant)
- Sasha (@r1tsuu)
- Yi Chi (@chiyi4488)
- Sam (@damnsamn)
- Elliot DeNolf (@denolfe)
Aug 5, 2025
v3.50.0 (2025-08-05)

🚀 Features
- add hooks to restoreVersion collection operation (#13333) (9031f3b)
- adds trash support to the count operation (#13304) (1175508)
- graphql: allow to pass count: true to a join query (#13351) (f432cc1)
- translations: add Indonesian translations (#13323) (df91321)
🐛 Bug Fixes
- deletedAt in TypeWithID not accepting null from generated types (#13363) (8401b21)
- svg uploads allowed when glob (#13356) (43b4b22)
- querying hasMany: true select fields inside polymorphic joins (#13334) (b26a73b)
- next: version view did not properly handle field-level permissions (#13336) (1d70d4d)
- next: incorrect version view stepnav value (#13305) (8a48941)
- next: safely access relationTo value from relationship field (#13337) (095e7d9)
- next: incorrect doc link in trash view with groupBy enabled (#13332) (c48b57f)
- next: cannot filter trash (#13320) (e7124f6)
- plugin-multi-tenant: constrain results to assigned tenants when present (#13365) (20b4de9)
- richtext-lexical: recursively unwrap generic Slate nodes in Lexical migration converter (#13202) (227a20e)
- ui: fallback to default locale checkbox passes wrong value (#12396) (b74f4fb)
- ui: group/array error paths persisting when valid (#13347) (2903486)
- ui: add hidden sidebar fields css specificity (#13344) (b965db8)
- ui: hide sidebar when no fields rendered (#13340) (1b93c4b)
- ui: incorrect padding when using rtl (#13338) (f2d4004)
⚡ Performance
- 23% faster job queue system on postgres/sqlite (#13187) (3114b89)
- ui: only select the useAsTitle field when fetching the document data of a relationship value (#13228) (1b31c74)
🧪 Tests
- adds e2e tests for auth enabled collections with trash enabled (#13317) (a8b6983)
- stabilize frequent fails (#13318) (a22f27d)
🏡 Chores
- adds session helper exports (#13367) (3b9dba8)
🤝 Contributors
- Jessica Rynkar (@jessrynkar)
- Patrik (@PatrikKozak)
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
- Jens Becker (@jhb-dev)
- Sasha (@r1tsuu)
- Muhammad Nizar (@mnizarzr)
- Evelyn Hathaway (@evelynhathaway)
Jul 29, 2025
v3.49.1 (2025-07-29)

🐛 Bug Fixes
- support next.js 15.4.4 (#13280) (5c94d2d)
- keep apiKey encrypted in refresh operation (#13063) (#13177) (b1fa76e)
- filters cookies with the payload- prefix in getExternalFile by default (#13215) (0894249)
- use atomic operation for incrementing login attempts (#13204) (4fde0f2)
- refactors toast error rendering (#13252) (d093bb1)
- serve svg+xml as svg (#13277) (bc80284)
- svg+xml file detection (#13276) (e8f6cb5)
- drizzle: respect join.type config (#13258) (8518141)
- next: group by null relationship crashes list view (#13315) (e502203)
- next: catch list filter errors, prevent list view crash (#13297) (8d84352)
- next: pass req through document tab conditions and custom server components (#13302) (c5c8c13)
- next: unable to view trashed documents when group-by is enabled (#13300) (aff2ce1)
- plugin-multi-tenant: prefer assigned tenants for selector population (#13213) (e29d1d9)
- richtext-lexical: unify indent between different converters and make paragraphs and lists match without CSS (#13274) (7cd4a8a)
- translations: improve swedish translations (#13272) (da8bf69)
- translations: missing closing brace in rs latin translation for lastSavedAgo (#13172) (26d9dae)
- ui: autosave-enabled document drawers close unexpectedly within the join field (#13298) (61ee8fa)
⚡ Performance
- drizzle: 2x faster db.deleteMany (#13255) (6d6c9eb)
📚 Documentation
- remove asterisk from optional url property in live preview docs (#13108) (fc59448)
- typo in vercel-content-link.mdx (#13170) (9e04dbb)
- fixes typo in ternary operator for live preview docs (#13163) (72954ce)
- remove obsolete scheduler property (#13278) (2e9ba10)
🧪 Tests
- fix flaky sorting test (#13303) (7234924)
📝 Templates
- bump for v3.49.0 (#13273) (23bd675)
⚙️ CI
- show path value in audit-dependencies script [skip ci] (#13314) (4beb27b)
🏡 Chores
- next: cleanup unused code (#13292) (b1aac19)
- ui: var name typo in relationship field (#13295) (a888d5c)
🤝 Contributors
- contip (@contip)
- German Jablonski (@GermanJablo)
- Adebayo Ajayi (@Braggedtooth)
- brutumfulmen97 (@brutumfulmen97)
- Alejandro Martinez (@ja-martinez)
- Aayush Rajagopalan (@aayushxr)
- Sean Zubrickas (@zubricks)
- Jacob Fletcher (@jacobsfletch)
- Jarrod Flesch (@JarrodMFlesch)
- Elliot DeNolf (@denolfe)
- Alessio Gravili (@AlessioGr)
- Patrik (@PatrikKozak)
Jul 25, 2025
v3.49.0 (2025-07-25)

🚀 Features
- adds trash support (soft deletes) (#12656) (f63dc2a)
- group by (#13138) (bccf6ab)
- scheduling jobs (#12863) (c08b2ae)
- ui: expose refresh method to list drawer context (#13173) (e48427e)
🐛 Bug Fixes
- filtering by polymorphic relationships inside other fields (#13265) (75385de)
- text field validation for minLength: 1, required: false (#13124) (af2ddff)
- empty folderType arrays break relational dbs (#13219) (7f9de6d)
- handle undefined values in afterChange hooks when read:false and create:true on the field level access for parents and siblings (#12664) (46d8a26)
- exit payload jobs:run process after completion (#13211) (4ae503d)
- db-mongodb: handle duplicate unique index error for DocumentDB (#13239) (c1cfceb)
- db-postgres: search is broken when useAsTitle is not specified (#13232) (a83ed5e)
- next: prevent base list filters from being injected into the url (#13253) (0eac58e)
- plugin-import-export: json preview and downloads preserve nesting and exclude disabled fields (#13210) (8f85da8)
- ui: preserve localized blocks and arrays when using CopyToLocale (#13216) (4a712b3)
- ui: incorrect blocks label sizing (#13264) (fa7d209)
- ui: ensure document unlocks when logging out from edit view of a locked document (#13142) (7e81d30)
- ui: monomorphic relationship fields should not show relationTo option labels (#13245) (29fb9ee)
- ui: select all should reset when params change, page, filter, etc (#12612) (412bf4f)
- ui: ensure publishSpecificLocale works during create operation (#13129) (dce898d)
- ui: properly sync search params to user preferences (#13200) (d7a3faa)
⚡ Performance
- db-postgres: avoid including prettier to the bundle (#13251) (380ce04)
- drizzle: single-roundtrip db updates for simple collections (#13186) (94f5e79)
🛠 Refactors
- drizzle: use getTableName utility (#13257) (1ad7b55)
📚 Documentation
- add status to forbidden field names when using Postgres and drafts are enabled (#13233) (7ae4f8c)
- remove payload cloud (#13240) (77f279e)
- fix typo, example was not valid JSON (#13224) (0eb8f75)
- shorten line length in code snippet comments to avoid horizontal scrolling (#13217) (d6e21ad)
- plugin-import-export: document plugin-import-export (#13243) (14322a7)
🔨 Build
- suppress pnpm update notification (#13241) (e7a652f)
⚙️ CI
- default audit-dependencies script to high severity (#13244) (3f8fb67)
🏡 Chores
- add new int test verifying that select improves performance of new optimization (#13254) (aeee070)
- plugin-import-export: use debug-level logging for createExport process (#13242) (246a42b)
🤝 Contributors
- Sasha (@r1tsuu)
- Patrik (@PatrikKozak)
- German Jablonski (@GermanJablo)
- Jarrod Flesch (@JarrodMFlesch)
- Jacob Fletcher (@jacobsfletch)
- Dan Ribbens (@DanRibbens)
- Alessio Gravili (@AlessioGr)
- Elliot DeNolf (@denolfe)
- fgrsource (@fgrsource)
- Chandler Gonzales (@jcgsville)
- Jessica Rynkar (@jessrynkar)
- iamacup (@iamacup)
- Jake Fell (@jakefell)
Jul 17, 2025
v3.48.0 (2025-07-17)

🚀 Features
- add findDistinct operation (#13102) (a20b436)
- atomic number field updates (#13118) (841bf89)
- plugin-import-export: adds support for disabling fields (#13166) (5839cb6)
- plugin-import-export: adds support for forcing export format via plugin config (#13160) (7294cf5)
- plugin-import-export: adds pluginConfig options to disable Save and Download buttons in export UI (#13158) (de53f68)
- richtext-lexical: export $createLinkNode and $isLinkNode for server use (#13205) (6ae730b)
- ui: supports collection scoped folders (#12797) (12539c6)
🐛 Bug Fixes
- Enhances field-level access controls on Users collection to address s… (#13197) (cab7ba4)
- cron jobs running when calling bin scripts, leading to db errors (#13135) (64d76a3)
- types for RenderField fields prop (#13162) (5f01953)
- db-mongodb: improve compatibility with Firestore database (#12763) (41cff6d)
- plugin-import-export: disabled flag to cascade to nested fields from parent containers (#13199) (95e373e)
- plugin-import-export: export field dropdown to properly label and path fields in named/unnamed tabs (#13180) (2a59c5b)
- plugin-multi-tenant: selector could become hidden (#13134) (e575511)
- plugin-seo: add localized property to MetaTitleComponent (#12751) (d213c91)
⚡ Performance
- drizzle: further optimize postgres row updates (#13184) (7cd682c)
📚 Documentation
- fix minor typo (#13185) (be8e8d9)
- performance (#13068) (277448d)
- fix invalid syntax failing the docs import (#13165) (4831bae)
- add section on browser environment variables when using experimental-build-mode (#13164) (4c69f8e)
🧪 Tests
- move i18n list tests to i18n suite (#13143) (a57faeb)
- fix flaky uploads test (#13141) (53ad02a)
📝 Templates
- bump for v3.47.0 (#13161) (f4d951d)
⚙️ CI
- disable bundle analysis for forks (#13198) (e6da384)
- fix post-release-templates workflow (#13159) (edd1f02)
🤝 Contributors
- Patrik (@PatrikKozak)
- Jarrod Flesch (@JarrodMFlesch)
- Alessio Gravili (@AlessioGr)
- Sasha (@r1tsuu)
- Sean Zubrickas (@zubricks)
- Elliott W (@elliott-w)
- Elliot DeNolf (@denolfe)
- jangir-ritik (@jangir-ritik)
- Jacob Fletcher (@jacobsfletch)
- Patrick Roelofs (@Patrickroelofs)
Jul 11, 2025
v3.47.0 (2025-07-11)

🚀 Features
- allow joins, select, populate, depth and draft to /me REST API operation (#13116) (2d91cb6)
- exports new sanitizeUserDataForEmail function (#13029) (9f1bff5)
- next: redirect non-existent documents to list view with banner (#13062) (5e82f9f)
- next: add redirect from ${adminRoute}/collections to ${adminRoute} (#13061) (a7a0501)
- plugin-import-export: show delayed toast when export download takes time (#13126) (b3a994e)
- storage-*: include modified headers into the response headers of files when using adapters (#12096) (cb6a73e)
- ui: add API key visibility toggle (#13110) (8a3b97c)
- ui: adds support for copy pasting complex fields (#11513) (1d6ffcb)
🐛 Bug Fixes
- execute mimetype validation on the file buffer data (#13117) (5695d22)
- login operation not returning collection and _strategy (#13119) (0c2b105)
- ensure we perform ssrf check within dispatcher (#13078) (e99c67f)
- ensure default values are not shown when value is hidden (#13074) (855a320)
- correctly reset login attempts (#13075) (aa97f3c)
- payload auth api-key algorithm compatibility (#13076) (9c45321)
- next: prevent live preview url functions from firing unnecessarily (#13088) (0b88466)
- plugin-import-export: sync export field selection with list view columns from query columns (#13131) (c1bad01)
- plugin-import-export: flattening logic for polymorphic relationships in CSV exports (#13094) (c6105f1)
- plugin-import-export: selectionToUse field to dynamically show valid export options (#13092) (0806ee1)
- plugin-import-export: sync field select dropdown with form value (#13103) (1c6a79b)
- ui: disabled and styles add row button correctly (#13140) (2cafe49)
- ui: ensure buildFormStateHandler throws error instead of returning null for unauthorized requests (#13123) (06ef798)
- ui: monomorphic joins tables not fetching draft documents (#13139) (19a3367)
- ui: ensure that schedule publishing time picker can only be in the future (#13128) (f63dfad)
- ui: hidden input should wait for form initialization (#13114) (c77b39c)
- ui: improve alignment of clear and dropdown indicator buttons in select based fields (#12995) (4c25357)
- ui: prevent error crashing UI when relationship assigned as useAsTitle (#12981) (8a5cb27)
⚡ Performance
- db-postgres: simplify db.updateOne to a single DB call with if the passed data doesn't include nested fields (#13060) (055cc4e)
📚 Documentation
- richtext-lexical: add documentation page about official features (#13132) (576644d)
- templates: fix grammar in README (#13027) (96c24a2)
⚙️ CI
- use .tool-versions file in setup (#13093) (dde9681)
- audit-dependencies workflow (#13090) (c876ddf)
- blank audit-dependencies workflow [skip ci] (fee33b5)
🏡 Chores
- deps: bump deps to resolve all high severity (#13002) (417b70e)
🤝 Contributors
- Jarrod Flesch (@JarrodMFlesch)
- German Jablonski (@GermanJablo)
- Aaron Claes (@AaronClaes)
- Patrik (@PatrikKozak)
- Jessica Rynkar (@jessrynkar)
- Paul (@paulpopus)
- Sasha (@r1tsuu)
- Alessio Gravili (@AlessioGr)
- Said Akhrarov (@akhrarovsaid)
- Elliot DeNolf (@denolfe)
- Jacob Fletcher (@jacobsfletch)
- Dani Calero (@danicaleroo)
- Dan Ribbens (@DanRibbens)
- Adam Klingbaum (@adamklingbaum)
Jul 7, 2025
v3.46.0 (2025-07-07)

🚀 Features
- adds restricted file check (#12989) (ba660fd)
🐛 Bug Fixes
- deduplicate custom array id fields (#13064) (e6f8ca6)
- check hostname of upload url (#13018) (30fc7e3)
- db-mongodb: updateOne mutates the data object and does not transform it for read (#13065) (6d5cc84)
- next: adds token to reset password initialState (#13067) (f4f13a2)
- next: respect collection-level live preview config (#13036) (f49eeb1)
- plugin-redirects: make 'from' field unique to prevent errors in redirect logic (#12964) (50c2f8b)
- ui: increase timeout for opening list drawer in RelationshipInput (#13031) (2650eb7)
- ui: change password button is hidden when user has full field access (#12988) (1d9ad6f)
🧪 Tests
- fix tests that rely on remote urls (#13073) (34920a7)
⚙️ CI
- analyze bundle size (#13071) (af9837d)
🤝 Contributors
- Patrik (@PatrikKozak)
- Kendell (@kendelljoseph)
- Alessio Gravili (@AlessioGr)
- Jessica Rynkar (@jessrynkar)
- Jarrod Flesch (@JarrodMFlesch)
- Germán Jabloñski (@GermanJablo)
- Jacob Fletcher (@jacobsfletch)
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.82.1 (2026-04-09)

🐛 Bug Fixes

⚡ Performance

📚 Documentation

📝 Templates

🤝 Contributors

v3.82.0 (2026-04-08)

🚀 Features

🐛 Bug Fixes

⚡ Performance

🛠 Refactors

📚 Documentation

📝 Templates

🏡 Chores

🤝 Contributors

v3.81.0 (2026-04-01)

🚀 Features

🐛 Bug Fixes

🛠 Refactors

📚 Documentation

🧪 Tests

📝 Templates

⚙️ CI

🏡 Chores

🤝 Contributors

v3.80.0 (2026-03-20)

🚀 Features

🐛 Bug Fixes

📚 Documentation

📝 Templates

⚙️ CI

🏡 Chores

🤝 Contributors

v3.79.1 (2026-03-16)

🐛 Bug Fixes

⚡ Performance

📚 Documentation

🧪 Tests

🏡 Chores

🤝 Contributors

v3.79.0 (2026-03-04)

🚀 Features

🐛 Bug Fixes

🛠 Refactors

📚 Documentation

🧪 Tests

🏡 Chores

⚠️ BREAKING CHANGES

🤝 Contributors

v3.78.0 (2026-02-27)

🚀 Features

Feature Details

🐛 Bug Fixes

🛠 Refactors

🎨 Styles

🧪 Tests

📝 Templates

🏡 Chores

🤝 Contributors

v3.77.0 (2026-02-18)

🚀 Features

Feature Details

🐛 Bug Fixes

📚 Documentation

🧪 Tests

🏡 Chores

🤝 Contributors

v3.76.1 (2026-02-11)

🐛 Bug Fixes

⚙️ CI

v3.76.0 (2026-02-09)

🚀 Features

🐛 Bug Fixes

📝 Templates

⚙️ CI

🏡 Chores

🤝 Contributors

v3.75.0 (2026-02-05)

🚀 Features