
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.

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.