DEV Community


Posted on • Updated on

How to connect Supabase to Payload CMS

The release of Payload 2.0 has brought about some exciting changes, including the addition of support for the Postgres Database. This enhanced feature expands the platform's capabilities, allowing for a more diverse range of functions and operations. Now, you have the freedom and flexibility to use a backend like Supabase.

This is a significant improvement, as it allows for more robust and versatile solutions, catering to a wider range of backend development needs and facilitating a smoother, more efficient workflow.


  • Familiar with Payload CMS.
  • Familiar with Supabase

Create a Supabase Project

Start by going to the Supabase website at Once there, you'll need to create a new account. This process involves providing some basic information about yourself, including your name and email address.

Once you've filled out all the necessary fields, click the 'Sign Up' button to complete the process. By creating a Supabase account, you'll gain access to a variety of powerful tools and features that can help streamline your workflow and enhance your projects.

Create a new project

supabase project creation

Navigate to Database in the side menu and copy the Postgress URI

supabase postgress uri

In a separate file paste your URI and replace [YOUR-PASSWORD] with the password of the supabase database.

Now we have what we need to connect supabase to our Payload Application.

Create a Payload Application

Open the terminal and create a payload
npx create-payload-app@latest

Name your project and when prompted, paste the Postgres URI string from supabase

Once completed, cd into your project and open your payload app in Visual Studio Code with the command:
code .

In Visual Studio Code open the terminal and run the command:

yarn dev

This will run the payload application locally on your machine. Once complete you can navigate to the localhost in the browser ****and create a user to login to the Payload CMS admin panel:

Payload CMS Admin Panel

After you have successfully completed the process of creating a new user, you will be directed to the Admin Dashboard. This interface is designed to provide you with a comprehensive overview and easy access to all the necessary administrative functions.

If you navigate to your Supabase account and check your user management section, you'll be able to see the new user that you've just successfully created.

Supabase Database Dashboard

This verifies that the user creation process has been completed correctly, and the new account is now part of your user database.


Congratulations on your successful integration of Supabase with Payload CMS. This is a significant achievement that enables you to create comprehensive full-stack applications.

With this connection, you now have access to a robust backend that can handle a vast variety of tasks efficiently. At the same time, you also have a fully-featured Content Management System at your disposal.

This CMS can help manage your content effectively, providing you with a plethora of options for customization and control. Now, you can build and manage your applications with more efficiency, flexibility, and power.

Support me here

Top comments (3)

danribbens profile image
Dan Ribbens

Great work @petipois! This is so good to see.
Are you in the Payload Discord? Let me know if you need anything.

petipois profile image

Thank you

endymion1818 profile image
Ben Read

Awesome! I’ve got to try Payload out again.