Skip to main content
By default, files uploaded to Media Storage are served from the platform’s default storage domain. If you want media files to appear under your own domain — for example, media.yourbrand.com instead of the platform default — you can configure a custom CDN domain. This keeps your brand consistent in shared file URLs, email image links, and embedded media across all your pages.
Custom CDN domain configuration is an advanced feature typically used by agencies and businesses that require full white-label presentation. If you only need branded funnel and website URLs, configure those through your site’s domain settings rather than the media CDN domain.

​
Why use a custom CDN domain

A custom CDN domain affects every URL generated for files in Media Storage. Using your own domain provides several advantages:
  • Consistent branding — file URLs shown in email clients, social posts, and browser address bars use your domain name rather than the platform’s
  • Improved email deliverability — some email filters flag images loaded from shared hosting domains; serving images from your own domain can improve inbox placement
  • Client-facing professionalism — if you manage client sub-accounts, their media files appear to be hosted on infrastructure you control
  • SEO signals — images served from a domain with established authority may contribute marginally better signals to image search

​
Prerequisites

Before configuring a custom CDN domain, you need:
  • Access to your domain’s DNS records (through your domain registrar or DNS provider)
  • A subdomain reserved for media delivery (for example, media.yourbrand.com or assets.yourbrand.com)
  • Agency-level access in the HoopAI platform (this setting is configured at the agency level and applies to sub-accounts you manage)

​
Setting up the custom CDN domain

​
Step 1: Choose a subdomain

Select a subdomain specifically for media delivery. Common conventions are:
  • media.yourdomain.com
  • assets.yourdomain.com
  • cdn.yourdomain.com
  • files.yourdomain.com
Do not use your root domain (yourdomain.com) or your primary www subdomain for this purpose. Subdomains are required.

​
Step 2: Create a CNAME record in your DNS

Log in to your DNS provider (Cloudflare, GoDaddy, Namecheap, Route 53, etc.) and add a new DNS record:
FieldValue
TypeCNAME
Name / Hostmedia (or whichever subdomain you chose)
Target / Points toThe CDN target provided in your agency settings (e.g., cdn.hoopai.com or as shown in the platform)
TTL3600 (1 hour) or Auto
Save the record. DNS propagation typically takes between a few minutes and 48 hours, depending on your provider and existing TTL values.

​
Step 3: Enter the custom domain in your agency settings

  1. Log in to your HoopAI agency account
  2. Navigate to Agency Settings (or Settings at the agency level)
  3. Find the Media CDN Domain or Custom Domain field under the Media Storage or Branding section
  4. Enter your full subdomain: media.yourdomain.com
  5. Click Save
The platform will verify that the CNAME record is resolving correctly. Once verified, newly generated media URLs will use your custom domain.

​
Step 4: Verify propagation

After saving, test that the custom domain is resolving correctly:
  1. Open a file in Media Storage and click Get Link to copy its URL
  2. Check that the copied URL begins with https://media.yourdomain.com/ (or your chosen subdomain)
  3. Paste the URL into a browser to confirm the file loads
If the URL still shows the default domain, DNS propagation may not be complete. Wait up to 48 hours and then recheck.

​
SSL and HTTPS

The CDN automatically issues and renews an SSL certificate for your custom domain once the CNAME record is in place and propagation completes. All media files are served over HTTPS automatically — you do not need to manage certificates. If you see a certificate error when testing your custom domain shortly after setup, wait a short period for the SSL certificate to be issued and retry.

​
Impact on existing file URLs

When you enable a custom CDN domain, new file URLs generated from that point forward will use your custom domain. URLs that were previously copied or embedded using the old default domain will typically still resolve because the underlying CDN infrastructure recognizes both domains. For a fully consistent migration, update embedded image URLs in your funnels, email templates, and other tools after switching to the custom domain. This ensures all media references use your branded URL going forward.

​
Disabling or changing the custom CDN domain

To remove a custom CDN domain, clear the custom domain field in your agency settings and save. File URLs will revert to the platform’s default domain. To switch to a different subdomain, update the CNAME target in your DNS and enter the new subdomain in agency settings.
Removing the CNAME record from your DNS before clearing the custom domain in the platform settings may cause media files to become temporarily inaccessible while DNS propagates. Always remove the domain in platform settings before removing the DNS record.

​
Troubleshooting

IssueCauseResolution
URL still shows default domain after savingDNS has not propagated yetWait up to 48 hours; verify the CNAME with a DNS lookup tool
SSL certificate errorCertificate not yet issuedWait 10–30 minutes after CNAME propagates; certificate is issued automatically
CNAME verification fails in platformCNAME record points to wrong targetConfirm the CNAME target value matches exactly what is shown in your agency settings
Files not loading from custom domainCNAME was deleted from DNSRecreate the CNAME record at your DNS provider

​
FAQs

The custom CDN domain is configured at the agency level and applies to media files across all sub-accounts managed by that agency. Individual sub-accounts cannot set their own separate custom CDN domains independently.
No. CDN configuration requires a subdomain (CNAME record). Root domains use A records and cannot be pointed to a CDN target using a CNAME. Use a subdomain such as media.yourdomain.com.
No. The custom CDN domain only affects the URLs of files served from Media Storage. Funnel and website page URLs are configured separately through your site’s domain settings.
No. Custom CDN domain configuration is included as part of the agency-level plan. There are no additional fees for using your own domain for media delivery.
The exact CNAME target value is displayed in your agency settings in the Media CDN Domain configuration section. Copy it exactly as shown — do not modify the value.
Last modified on March 5, 2026