Payload CMS Release: Release 1.0.26

TL;DR

PayloadCMS v1.0.26 brings important improvements to field management and developer experience. This release fixes issues with custom ID collections, adds more syntax highlighting options for code blocks, and introduces the ability to reorder hasMany relationship and select fields. These changes enhance content organization flexibility and improve the editing experience for content creators.

Highlight of the Release

• Added ability to reorder hasMany relationship and select fields with drag-and-drop functionality
• Fixed missing fields in rows on custom ID collections
• Expanded PrismJS syntax highlighting options for code blocks
• Improved CI workflow to run tests on pull requests

Migration Guide

No migration is required for this release. The new features are opt-in through configuration options.

For enabling sortable hasMany relationship and select fields, add the isSortable property to your field configuration:

{
  name: 'relatedItems',
  type: 'relationship',
  relationTo: 'items',
  hasMany: true,
  admin: {
    isSortable: true
  }
}

The same configuration can be applied to select fields with multiple selections enabled:

{
  name: 'categories',
  type: 'select',
  options: ['Category A', 'Category B', 'Category C'],
  hasMany: true,
  admin: {
    isSortable: true
  }
}

Upgrade Recommendations

This is a minor release with new features and bug fixes. It is recommended to upgrade to v1.0.26 to benefit from the improved field handling and additional syntax highlighting options.

The upgrade should be straightforward with no breaking changes:

1. Update your Payload CMS dependency to v1.0.26
2. Test your application to ensure everything works as expected
3. Consider implementing the new sortable field configurations where they would improve your content editing experience

Bug Fixes

Fixed Missing Fields in Rows on Custom ID Collections

This release resolves an issue where fields within row field types were not properly displaying in collections that use custom IDs. The fix ensures that:

• All fields within rows now correctly render in custom ID collections
• Data integrity is maintained when using row fields in these collections
• The admin UI properly displays all configured fields within row layouts

New Features

Reorderable hasMany Relationship and Select Fields

Payload now supports reordering items within hasMany relationship and select fields. This feature gives content editors more control over how related content or selected options are organized and displayed.

• Added new isSortable configuration option in the admin config for these field types
• Implemented drag-and-drop functionality with visual feedback (grab and grabbing cursor classes)
• Allows for intuitive reordering of items through the admin interface

Enhanced Code Block Syntax Highlighting

The code block field type now supports an expanded set of PrismJS syntax highlighting options:

• Added more language options for syntax highlighting in code blocks
• Improves readability and presentation of code snippets
• Enhances the developer and technical writing experience when working with code examples

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were mentioned in this release.

Impact Summary

This release enhances the content editing experience by adding more flexibility to field organization and improving code presentation. The ability to reorder hasMany relationship and select fields gives content editors more control over how related content is structured. The expanded syntax highlighting options improve code readability in technical documentation.

The bug fix for row fields in custom ID collections resolves an important issue that could affect data presentation in the admin UI. This ensures that all configured fields are properly displayed and accessible.

Overall, this release focuses on quality-of-life improvements for both content editors and developers, with no breaking changes that would require significant adaptation.

Full Release Notes