Payload CMS Release: 2.30.4

Tag Name: v2.30.4

Release Date: 11/11/2024

Payload CMS LogoPayload CMS

Payload CMS is a modern, self-hosted headless content management system built with TypeScript, Node.js, and MongoDB. It's designed specifically for developers who want full control over their content management system while maintaining a powerful admin interface for content editors.

TL;DR

Payload CMS v2.30.4 Release

This maintenance release focuses on fixing several critical bugs in the admin UI and database operations. Key improvements include fixing relationship display issues in list drawers, resolving errors when duplicating blocks with nested items, and adding Turkish translation to the SEO plugin. The release also addresses UI consistency by standardizing the draft action button style and order in the edit-many modal.

Highlight of the Release

    • Fixed list drawer relationships not displaying when selecting existing uploads
    • Resolved errors when duplicating blocks with nested items
    • Fixed querying relationships by id path with REST API
    • Added Turkish translation to the SEO plugin
    • Fixed sorting by localized fields in PostgreSQL database adapter
    • Improved UI consistency for draft action buttons in edit-many modal

Migration Guide

No migration is required for this release. This is a patch release that fixes bugs and adds minor features without introducing breaking changes.

Upgrade Recommendations

We recommend all users upgrade to v2.30.4, especially if you:

  • Use the PostgreSQL database adapter with localized fields
  • Work with relationship fields in REST API queries
  • Use block fields with nested items
  • Need Turkish language support for the SEO plugin
  • Use the edit-many functionality with draft mode enabled

This is a patch release with no breaking changes, so upgrading should be straightforward:

npm install [email protected]
# or
yarn add [email protected]
# or
pnpm add [email protected]

Bug Fixes

Admin UI Improvements

  • List Drawer Relationship Display: Fixed an issue where relationships were not showing when selecting an existing upload in list drawers, improving the content editing experience.
  • Edit Many Modal Draft Button: Standardized the order and style of draft action buttons in the edit-many modal to match the default edit-collection view, preventing potential user errors from inconsistent UI patterns.
  • Block Duplication: Resolved errors that occurred when saving after duplicating blocks with nested items, fixing issue #6583.

API and Database Fixes

  • REST API Relationship Queries: Fixed an issue with querying relationships by id path using the REST API, addressing issue #9008.
  • PostgreSQL Localized Field Sorting: Corrected sorting functionality for localized fields in the PostgreSQL database adapter, resolving issue #5152.

New Features

SEO Plugin Enhancement

  • Turkish Translation Added: The SEO plugin now includes Turkish language support, making it more accessible to Turkish-speaking users and expanding Payload's internationalization capabilities.

Security Updates

No security fixes were included in this release.

Performance Improvements

While this release doesn't include explicit performance-focused changes, several bug fixes indirectly improve system performance:

  • The fix for PostgreSQL localized field sorting optimizes database queries when working with multilingual content.
  • Resolving the block duplication issue prevents unnecessary processing and potential memory issues when working with complex nested structures.

Impact Summary

Payload CMS v2.30.4 is a maintenance release that addresses several important bugs affecting the admin UI and database operations. The fixes improve the reliability of core features like relationship fields, block duplication, and localized content sorting.

The standardization of draft action buttons in the edit-many modal enhances UI consistency and reduces the chance of user error. The addition of Turkish language support for the SEO plugin continues Payload's commitment to internationalization.

For developers, the fixes to REST API relationship queries and PostgreSQL localized field sorting resolve pain points that could affect application functionality and data retrieval. Content editors will benefit from improved UI reliability when working with relationships in list drawers and when duplicating complex block structures.

Overall, this release enhances stability and usability without requiring any migration effort, making it a recommended upgrade for all Payload users.

Full Release Notes

2.30.4 (2024-11-11)

Features

Bug Fixes

  • db-postgres: sort by localized fields (#9016) (9c25754)
  • edit many modal draft action button order and style (#9046) (a907480), closes #9045
  • error saving after duplicating blocks with nested items (#8814) (eba777c)
  • list drawer relationship not displaying (#9011) (169da5c)
  • querying relationships by id path with REST (#9014) (a0bd706)

Statistics:

File Changed36
Line Additions40,315
Line Deletions198
Line Changes40,513
Total Commits19

User Affected:

  • Fixed UI issues with list drawer relationships now properly displaying when selecting existing uploads
  • Improved consistency of draft action buttons in edit-many modal to match the standard edit view
  • Fixed errors that occurred when duplicating blocks with nested items

Contributors:

denolfer1tsuueriksachseDanRibbensvahacreativeabernh