3.39.1

Tag Name: v3.39.1

Release Date: 5/22/2025

Payload CMS LogoPayload CMS

Payload CMS is a modern, self-hosted headless content management system built with TypeScript, Node.js, and MongoDB. It's designed specifically for developers who want full control over their content management system while maintaining a powerful admin interface for content editors.

TL;DR

PayloadCMS v3.39.1: Bug Fix for Folders Feature and Template Improvements

This patch release fixes export paths for the new Folders feature, adds documentation for the Folders beta, and improves templates by including the UI package. This release ensures proper functionality of the Folders feature and enhances the developer experience when using PayloadCMS templates.

Highlight of the Release

    • Fixed folder export paths to ensure proper functionality after import map generation
    • Added documentation for the Folders beta feature
    • Updated templates to explicitly include the @payloadcms/ui package
    • Bumped templates to match v3.39.0 functionality

Migration Guide

No migration is required for this patch release. Users can update from v3.39.0 to v3.39.1 without any additional steps.

If you're using templates, the updated templates now include the @payloadcms/ui package explicitly, which resolves issues with folder views.

Upgrade Recommendations

This patch release is recommended for all users, especially those who:

  1. Are using or planning to use the Folders feature
  2. Are working with PayloadCMS templates that utilize folder views

The update fixes critical export path issues with the Folders feature and ensures templates have all required dependencies.

To upgrade:

npm install payload@3.39.1
# or
yarn add payload@3.39.1
# or
pnpm add payload@3.39.1

Bug Fixes

Fixed Folder Export Paths

This release fixes issues with folder exports after generating the import map. The fix ensures that the export paths for the Folders feature work correctly, addressing a critical issue that could prevent proper functionality of the feature. This was resolved in PR #12501.

New Features

No new features were introduced in this patch release. This is primarily a bug fix and documentation update release that addresses issues with the Folders feature introduced in previous versions.

Security Updates

No security fixes were included in this patch release.

Performance Improvements

No specific performance improvements were included in this patch release. The changes were focused on bug fixes, documentation, and template updates rather than performance enhancements.

Impact Summary

This patch release has a moderate impact, primarily affecting developers using the Folders feature or PayloadCMS templates. The fix for folder export paths resolves a critical issue that could prevent proper functionality of the Folders feature. Additionally, the template updates ensure that all necessary dependencies are included, particularly the @payloadcms/ui package which is required for folder views.

The documentation updates for the Folders beta feature provide valuable information for developers looking to implement this functionality. Overall, this release improves stability and usability without introducing breaking changes.

Full Release Notes

Statistics:

File Changed60
Line Additions310
Line Deletions287
Line Changes597
Total Commits5

User Affected:

  • Fixed issue with folder exports after generating import map, ensuring proper functionality
  • Templates now include the `@payloadcms/ui` package explicitly, resolving folder view issues
  • Access to documentation for the new Folders beta feature

Contributors:

denolfeDanRibbens