Skip to content
English
  • There are no suggestions because the search field is empty.

How to setup a custom Storefront domain

Set up a branded subdomain for the link your advocates use to check their balance and redeem rewards.

Overview

If you're fulfilling rewards through Storefront, you'll need a Storefront subdomain. Advocates visit this link to check their reward balance and redeem, so branding it with your own domain keeps the experience feeling like yours rather than ours. 🎁

Example Storefront domain: rewards.companydomain.com

Step 1: Create your domain

  1. In Ambassador, go to Admin & Configuration > Domains, select the Custom Domains tab, then select Add Domain.
  2. Enter a subdomain that's unique to your Storefront. If your website is companydomain.com, something like rewards.companydomain.com or rewardstorefront.companydomain.com works well.
  3. Under Domain Usage, select Storefront.
  4. Under Certificate Type, select Automatic.
  5. Select Create Domain to start provisioning.

Back on the Custom Domains page, your new domain appears with the status Pending hostname validation. That means it's ready for the next step.

Step 2: Validate your hostname

Next, you'll prove you own the domain so Ambassador can serve your Storefront link through it. These steps happen in your DNS provider, not in Ambassador.

The exact screens vary by provider. We're using Cloudflare DNS in this example, but the same steps work anywhere.

  1. Check the box next to the domain you just created and select View Domain. A Domain Details dialog opens with the values you'll need.
  2. Create a CNAME record for your chosen subdomain with a target of v1.ambassadorportalv2.com.
  3. Create a TXT record named _cf-custom-hostname.<yourdomain>, as shown in Domain Details. The content is the Hostname verification value.
  4. Wait for the status to update. This usually takes 5 minutes to 4 hours.

When the status changes to Pending certificate validation, you're ready for the last step.

Step 3: Validate your certificate

Finally, our custom domain provider issues a TLS certificate for your hostname. This is what tells browsers your Storefront link is secure.

  1. Find the Certificate verification name and Certificate verification value in the Domain Details dialog.
  2. Create another TXT record in your DNS. The name is the verification name, and the content is the verification value.
  3. Once the certificate is requested, the status changes to Certificate requested.
  4. Once it's issued, the status changes to Completed. You're all set. ✅

💡 Tip: Validation can take anywhere from 15 minutes to several hours. The automated checks run less frequently as time goes on, so if you're waiting a while, that's expected.

Questions? Email support@getambassador.com