Skip to content

docs(vercel): document "Link Existing Account" flow for Vercel Marketplace integration #15420

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
MattBro merged 1 commit into from
Mar 6, 2026
Merged

docs(vercel): document "Link Existing Account" flow for Vercel Marketplace integration #15420

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 25 additions & 7 deletions contents/docs/integrations/vercel-marketplace.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,22 +8,37 @@ icon: >-
import { CalloutBox } from 'components/Docs/CalloutBox'
import Tab from "components/Tab"

The Vercel Marketplace integration adds PostHog feature flags and experiments to your Vercel projects with billing handled through Vercel.
The Vercel Marketplace integration adds PostHog to your Vercel projects. There are two ways to set it up:

Choose this integration if you do not already have a PostHog account and you prefer to consolidate payment for PostHog inside your Vercel invoice.
- **Add** – Creates a new PostHog organization with billing through Vercel
- **Link Existing Account** – Connects an existing PostHog organization. Billing stays with PostHog.

<CalloutBox icon="IconInfo" title="New organizations only" type="fyi">
<CalloutBox icon="IconInfo" title="Billing depends on how you install" type="fyi">

This integration creates a new PostHog organization. You cannot migrate an existing PostHog organization to be billed through Vercel.
New accounts created through the **Add** flow are billed through Vercel. Linked accounts keep their existing PostHog billing. You cannot migrate an existing PostHog organization to Vercel billing.

</CalloutBox>

## Installing the integration

### Add (new account)

1. Go to the [PostHog integration page](https://vercel.com/integrations/posthog) on Vercel Marketplace
2. Click **Install**
2. Click **Add**

This creates a new PostHog organization and project, and adds environment variables to your Vercel project. Billing goes through your Vercel account.

This creates a PostHog organization and project, and adds environment variables to your Vercel project.
### Link Existing Account

If you already have a PostHog account, you can connect it to Vercel instead:

1. Go to the [PostHog integration page](https://vercel.com/integrations/posthog) on Vercel Marketplace
2. Click **Link Existing Account**
3. Log in to your PostHog account if prompted
4. Select the organization you want to link
5. Click **Connect organization**

You must have admin or owner access to the PostHog organization to link it. Billing stays with PostHog for linked accounts.

## Environment variables

Expand Down Expand Up @@ -112,7 +127,10 @@ For full documentation:

## Billing

Billing goes through your Vercel account. View usage in Vercel under **Integrations** → **PostHog**.
Billing depends on how you installed the integration:

- **Add (new account)** – Billed through your Vercel account. View usage in Vercel under **Integrations** → **PostHog**.
- **Link Existing Account** – Billed through your existing PostHog account. View usage in [PostHog billing settings](https://app.posthog.com/organization/billing).

See [our pricing page](/pricing) for more details.

Expand Down