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.
Vercel Marketplace is currently in Public Alpha. If you encounter any issues or have feature requests, contact support.
Quickstart
Via Template
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:
_13POSTGRES_URL_13POSTGRES_PRISMA_URL_13POSTGRES_URL_NON_POOLING_13POSTGRES_USER_13POSTGRES_HOST_13POSTGRES_PASSWORD_13POSTGRES_DATABASE_13SUPABASE_SERVICE_ROLE_KEY_13SUPABASE_ANON_KEY_13SUPABASE_URL_13SUPABASE_JWT_SECRET_13NEXT_PUBLIC_SUPABASE_ANON_KEY_13NEXT_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
formember
andowner
forowner
.
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.