Change8

Migrating to Payload CMS v3.67.0

Version v3.67.0 introduces 1 breaking change. This guide details how to update your code.

Released: 12/5/2025

1
Breaking Changes
1
Migration Steps
4
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

ecommercePluginUploadAdmingetGlobalViewRedirectSelectMany

Breaking Changes

Issue #1

plugin-ecommerce: The access configuration structure within `ecommercePlugin` has been reworked to support secure guest carts. Users must update their access configuration object passed to `ecommercePlugin` to align with the new structure (e.g., replacing old access keys with `isAdmin` and `isDocumentOwner`). See release notes for the exact mapping.

Migration Steps

  1. 1
    If using `plugin-ecommerce`, review and update the `access` configuration object passed to `ecommercePlugin` to match the new structure, which includes replacing older access keys with `isAdmin` and `isDocumentOwner`.

Release Summary

This release introduces `groupBy` support for query presets and enables guest cart functionality in the ecommerce plugin with a reworked access configuration. Several UI and hook-related bugs were also resolved.

Need More Details?

View the full release notes and all changes for Payload CMS v3.67.0.

View Full Changelog