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

# PostHog

> Connect PostHog for product analytics and feature adoption tracking.

The PostHog integration brings product analytics and feature adoption data into Superhawk AI. Track how trial users engage with specific features, monitor conversion funnels, and understand which parts of your product drive the most value during trials.

## Prerequisites

* A PostHog account with a project set up
* Your PostHog **project API key** (found in PostHog under **Project Settings**)
* Workspace admin permissions in Superhawk AI

## Setup

<Steps>
  <Step title="Open integrations">
    Navigate to **Settings > Integrations** in your Superhawk AI workspace.
  </Step>

  <Step title="Find PostHog">
    Locate PostHog under the **Analytics & Monitoring** category.
  </Step>

  <Step title="Start the connection">
    Click **Connect** on the PostHog card.
  </Step>

  <Step title="Enter your API key">
    Paste your PostHog **project API key** into the field provided.
  </Step>

  <Step title="Configure tracking options">
    Select the tracking options for your integration:

    * **Autocapture events** -- automatically capture page views, clicks, and form submissions
    * **Feature flag tracking** -- sync feature flag evaluations to see which features trial users have access to
    * **Custom events** -- include any custom events your team has instrumented in PostHog
  </Step>

  <Step title="Save">
    Click **Save** to activate the integration. Data will begin flowing into Superhawk AI within a few minutes.
  </Step>
</Steps>

## Configuration Options

After connecting PostHog, you can adjust settings from **Settings > Integrations > PostHog**.

* **Autocapture** -- toggle automatic capture of page views and interactions on or off.
* **Feature flag tracking** -- enable or disable syncing of feature flag evaluations to see which trial users have access to specific features.
* **Event filters** -- limit which custom events are synced to Superhawk AI to keep your trial data focused.

## Troubleshooting

<Warning>
  Make sure you are using the **project API key**, not a personal API key. Personal keys do not have access to project-level event data.
</Warning>

<Tip>
  If you are self-hosting PostHog, you may need to provide your custom PostHog instance URL during setup. Look for the **Host URL** field in the connection dialog.
</Tip>