Skip to content

Commit ac55a62

Browse files
authored
docs(vercel): document "Link Existing Account" flow for Vercel Marketplace integration (#15420)
Co-authored-by: inkeep[bot] <257615677+inkeep[bot]@users.noreply.github.com>
1 parent 29c4c03 commit ac55a62

File tree

1 file changed

+25
-7
lines changed

1 file changed

+25
-7
lines changed

contents/docs/integrations/vercel-marketplace.mdx

Lines changed: 25 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,22 +8,37 @@ icon: >-
88
import { CalloutBox } from 'components/Docs/CalloutBox'
99
import Tab from "components/Tab"
1010

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

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

15-
<CalloutBox icon="IconInfo" title="New organizations only" type="fyi">
16+
<CalloutBox icon="IconInfo" title="Billing depends on how you install" type="fyi">
1617

17-
This integration creates a new PostHog organization. You cannot migrate an existing PostHog organization to be billed through Vercel.
18+
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.
1819

1920
</CalloutBox>
2021

2122
## Installing the integration
2223

24+
### Add (new account)
25+
2326
1. Go to the [PostHog integration page](https://vercel.com/integrations/posthog) on Vercel Marketplace
24-
2. Click **Install**
27+
2. Click **Add**
28+
29+
This creates a new PostHog organization and project, and adds environment variables to your Vercel project. Billing goes through your Vercel account.
2530

26-
This creates a PostHog organization and project, and adds environment variables to your Vercel project.
31+
### Link Existing Account
32+
33+
If you already have a PostHog account, you can connect it to Vercel instead:
34+
35+
1. Go to the [PostHog integration page](https://vercel.com/integrations/posthog) on Vercel Marketplace
36+
2. Click **Link Existing Account**
37+
3. Log in to your PostHog account if prompted
38+
4. Select the organization you want to link
39+
5. Click **Connect organization**
40+
41+
You must have admin or owner access to the PostHog organization to link it. Billing stays with PostHog for linked accounts.
2742

2843
## Environment variables
2944

@@ -110,7 +125,10 @@ For full documentation:
110125

111126
## Billing
112127

113-
Billing goes through your Vercel account. View usage in Vercel under **Integrations****PostHog**.
128+
Billing depends on how you installed the integration:
129+
130+
- **Add (new account)** – Billed through your Vercel account. View usage in Vercel under **Integrations****PostHog**.
131+
- **Link Existing Account** – Billed through your existing PostHog account. View usage in [PostHog billing settings](https://app.posthog.com/organization/billing).
114132

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

0 commit comments

Comments
 (0)