Skip to content

Writing

Payload CMS v4: What’s New and My v3 Upgrade Experience

Payload v4 brings a redesigned admin UI and TanStack Start support. I upgraded my portfolio CMS from v3, deployed it on Netlify, and here is how it went and when I would use it for client projects.

By Sifat Rabbi2 min readTechnologyOpinion
Handwritten notebook page reading “Payload v3 to v4” beside a sketch of the new admin panel

For a long time, I've seen that Payload is getting a new version. The current version is v3, and the new version is v4. The v4 beta is out now, so I tried it on my own website.

In this post, I will share how the upgrade went, what I liked, and when I would use it for client projects.

What Is New in Payload v4

V4 includes major changes. The most important change I was looking forward to is the UI redesign. I don’t really like the current design.

Payload also added core hierarchies, better digital asset management, and improvements for AI tools like MCP. You can read the full list in the official Payload v4 beta announcement.

Why I Tried a Beta Version on My Portfolio

Using a beta version in production carries a real risk. But I like trying new things. So I am applying this to my portfolio website. Even if there are smaller issues here and there, they won’t affect much.

I would not do this on a client project. Although the current beta is much more stable, it is still in beta, so issues could still arise.

How I Upgraded from v3 to v4

  • Before: Payload 3.88.0, Next.js 15.4.11, database Postgres
  • After: Payload 4.0.0-beta.9, Next.js 16.4.6
  • Steps I followed: Payload v4 Migration Guide
  • The AI Tool I used: Cursor with Muse Wonder + Grok
  • Problems I hit: I didn't run into any issues.

The New Admin UI

The UI looks much nicer and cleaner compared to v3.

Payload V4 Dashboard Screenshot

The Recently Viewed section looks awesome.

Deploying Payload v4 on Netlify

My portfolio CMS is hosted on Netlify. I deployed v4 to Netlify without any issues. I didn't have to configure anything on Netlify.

TanStack Start Support

V4 also introduced support for TanStack Start. Though Next.js is still the primary framework. I haven't tried the TanStack version yet. But out of curiosity, I'll try it soon and see how it goes. After that, I will update here.

Should You Use Payload v4 in Production?

Right now, it is a beta, so my answer is: not for anything important. For a personal project or a portfolio like mine, I think it is fine.

When I Will Migrate My Clients to v4

I actually liked most of what Payload v4 offers. So when there is a stable release, I will start migrating my clients from Payload v3 to v4.

If you want to know what I think about Payload in general, read my Payload CMS Review.

FAQ

As of 17th November, 2026. No, it is in beta.

Contact

Let's work together

If you're hiring for a Staff, Principal, or Lead role (remote or onsite), or building something in healthcare, fintech, or AI, email me and we can talk it through.

Open to full-time and part-time roles (remote or onsite)

Also on Toptal. Email is the best way to start a conversation.