> ## Documentation Index
> Fetch the complete documentation index at: https://docs.weelkit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PostHog

> Connect a PostHog project so Weelkit shows traffic and reader behavior for the articles you publish.

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](https://docs.weelkit.com/settings/organization.md#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:

| Your PostHog | Address |
| - | - |
| US Cloud | `https://us.posthog.com` |
| EU Cloud | `https://eu.posthog.com` |
| Your own PostHog | Its address. It must be reachable from the internet over HTTPS. |

**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**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.