Last updated:

|Edit this page

Segment is a Customer Data Platform (CDP) that allows you to easily manage data and integrations with services across your growth, product, and marketing stack.

By tracking events and users via Segment’s API and libraries, you can send your product’s data to all of your analytics/marketing platforms, with minimal instrumentation code. They offer support for most platforms, including iOS, Android, JavaScript, Node.js, PHP, and more.

Before integrating with Segment, we recommend you read our CDP integration guide to understand the different options for integrating with PostHog.

Setting up Segment

Make sure you have a Segment account and a PostHog account, using PostHog Cloud or a self-hosted instance running version 1.30.0 or later.

  1. In the Segment workspace, create a new project and enable PostHog as an integration. We are listed as a destination on Segment.
  2. Grab the PostHog API key from your project settings.
  3. Use one of Segment's libraries to send events.
  4. See the events coming into PostHog.

Enabling all features via Segment with your website

The simple Segment destination only supports tracking of pageviews, custom events and identifying users.

In order to use the full feature set of PostHog (autocapture, session recording, feature flags, heatmaps, surveys or the toolbar) we need to load our own Javascript snippet directly.

  1. In addition to Segment, install your PostHog JS snippet

  2. Modify the initialization as documented below to pass the segment analytics through for PostHog JS to sync with:

    // Load PostHog JS
    !function(t,e){var o,n,p,r;e.__SV||(window.posthog=e,e._i=[],e.init=function(i,s,a){function g(t,e){var o=e.split(".");2==o.length&&(t=t[o[0]],e=o[1]),t[e]=function(){t.push([e].concat(,0)))}}(p=t.createElement("script")).type="text/javascript",p.async=!0,p.src=s.api_host+"/static/array.js",(r=t.getElementsByTagName("script")[0]).parentNode.insertBefore(p,r);var u=e;for(void 0!==a?u=e[a]=[]:a="posthog",u.people=u.people||[],u.toString=function(t){var e="posthog";return"posthog"!==a&&(e+="."+a),t||(e+=" (stub)"),e},u.people.toString=function(){return u.toString(1)+".people (stub)"},o="capture identify alias people.set people.set_once set_config register register_once unregister opt_out_capturing has_opted_out_capturing opt_in_capturing reset isFeatureEnabled onFeatureFlags getFeatureFlag getFeatureFlagPayload reloadFeatureFlags group updateEarlyAccessFeatureEnrollment getEarlyAccessFeatures getActiveMatchingSurveys getSurveys getNextSurveyStep".split(" "),n=0;n<o.length;n++)g(u,o[n]);e._i.push([i,s,a])},e.__SV=1)}(document,window.posthog||[]);
    // Segment script
    var analytics = "<Segment analytics snippet code>";
    analytics.ready(() => {
    window.posthog.init("<your-posthog-key>", {
    api_host: '', // Use for EU instances
    segment:, // Pass here - NOTE: `window.` is important
    capture_pageview: false, // You want this false if you are going to use segment's `` for pageviews
    // When the posthog library has loaded, call `` explicitly.
    loaded: () =>,

Sending events to PostHog

Once you have set up Segment and the destination properly configured, can use it to send events to PostHog. You can do this through the Segment API, or one of the Segment libraries. For example, with javascript you can use the analytics.track('Event Name') function to send events to Segment, which will then be sent to PostHog.

For the full list of functions see the relevant SDK docs e.g. the Javascript SDK.

Using group analytics

If you want to use group analytics, each event should include the property $groups as an key-value object of group type and ID like { "company": "company_id_in_your_db" }


Where can I find out more?

Further information is available in Segment's integration catalog.

Who maintains this app?

This app is maintained by Segment. If you have issues with the app not functioning as intended, please let us know!

What if I have feedback on this app?

We love feature requests and feedback! Please tell us what you think! to tell us what you think.

What if my question isn't answered above?

We love answering questions. Ask us anything via our community forum, or drop us a message.


Was this page useful?

Next article


Why does this exist? Our Sentry integration is a two-way integration which works on Javascript & Python. Once installed, it will: Add a direct link in Sentry to the profile of the person affected in PostHog. Send an $exception event to PostHog with a direct link to Sentry. This way, debugging issues becomes a lot easier, and you can also correlate error data with your product metrics. If you're looking for the PostHog + Sentry integration for Python, please check out the Python docs…

Read next article