Star us on GitHub
Star
Menu

Proxying Highlight

Proxying is only available starting on our Startup tier. If you would like use this, you will need to reach out to support@highlight.run.

If you're not seeing sessions or errors on Highlight, chances are that requests to Highlight are being blocked. This can happen for different reasons such as a third-party browser extensions, browser configuration, or VPN settings.

One way we can avoid this is by setting up proxy from your domain to Highlight. To do this, you will need access to your domain's DNS settings.

Setting up the proxy
  1. Upgrade to the Startup Tier https://www.highlight.run/pricing

  2. On your domain, add a CNAME record that points highlight.<YOUR_DOMAIN> to pub.highlight.run

  3. Send us an email (support@highlight.run) or intercom ticket with your domain

Below is an example email/message that you can send over.

Hello!

I'd like to use the Highlight Proxy and I've upgraded to the Startup Tier. I've set up an CNAME record for: highlight.piedpiper.com

Example

You have an app running on https://piedpiper.com. Your DNS record will point highlight.piedpiper.com to our backend.

Using the Proxy

In your app where you call H.init(), you will need to set backendUrl to the DNS record you just created. For the example above:

H.init('<YOUR_PROJECT_ID>', { backendUrl: 'https://highlight.piedpiper.com', })
Copy

You should now see Highlight making requests to https://highlight.piedpiper.com instead of https://pub.highlight.run.