Vercel Marketplace

This topic explains how to install the Vercel Marketplace integration. Installing from the Vercel Marketplace provisions an account and connects it to your Vercel project automatically, with billing through Vercel. Every project you create through the Marketplace listing is a full LaunchDarkly project. It supports the same features other LaunchDarkly projects use, including progressive rollouts, guarded releases, Experimentation, and AgentControl config management. To learn about the full range of LaunchDarkly features, read LaunchDarkly documentation. You can connect your existing LaunchDarkly account during installation instead of creating a new one. This works on Developer and Foundation plans, so the integration attaches to the projects and flags you already have without migrating anything. If you do not have a LaunchDarkly account yet, installation creates one for you automatically, giving you a working environment and your first flag without leaving Vercel. Read Vercel instead if you:

• Want to connect an existing account without going through the Marketplace
• Want Global Config sync without billing through Vercel
• Have an existing LaunchDarkly Enterprise account

Installing from the Marketplace sets up the following automatically:

• A new account and project, with Development, Preview, and Production environments that mirror your Vercel environments.
• An SDK key and client-side ID for each Vercel environment, synced into your Vercel project as environment variables. Your preview deploys never evaluate against your production flag state.
• Sign-in through Vercel. Use Open in LaunchDarkly at any time to access the full application. To learn more, read Sign in to LaunchDarkly from Vercel.

​

Install the integration

Installing from the Vercel Marketplace gives you a LaunchDarkly account, project, and SDK keys connected to your Vercel project without leaving Vercel. To install from the Vercel Marketplace:

1. Navigate to the Vercel Marketplace and find the LaunchDarkly listing in the Flags category.
2. Click Install.
3. Choose whether to create a new account or link an existing one:
   • To create a new account, follow the prompts to provision a project automatically.
   • To link an existing account, select it during installation instead of creating a new one. Your existing projects, flags, and SDK keys remain as they are.
4. Complete installation. Your Vercel project now has the SDK key and client-side ID for each environment available as environment variables.

​

Sign in to LaunchDarkly from Vercel

After you install the integration, you sign in to LaunchDarkly from the Vercel UI instead of from the LaunchDarkly sign in page. Vercel sends LaunchDarkly a signed authentication token that identifies you and the LaunchDarkly account linked to your installation. To sign in to LaunchDarkly from Vercel:

1. Navigate to your LaunchDarkly installation in the Vercel UI.
2. Click Open in LaunchDarkly. Vercel redirects you to LaunchDarkly with a signed authentication token, and LaunchDarkly validates the token and signs you in to the account linked to your installation.

If the email address on your Vercel account matches a member of the linked LaunchDarkly account, LaunchDarkly signs you in automatically. If it does not match a member, an error appears. To add a member to your LaunchDarkly account, read Members. Signing in from Vercel does not create a new LaunchDarkly account. Installing from the Marketplace creates the account. After that, signing in from Vercel only signs in people who are already members of the linked account. If you lose access to your Vercel account, reset your LaunchDarkly password to sign in directly.

​

How Vercel sign-in works

When you open LaunchDarkly from Vercel, Vercel sends LaunchDarkly a signed JSON Web Token (JWT). LaunchDarkly validates the token against Vercel’s public keys to confirm your identity. The token includes your Vercel user information and an installation identifier. LaunchDarkly uses the installation identifier to determine which LaunchDarkly account your Vercel installation is linked to. If your email address belongs to more than one LaunchDarkly account, LaunchDarkly signs you in to the account that matches the installation.

​

Sync flags and projects

Syncing flags and projects to Vercel lets your team view what exists in LaunchDarkly without switching tools. Flags and projects created through this integration sync back to Vercel automatically.

​

Sync targeting to Vercel Global Config

Syncing flag targeting to Vercel Global Config lets your flags evaluate in Vercel Functions without a network call back to LaunchDarkly. You can avoid adding a runtime dependency on a call to LaunchDarkly for every flag evaluation.

​

Rotate SDK keys

Rotating your SDK keys from the integration keeps your synced environment variables in Vercel up to date without manual changes. You can rotate keys as part of routine credential management without editing environment variables in Vercel by hand.

​

Manage billing through Vercel

Billing through Vercel puts LaunchDarkly on your existing Vercel invoice, with no separate procurement step. Start on the free Developer plan and upgrade to Foundation when you need to, both managed from Vercel.

​

Uninstall the integration

Uninstalling the integration does not delete your LaunchDarkly account. Your projects, flags, and other data stay in place unless you delete them separately. Deleting a LaunchDarkly project through Vercel is a separate, deliberate action, and it does remove that project’s data. Uninstalling the integration alone does not trigger this.