Skip to main content

Setting Up Your Custom Domain (CNAME)

Overview

A custom domain lets your whitelabel instance run on your own URL - for example, app.youragency.com instead of a Prospi subdomain. This is configured by adding a CNAME record in your DNS provider. The process typically takes under 10 minutes, plus DNS propagation time.

Prerequisites

  • An active Prospi Whitelabel subscription

  • Access to your domain's DNS management panel (e.g., Cloudflare, GoDaddy, Namecheap, Route 53)

  • The subdomain you want to use (e.g., app.youragency.com or platform.youragency.com)

Step-by-Step Setup

Step 1: Choose Your Subdomain

Decide which subdomain you want your clients to access. Common choices include:

  • app.yourdomain.com

  • platform.yourdomain.com

  • outbound.yourdomain.com

Important: You must use a subdomain (e.g., app.yourdomain.com), not a bare root domain (e.g., yourdomain.com). CNAME records cannot be set on root domains with most DNS providers.

Step 2: Get Your CNAME Target from Prospi

In your Prospi Whitelabel settings, locate the CNAME target value. This is the address your subdomain needs to point to.

Step 3: Add the CNAME Record in Your DNS Provider

Log into your DNS management panel and create a new DNS record with the following settings:

  • Type: CNAME

  • Name / Host: Your chosen subdomain prefix (e.g., app if your subdomain is app.yourdomain.com)

  • Value / Target: The CNAME target provided by Prospi

  • TTL: Auto or 300 seconds

[IMAGE: Screenshot example of adding a CNAME record in a popular DNS provider like Cloudflare or GoDaddy]

Step 4: Enter Your Custom Domain in Prospi

Go back to your Prospi Whitelabel settings and enter the full subdomain you configured (e.g., app.youragency.com). Save the settings.

[IMAGE: Screenshot of entering the custom domain in Prospi Whitelabel settings and saving]

Step 5: Wait for DNS Propagation

DNS changes can take anywhere from a few minutes to 48 hours to propagate, though most updates are live within 15-30 minutes. You can check propagation status using a tool like dnschecker.org.

Step 6: Verify the Setup

Once propagation is complete, visit your custom domain in a browser. You should see the Prospi platform with your whitelabel branding on a fully branded URL.

Verification Tips

Domain not loading after 48 hours

  • Double-check that the CNAME record type, name, and value are correct in your DNS panel.

  • Make sure you did not accidentally create an A record instead of a CNAME record.

  • Verify there are no conflicting DNS records for the same subdomain.

SSL certificate notice

Prospi automatically provisions an SSL certificate for your custom domain. This can take up to 15 minutes after DNS propagation completes. If you still see a certificate notice after that, contact Prospi support.

Cloudflare users

If you use Cloudflare, make sure the proxy status for your CNAME record is set to DNS only (grey cloud), not Proxied (orange cloud). Cloudflare proxying can interfere with SSL provisioning.

Next Steps

Once your custom domain is live, proceed to Custom Branding - Logo, Colors & Sign-In Page to complete the visual setup of your whitelabel instance.

Did this answer your question?