Payload CMS Release: Release 1.15.4

TL;DR

PayloadCMS v1.15.4 delivers important bug fixes that improve user authentication, query handling, and template functionality. This maintenance release ensures better consistency between API and admin panel behavior, fixes user data handling, and enhances ecommerce templates with several improvements. While primarily focused on bug fixes, these changes improve the overall stability and developer experience of the CMS.

Highlight of the Release

• Fixed inconsistency between local API and admin panel depth behavior
• Improved user authentication by using full user data instead of partial JWT data
• Enhanced query handling for versioned content
• Multiple improvements to ecommerce template including related products and NextJS HMR

Migration Guide

No migration is required for this release. The changes are backward compatible and focus on fixing existing functionality rather than introducing breaking changes.

Upgrade Recommendations

All users are recommended to upgrade to v1.15.4, especially if you:

• Use authentication in your Payload application
• Work with versioned content
• Fetch related content through both the local API and admin panel
• Use the ecommerce template

The upgrade process should be straightforward:

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

No configuration changes are required after upgrading.

Bug Fixes

• User Authentication: Fixed an issue where partial JWT data was being used instead of full user data from fetchFullUser (#3279), resolving issue #3274
• API Consistency: Aligned depth behavior between local API and admin panel to ensure consistent results when fetching related content (#3276)
• Query Handling: Fixed versioning by properly appending versions key to incoming where queries (#3287)
• Parameter Handling: Changed scoping of force parameter to prevent false negation (#3278)
• Ecommerce Template: Several fixes including:
  • Fixed product published dates
  • Improved NextJS hot module replacement (HMR)
  • Prevented server from restarting when app files change
  • Added related products functionality

New Features

No significant new features were introduced in this release. This version focuses primarily on bug fixes and template improvements.

Security Updates

No security fixes were included in this release.

Performance Improvements

This release does not include any specific performance improvements. The focus was on bug fixes and template enhancements rather than performance optimizations.

Impact Summary

PayloadCMS v1.15.4 is a maintenance release that addresses several important bugs affecting user authentication, query handling, and template functionality. The fixes ensure more consistent behavior between the local API and admin panel, particularly when working with related content. User authentication has been improved by ensuring full user data is used instead of partial JWT data. The ecommerce template received several enhancements including related products functionality, fixed product published dates, and improved NextJS hot module replacement for a better development experience. While this release doesn't introduce new features, it significantly improves the stability and reliability of existing functionality, making it a recommended upgrade for all users.

Full Release Notes