Payload CMS Release: 3.35.1

Tag Name: v3.35.1

Release Date: 4/17/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

Payload CMS v3.35.1: Bug Fix for Next.js Integration and Improved Postgres Error Messages

This patch release fixes a critical export issue in the Next.js integration package and improves error messaging for PostgreSQL users when table names exceed character limits. The update ensures developers using Next.js authentication can properly import the required modules and provides clearer guidance for PostgreSQL database configuration.

Highlight of the Release

    • Fixed missing @payloadcms/next/auth export in the Next.js integration package
    • Improved error messaging for PostgreSQL users when table names exceed the 63-character limit

Migration Guide

No migration is required for this patch release. Simply update your Payload CMS version to v3.35.1 to benefit from the fixes.

Upgrade Recommendations

This patch release is highly recommended for:

  • Developers using the Next.js integration with Payload CMS, especially if you're utilizing the authentication features
  • PostgreSQL users who may encounter table name length limitations

The update is backward compatible and requires no code changes or migration steps. You can upgrade using your package manager:

npm install [email protected]
# or
yarn upgrade [email protected]
# or
pnpm update [email protected]

Bug Fixes

Fixed Missing Next.js Auth Export

The @payloadcms/next/auth export was missing from the published package.json because it was excluded from the publishConfig property. This issue, which was introduced in a previous update, has been resolved in this patch release. Developers using the Next.js integration can now properly import the authentication module without encountering errors.

This fix addresses the issue reported and resolved in PR #12144, which was a follow-up to PR #11900.

New Features

No new features were added in this patch release.

Security Updates

No security fixes were included in this patch release.

Performance Improvements

No specific performance improvements were included in this patch release.

Impact Summary

This patch release addresses two specific issues without introducing any breaking changes:

  1. Next.js Integration Fix: Resolves a critical issue where the @payloadcms/next/auth export was missing from the published package, preventing developers from properly importing and using the Next.js authentication integration.

  2. Improved PostgreSQL Error Messages: Enhances developer experience by providing clearer error messages when PostgreSQL table names exceed the 63-character limit, including helpful guidance about using the dbName property as a solution.

Both changes improve the developer experience without requiring any code modifications from users. The fixes ensure better compatibility with Next.js frameworks and provide clearer guidance for PostgreSQL database configuration.

Full Release Notes

v3.35.1 (2025-04-17)

🐛 Bug Fixes

🏡 Chores

  • db-postgres: improve table name length exceeded error message (#12142) (0a59707)

🤝 Contributors

  • Jessica Chowdhury (@JessChowdhury)
  • Sasha (@r1tsuu)

Statistics:

File Changed37
Line Additions44
Line Deletions37
Line Changes81
Total Commits3

User Affected:

  • Can now properly import the `@payloadcms/next/auth` module which was missing from the published package
  • No longer need to implement workarounds for the missing export

Contributors:

r1tsuujessrynkardenolfe