Home

>

Tools

>

Payload CMS

>

Releases

>

3.0.0-beta.30

Payload CMS Release: 3.0.0-beta.30

Pre Release

Tag Name: 3.0.0-beta.30

Release Date: 5/10/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

PayloadCMS 3.0.0-beta.30 introduces significant enhancements to the admin UI and developer experience. This release adds new storage capabilities with UploadThing integration, improves UI customization options, and fixes several bugs related to rich text, form elements, and localization. Developers gain more control over list views and relationship handling, making this beta release a solid step forward in PayloadCMS's development.

Highlight of the Release

    • New storage-uploadthing package for enhanced file upload capabilities
    • Added disableListColumn & disableListFilter admin props for better UI customization
    • New plugin-relationship-object-ids package for improved relationship management
    • Fixed rich text list item values that were returning null
    • Improved form element IDs in drawers to prevent conflicts

Migration Guide

No specific migration steps are required for this beta release. As this is a beta version (3.0.0-beta.30), users should be aware that APIs and features may still change before the final 3.0.0 release.

If you're using rich text with list items, radio/checkbox fields in drawers, or Next.js with locale fallbacks, you'll automatically benefit from the bug fixes in this release without any code changes required.

Upgrade Recommendations

If you're already using PayloadCMS 3.0.0-beta.29, upgrading to beta.30 is recommended as it includes important bug fixes and new features without breaking changes.

To upgrade:

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

If you're using a stable version of PayloadCMS and not already on the v3 beta track, it's recommended to wait for the final 3.0.0 release unless you specifically need these new features or fixes.

Bug Fixes

Rich Text List Item Values Fix

Fixed an issue where rich text list item values were returning null (#6291), ensuring proper rendering and data handling in rich text editors.

Form Element ID Conflicts in Drawers

Resolved an issue by appending editDepth value to radio and checkbox IDs when inside drawers (#6252), preventing ID conflicts that could cause incorrect form behavior.

Next.js Locale Handling

Fixed a bug to properly respect fallback locale null values in Next.js integration (#6207), improving localization handling in Next.js applications using Payload.

New Features

New Storage Integration with UploadThing

The new storage-uploadthing package (#6316) provides integration with UploadThing for file storage, giving developers more options for handling file uploads in Payload applications.

Enhanced Admin UI Customization

Payload now supports disableListColumn and disableListFilter properties in field admin configurations (#6238). These options give developers more control over which fields appear in list views and filters, allowing for cleaner and more focused admin interfaces.

Relationship Object IDs Plugin

The new plugin-relationship-object-ids package (#6044) provides enhanced functionality for managing relationships between collections, making it easier to work with object IDs in relationships.

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were highlighted in this release. The focus appears to be on new features, bug fixes, and documentation improvements.

Impact Summary

PayloadCMS 3.0.0-beta.30 brings valuable improvements to both developers and content editors. The addition of UploadThing integration expands storage options, while new admin UI customization features give developers more control over the admin interface. Bug fixes for rich text, form elements, and localization enhance stability.

The new relationship object IDs plugin provides more flexibility in handling relationships between collections. These changes collectively improve the developer experience and end-user interface without introducing breaking changes.

This beta release continues to refine PayloadCMS's feature set as it moves toward a stable 3.0.0 release, with contributions from multiple community members enhancing various aspects of the system.

Full Release Notes

Statistics:

File Changed21
Line Additions3,509
Line Deletions4,157
Line Changes7,666
Total Commits4

User Affected:

  • Access to new `storage-uploadthing` package for file uploads
  • Can use new `plugin-relationship-object-ids` package for relationship management
  • Bug fixes for rich text list items and Next.js locale handling

Contributors:

jacobsfletchPatrikKozakdenolfe