Integrations

Vercel Marketplace


Overview

The Vercel Marketplace is a feature that allows you to manage third-party resources, such as Supabase, directly from the Vercel platform. This integration offers a seamless experience with unified billing, streamlined authentication, and easy access management for your team.

When you create an organization and projects through Vercel Marketplace, they function just like those created directly within Supabase. However, the billing is handled through your Vercel account, and you can manage your resources directly from the Vercel dashboard or CLI. Additionally, environment variables are automatically synchronized, making them immediately available for your connected projects.

For more information, see Introducing the Vercel Marketplace blog post.

Quickstart

Via Template

Deploy a Next.js app with Supabase Vercel Storage now

Uses the Next.js Supabase Starter Template

Deploy with Vercel

Via Vercel Marketplace

Details coming soon..

Connecting to Supabase Project

Supabase Projects created via Vercel Marketplace are automatically synchronized with connected Vercel projects. This synchronization includes setting essential environment variables, such as:


_13
POSTGRES_URL
_13
POSTGRES_PRISMA_URL
_13
POSTGRES_URL_NON_POOLING
_13
POSTGRES_USER
_13
POSTGRES_HOST
_13
POSTGRES_PASSWORD
_13
POSTGRES_DATABASE
_13
SUPABASE_SERVICE_ROLE_KEY
_13
SUPABASE_ANON_KEY
_13
SUPABASE_URL
_13
SUPABASE_JWT_SECRET
_13
NEXT_PUBLIC_SUPABASE_ANON_KEY
_13
NEXT_PUBLIC_SUPABASE_URL

These variables ensure your applications can connect securely to the database and interact with Supabase APIs.

Studio support

Accessing Supabase Studio is simple through the Vercel dashboard. You can open Supabase Studio from either the Integration installation page or the Vercel Storage page. Depending on your entry point, you'll either land on the Supabase dashboard homepage or be redirected to the corresponding Supabase Project.

Supabase Studio provides tools such as:

  • SQL Editor: Run SQL queries against your database.
  • Table Editor: Create, edit, and delete tables and columns.
  • Log Explorer: Inspect real-time logs for your database.
  • Postgres Upgrades: Upgrade your Postgres instance to the latest version.
  • Compute Upgrades: Scale the compute resources allocated to your database.

Permissions

There is a direct one-to-one relationship between a Supabase Organization and a Vercel team. Installing the integration or launching your first Supabase Project through Vercel triggers the creation of a corresponding Supabase Organization if one doesn’t already exist.

When Vercel users interact with Supabase, they are automatically assigned Supabase accounts. New users get a Supabase account linked to their primary email, while existing users have their Vercel and Supabase accounts linked.

  • The user who initiates the creation of a Vercel Storage database is assigned the owner role in the new Supabase organization.
  • Subsequent users are assigned roles based on their Vercel role, such as developer for member and owner for owner.

Role management is handled directly in the Vercel dashboard, and changes are synchronized with Supabase.

Note: you can invite non-Vercel users to your Supabase Organization, but their permissions won't be synchronized with Vercel.

Pricing

Pricing for databases created through Vercel Marketplace is identical to those created directly within Supabase. Detailed pricing information is available on the Supabase pricing page.

The usage page tracks the usage of your Vercel databases, with this information sent to Vercel for billing, which appears on your Vercel invoice.

Note: Supabase Organization billing cycle is separate from Vercel's. Plan changes will reset the billing cycle to the day of the change, with the initial billing cycle starting the day you install the integration.

Limitations

When using Vercel Marketplace, the following limitations apply:

  • Projects can only be created or removed via the Vercel dashboard.
  • Organizations cannot be removed manually; they are removed only if you uninstall the Vercel Marketplace Integration.
  • Owners cannot be added manually within the Supabase dashboard.
  • Invoices and payments must be managed through the Vercel dashboard, not the Supabase dashboard.