●Change8

Migrating to Payload CMS v3.74.0

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

Released: 1/30/2026

1
Breaking Changes
1
Migration Steps
7
Affected Symbols

⚠️ Check Your Code

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

CollectionConfig.hooks.beforeChangeLocal API operations (draft option)UnpublishButton componentPopup componenttraverseFieldscount operation typesformatAdminUrl

Breaking Changes

●Issue #1

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, which might cause compilation errors if code previously relied on passing the `draft` option where it was implicitly ignored.

✓Solution

If you are using draft options on collections/globals that do not support drafts, remove the `draft` option from those operations. Generic collection slugs may require explicit type assertions when using draft options.

Migration Steps

  1. 1
    If you rely on passing the `draft` option to Local API operations on collections/globals that do not have drafts enabled while `typescript.strictDraftTypes` is true, you must remove the `draft` option from those calls.

Release Summary

This release introduces granular control over access in document hooks, extends TypeScript draft type checking across all local operations, and adds support for R2 multipart uploads. Numerous bug fixes address issues related to UI state, localization, and plugin behavior.

Need More Details?

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

View Full Changelog