Payload CMS Release: Release 1.9.1

TL;DR

Payload CMS v1.9.1 Release

This minor release introduces two key features to Payload CMS: customizable upload filenames and collection list view extension points. The update allows developers to control how uploaded files are named and provides new ways to customize collection list views with custom components. These improvements enhance developer flexibility and UI customization options without introducing breaking changes.

Highlight of the Release

• Customizable filenames for uploaded files
• New extension points for collection list views
• Internal improvements to array and block row handling

Migration Guide

No migration is required for this release as it only adds new features without breaking changes.

Upgrade Recommendations

This is a minor feature release that adds new capabilities without breaking existing functionality. It's safe to upgrade from v1.9.0 to v1.9.1 without any code changes.

To upgrade:

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

After upgrading, you can optionally implement the new features (custom upload filenames and collection list view components) as needed.

Bug Fixes

No specific bug fixes were mentioned in this release.

New Features

Customizable Upload Filenames

Payload now allows developers to customize how filenames are generated for uploaded files. This feature provides greater control over file organization and naming conventions in your CMS.

You can now specify a custom function to generate filenames for uploads:

const uploadCollection = {
  slug: 'uploads',
  upload: {
    staticDir: '/path/to/uploads',
    // New option to customize filenames
    generateFilename: ({ filename, file }) => {
      // Custom logic to generate filename
      return `custom-prefix-${filename}`;
    }
  },
  fields: [
    // ...fields
  ]
}

Collection List View Extension Points

This release introduces four new extension points for collection list views, allowing developers to add custom components at strategic positions:

1. BeforeList - Renders before the entire list component
2. BeforeListTable - Renders after list controls but before the table
3. AfterListTable - Renders after the table but before pagination
4. AfterList - Renders after the entire list component

These extension points enable more flexible and powerful UI customizations for collection lists.

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were highlighted in this release, although there were internal changes related to array and block row handling that might indirectly improve performance.

Impact Summary

This release enhances developer flexibility with two new features: customizable upload filenames and collection list view extension points.

The upload filename customization allows for more organized media libraries and implementation of specific naming conventions, which can be particularly valuable for sites with many uploads or specific organizational requirements.

The collection list view extension points open up new possibilities for UI customization, enabling developers to inject custom components at strategic positions in the list view. This can be used to add contextual information, custom controls, or integrate with other systems.

These additions maintain backward compatibility while providing new options for developers to enhance their Payload CMS implementations.

Full Release Notes