●Change8

Migrating to Payload CMS v3.79.0

Version v3.79.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 3/4/2026

2
Breaking Changes
2
Migration Steps
11
Affected Symbols

⚠️ Check Your Code

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

richtext-lexical block configurationWidget.ComponentPathWidget.ComponentPayloadComponentCodeEditor export statementlexical (dependency update)Stripe adapter (plugin-ecommerce)plugin-import-export URL queriesplugin-import-export locale handlingsortable hasMany fields (UI)autosave modal (UI)

Breaking Changes

●Issue #1

Renamed `Widget.ComponentPath` to `Widget.Component` and changed its type from `string` to `PayloadComponent`. Update configurations referencing this property to use `Widget.Component`.

●Issue #2

A typo in the `CodeEditor` export statement was fixed, which might affect consumers relying on the exact previous export structure.

Migration Steps

  1. 1
    If you configured Lexical blocks, replace usage of `imageURL` with the new `images` property containing `icon` and `thumbnail` definitions.
  2. 2
    If you were relying on the old type definition for widget components, rename usages of `Widget.ComponentPath` to `Widget.Component` and ensure the property is typed as `PayloadComponent` instead of `string`.

Release Summary

This release introduces granular icon/thumbnail configuration for Lexical blocks and adds i18n support for modular dashboards. It also includes a significant upgrade to the underlying Lexical dependency and numerous bug fixes across plugins and the UI.

Need More Details?

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

View Full Changelog