Skip to main content
PostHog tells Weelkit how readers behave on your site. Once it’s connected, Weelkit can show traffic and reader behavior for articles published through Weelkit. Weelkit only reads from PostHog. It never changes anything in your account.

Before you start

  • Who can connect it: an Admin or a Managing Editor. A custom role can connect it when it includes the permission to manage organization integration connections.
  • What you need: a PostHog account that can create a personal API key, and your PostHog address. An organization has one PostHog connection.

Create a key in PostHog

1

Open Personal API keys

In PostHog, open your account settings, then Personal API keys. The path is the same on EU Cloud and on your own PostHog.
2

Create a key

Create a key. You can limit it to one project.
3

Choose the permissions

Choose these read permissions: Project (read), Query (read) and Heatmap (read). Copy the key.

Connect

1

Start the connection

Open Organization settings → Integrations (Managing Editors open Integration). In the Analytics section, find PostHog and choose Connect.
2

Paste the key and the address

Paste the key into PostHog personal API key. In PostHog address, enter the address of your PostHog:
3

Choose the project

Choose Connect. Then, on the PostHog card, open the configure window and choose your project under PostHog project, and save.
Until you choose a project, Weelkit has nothing to show, and the metrics pages ask you to select one in Settings → Integrations. If PostHog doesn’t accept the key, the form says why. A missing permission or a wrong address are the usual causes. Fix it and connect again.

Use PostHog with Google Analytics

When both are connected, Show traffic figures from appears in Settings → Integrations. Choose Google Analytics or PostHog. Views, visitors, sessions, sources and countries come from the one you pick, so nothing is counted twice.

When a key stops working

If PostHog refuses the key, for example because it was deleted or expired, the card shows Paste a new key. Create a new key as above and paste it. It must be for the same PostHog address. Your project choice stays. If you can’t manage integrations, ask an Admin to paste a new key.

Disconnect

On the card, open the ⋯ menu, choose Disconnect, then choose Disconnect to confirm. Weelkit deletes its copy of the key. To remove the key itself, also delete it in PostHog under account settings, Personal API keys.