US English (US)
ES Spanish

Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form below and we will reply as soon as possible.

  • Appcues Certifications & Training
  • Integration Hub
  • Contact Us
English (US)
US English (US)
ES Spanish
  • Docs home
  • Installation & Developers
  • Installing Appcues on Web

Installing with Segment

A guide to install Appcues through Segment.

Updated at June 16th, 2025

Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form with the details about the help content you'd like to see.

  • Home

  • Installation & Developers

    • Web Experiences

      • Mobile Experiences

        • Workflows

          • Analytics & Data

            • Account Management

              • Best Practices

                • Integrations

                  Table of Contents

                  Activation Required Recommended Optional

                  This document is focused on installing Appcues in web applications using Segment, for information on installing Appcues in mobile applications using Segment see the Installing the Mobile SDK doc!

                  Appcues integrates with Segment's analytics.js client-side script.

                  Important: Segment must be actively installed on every page you would like your Appcues flows to appear, i.e., the analytics.identify() call must be called on every page load for the integration to work correctly. This means any user properties passed to Segment through the identify() call will also be passed to Appcues and will cause Appcues to show content that's targeted to that user (if they qualify).

                  Activation

                  The first thing you'll need to do is enable the Segment-Appcues integration (additional information about this setup is available in the Segment Appcues Destination documentation):

                  1. Find the Segment "source" for your application and select it.
                  2. Click the Add Destination button.
                  3. Search for "Appcues" and select it from the list of destinations. Click "Configure Appcues."
                  4. Enter your Appcues ID and/or Legacy API Key. The Appcues account ID will enable Appcues as a client-side Segment destination and is all that is required to install Appcues via Segment. Additionally, the Legacy API Key can be added to enable Appcues as a server-side Segment destination. If only wanting to send server-side events from Segment to Appcues, only the Legacy API Key is needed. You can find the account ID on your Account page and your Legacy API Key on the API Keys page (Also called the API Key on the account settings page for legacy plan customers).

                  That's it! Now Appcues is installed through Segment. Appcues will be set up anywhere your Segment script is installed.

                  Required

                  In Segment-speak, the Appcues integration "assumes page load". What this means is that if analytics.page() isn't called, Segment won't load our script.

                  Additionally, a call to analytics.identify() is required; otherwise, no user properties will be passed to Appcues from Segment. Without user identification, Appcues does not know how to attempt to show content.

                  Recommended

                  A call to analytics.group() will allow for group association with your users.  This will simplify the categorization for account-level properties.  Ingesting group properties to Appcues will allow you to target experiences based on wider group information reduce the overall number of user properties needed to be tracked, and in the near future be able to see account-level analytics directly in Appcues Studio.

                  Optional

                  Appcues will also receive data from Segment when analytics.track() is called.

                  Once the Appcues SDK script has been loaded by Segment, Appcues is fully loaded on the page. If there is any Appcues-specific data not being generated by Segment that you would prefer to leave out of your Segment implementation, it can be sent directly to Appcues via any of our standard Javascript API calls.

                  If you have questions or feedback on our Segment integration, please reach out to us at support@appcues.com.

                  segment install appcues destination add destination

                  Was this article helpful?

                  Yes
                  No
                  Give feedback about this article

                  Related Articles

                  • User Properties Overview
                  • Installation Guide for Developers
                  • Welcome and Getting Started
                  • Javascript API (Developer)
                  Appcues logo

                  Product

                  Why Appcues How it works Integrations Security Pricing What's new

                  Use cases

                  Appcues Integration Hub User Onboarding Software Feature Adoption Software NPS & Surveys Announcements Insights Mobile Adoption

                  Company

                  About
                  Careers

                  Support

                  Developer Docs Contact

                  Resources

                  The Appcues Blog Product Adoption Academy GoodUX Case studies Webinar Series Made with Appcues Appcues University

                  Follow us

                  Facebook icon Twitter icon grey Linkedin icon Instagram icon
                  © 2022 Appcues. All rights reserved.
                  Security Terms of Service Privacy Policy

                  Knowledge Base Software powered by Helpjuice

                  Expand