Payload CMS Release: Release 1.7.5

TL;DR

PayloadCMS v1.7.5 brings enhanced admin UI customization options and bug fixes

This release introduces powerful new admin UI customization features including custom admin buttons and rich text linking between collections. It also adds the ability to hide API URLs in the admin interface and fixes an issue with the file upload naming system. These improvements give developers more control over the admin experience while maintaining the platform's flexibility.

Highlight of the Release

• Added support for custom admin buttons to enhance admin UI functionality
• Introduced enableRichTextLink property for collections to control rich text relationships
• Added hideAPIURL option for collections and globals admin configuration
• Fixed file naming system to properly handle multiple digits in incremental naming

Migration Guide

No migration is required for this release. All new features are opt-in and backward compatible with existing PayloadCMS implementations.

To use the new features:

Custom Admin Buttons

Add custom buttons to your admin UI by configuring them in your collection or global configuration:

// Example of adding custom admin buttons
admin: {
  components: {
    buttons: {
      // Add your custom buttons here
    }
  }
}

Enable Rich Text Link

To enable rich text linking for a collection:

// In your collection config
admin: {
  enableRichTextLink: true
}

Hide API URL

To hide API URLs in the admin interface:

// In your collection or global config
admin: {
  hideAPIURL: true
}

Upgrade Recommendations

This is a minor release with new features and a bug fix. It's recommended to upgrade to take advantage of the new admin UI customization options and the fixed file naming functionality.

The upgrade should be straightforward with no breaking changes:

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

After upgrading, you can start using the new features by updating your collection and global configurations as needed.

Bug Fixes

Fixed Incremental File Naming

Resolved an issue with the incrementName function that was not correctly matching multiple digits in filenames. This fix ensures that when uploading files with the same name, the incremental numbering system (e.g., image-1.jpg, image-2.jpg, etc.) now properly handles double-digit and higher increments.

New Features

Custom Admin Buttons

Developers can now add custom buttons to the admin UI, allowing for enhanced workflow capabilities and custom actions. This feature provides greater flexibility in tailoring the admin experience to specific project needs.

Rich Text Link Enhancement

Added the enableRichTextLink property to collection admin configuration. This allows developers to control whether a collection can be linked to from rich text fields in other collections, providing more granular control over content relationships.

Hide API URL Option

Introduced the hideAPIURL option for both collections and globals admin configuration. When enabled, this option hides the API URL information in the admin interface, creating a cleaner experience for content editors who don't need to see this technical information.

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were mentioned in this release.

Impact Summary

PayloadCMS v1.7.5 enhances the developer and content editor experience by providing more customization options for the admin interface. The addition of custom admin buttons allows for tailored workflows and actions, while the rich text linking feature improves content relationships. The option to hide API URLs creates a cleaner interface for non-technical users.

The bug fix for incremental file naming ensures more reliable file uploads when dealing with duplicate filenames, preventing potential issues with file management.

Overall, this release continues PayloadCMS's commitment to providing a flexible and customizable headless CMS experience while addressing user feedback and fixing reported issues.

Full Release Notes