Pixel white-labeling with a custom domain

Also known as proxying, pixel white-labeling allows you to serve the Usermaven tracking script from your own custom domain. This helps bypass ad blockers and improves data accuracy by avoiding detection from common tracking filters.

Ad blockers often block known analytics domains, which can lead to missing or inaccurate data. To solve this, Usermaven allows you to white-label the tracking pixel by using your own custom domain. This improves data reliability and helps bypass ad blockers.

When the browser requests the tracking script from https://um.yourdomain.com/lib.js, it is actually served from https://usermaven.com/lib.js. The analytics work exactly the same, but the script is delivered from your custom domain and is less likely to be blocked.

Why enable pixel white-labeling?

Bypass ad blockers – Custom domains are less likely to be blocked, ensuring more complete data collection.
Improve data accuracy – Capture a full picture of user activity without interruptions.
Easy setup – SSL certificates are automatically managed by Usermaven.

Steps to enable pixel white-labeling

1. Add your custom domain

Log in to your Usermaven account.
Go to Workspace Settings → Pixel White-labeling.
Enter your preferred subdomain (e.g., um.yourdomain.com) and click Add Domain.

Note: For maximum ad blocker evasion, avoid common names like usermaven, analytics, track, or stats. Instead, use a subdomain made of random characters (e.g., xys123, d3v45, etc.) that doesn’t reveal its purpose. This significantly reduces the risk of being flagged by filters.

2. Configure DNS settings

Open your DNS provider’s dashboard.
Add a CNAME record with the following details:
- Name: Your subdomain (e.g., um)
- Target or Value: whitelabel.usermaven.com
- TTL: Set to Auto
- Proxy status: Set to DNS only (important for Cloudflare)

For help with Cloudflare, check our Cloudflare DNS Setup Guide .

3. Verify your custom domain

Go back to Pixel White-labeling in your Usermaven settings.
Click Verify next to your domain.

Once verified, SSL will be automatically applied (this may take a few minutes).

4. Update your tracking script

Go to Workspace Settings → Setup.
Copy the updated tracking script, which uses your custom domain.
Replace any previous Usermaven script on your site with this new version.

Important: If you installed the tracking script before setting up white-labeling, make sure to replace it with the updated version that includes your custom domain.

Need help with Cloudflare workers proxy?

Check out our Cloudflare workers proxy guide.

Need help with DNS setup?

Here are setup guides for popular providers:

Still need help? Contact us at support@usermaven.com or in-app live chat support. Make sure to include your custom domain and a screenshot of your DNS settings.