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
  • Docs home
  • Installation & Developers
  • Installing Appcues Web

Host Appcues SDK Under Your Own Domain

Learn about hosting the Appcues SDK under your own domain to avoid Ad Blockers.

Updated at February 18th, 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.

  • Installation & Developers
    Installing Appcues Web Installing Appcues Mobile API & Data Troubleshooting Extras
  • Web Experiences
    Building Web Experiences Targeting Studio Customization & Styling Use Cases Troubleshooting FAQ
  • Mobile Experiences
    Installation & Overview Building Mobile Experiences Mobile Analytics & Integrations Troubleshooting
  • Workflows
    Building & Configuration Use Cases Workflow Analytics and Integrations
  • Account Management
    Subscription Users & Data
  • Analytics
    Experience and Event Analytics Data
  • Best Practices
    Best Practices Use Cases Pro Tips Product-led Growth
  • Integrations
    Integration Documents Use Cases Extras
  • System Status
    System Status & Incidents
+ More

Table of Contents

You will need: Setup Instructions: After Setup:

If you want the Appcues Javascript SDK to be served from domains that you control, you can host the Appcues SDK under your own domain. To perform these steps, you will need to configure a CNAME record using your domain's management tools to point to our infrastructure.  After that work is done, Appcues will issue an SSL certificate, and then serve the Appcues SDK from this domain instead of from Appcues' domain.

You will need:

  • Your Appcues account ID
  • You or someone will need administrative access to the custom domain you want to host the SDK from

Setup Instructions:

  1. Create your desired domain name (such as apc.example.com or anything else) as a CNAME record. Point your domain to {account-id}.custom-domains.appcues.com. At this point that domain won't exist, but Appcues will create it in step 2:
  2. Provide your account ID and domain name you created in step 1 to your Appcues team. They will send this to our DevOps team, who will set up the infrastructure on the Appcues side.
  3. Appcues will contact Fastly for an authorization record that you will need to add to your top-level domain. Appcues must get this code from Fastly so there is generally a 4 hour delay in response. Once the code is obtained, we will communicate it back to you and you will need to add a DNS TXT record on your top-level domain.
    1. For example, if you were trying to use appcues.example.xyz, you would need to add the record on the example.xyz domain record.
  4. Once that's done and Fastly verifies the record, Appcues will create the custom domain at Fastly. We will accomplish this as soon as possible, which is typically within five business days.
  5. After Appcues responds that the infrastructure has been set up: Visit https://apc.example.com/{account-id}.js (replacing apc.example.com with the domain you created in step 1) and see that your Javascript SDK is being served from your domain with a valid SSL certificate.
  6. Finally, update your Appcues installation script on your site by replacing fast.appcues.com in the script below with the domain you created in step 1. That's it!
     

For example, your installation script may look something like this:

<script src="//fast.appcues.com/12345.js"></script>
<script>
  window.Appcues.identify("<<< USER_ID >>>", // unique, required
  {
    // user properties...   
  } );
</script>

and after the change your script would look like the following (replacing abc.example.com with the domain you created in step 1)

<script src="//apc.example.com/12345.js"></script>
<script>
  window.Appcues.identify("<<< USER_ID >>>", // unique, required
  {
     // user properties...
  } );
</script>

After Setup:

Please email support@appcues.com with

  • Your account id
  • What domain you will be using on your side.

Once sent to us, we'll get your account squared away on our side as soon as possible, typically within five business days.

ad blockers custom domain cname

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Anonymous Users (Developer)
  • FAQ for Developers
  • Appcues Events Reference
  • Installing with Segment
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