Payload CMS Release: 2.31.0

TL;DR

Payload CMS 2.31.0 introduces several new features and bug fixes. Key highlights include the ability to filter on group field types from list view, a new forceRenderAllFields admin property to improve field searching, and Slovenian language support. Bug fixes address GraphQL query issues with access-controlled hasMany fields and fix a pagination limitation when publishing drafts.

Highlight of the Release

• Added ability to filter on group field types from list view
• New forceRenderAllFields admin property to force immediate rendering of all fields in edit view
• Added Slovenian (sl) language translation
• Fixed GraphQL 500 error when querying hasMany field data filtered by access control
• Fixed pagination limitation when publishing drafts (previously limited to 10)

Migration Guide

Using the New Features

Group Field Filtering

No configuration is needed to use the new group field filtering capability. It's automatically available in the list view for collections that contain group fields.

Force Render All Fields

To enable immediate rendering of all fields in the edit view:

// In your collection or global config
{
  slug: 'your-collection',
  admin: {
    forceRenderAllFields: true,
  },
  fields: [
    // your fields
  ]
}

Slovenian Language

To use the Slovenian language translation:

// In your Payload config
export default buildConfig({
  admin: {
    user: 'users',
    i18n: {
      language: 'sl',
    },
  },
  // rest of your config
});

Upgrade Recommendations

This is a minor version update with new features and bug fixes. It's recommended to upgrade to take advantage of the improved filtering capabilities, field rendering options, and bug fixes.

The update should be straightforward with no breaking changes reported. As always, test in a development environment before deploying to production.

Bug Fixes

GraphQL Query Error Fix

Fixed a 500 error that occurred when querying hasMany field data that is filtered by access control in GraphQL. The issue was resolved by filtering null items from the results array.

Draft Publishing Limitation Fix

Previously, when publishing from a draft, only 10 items were published due to an unintended pagination limit. This limitation has been removed, allowing users to publish all drafts as expected.

New Features

Group Field Filtering in List View

You can now filter on group field types from the list view. This enhancement allows for more granular filtering capabilities, making it easier to find specific content based on fields nested within groups.

Force Render All Fields Option

A new forceRenderAllFields admin property has been added to collection and global configurations. When enabled, this forces all fields in the edit view to render immediately, regardless of scroll position. This makes it easier to locate fields using browser search (CMD+F).

admin: {
  forceRenderAllFields: true,
},

Slovenian Language Support

Added Slovenian (sl) language translation, expanding the internationalization capabilities of Payload CMS.

Security Updates

No specific security fixes were included in this release.

Performance Improvements

The new forceRenderAllFields admin property provides a performance trade-off option. By default, Payload progressively renders fields to balance load times and improve performance. With this new option, users can choose to prioritize field searchability over initial load performance when needed.

Impact Summary

Payload CMS 2.31.0 enhances the user experience with improved filtering capabilities and field rendering options. The ability to filter on group field types in the list view provides more granular data management. The new forceRenderAllFields admin property offers a solution for users who need to search for fields using browser search functionality.

The bug fixes address important issues with GraphQL queries and draft publishing, improving reliability for API consumers and content editors. The addition of Slovenian language support continues Payload's commitment to internationalization.

Overall, this release focuses on quality-of-life improvements for both developers and content editors, with particular emphasis on filtering, field accessibility, and internationalization.

Full Release Notes