Custom Domains
Custom domains let you share audit reports from a branded URL instead of the default JetStack AI domain. Instead of clients seeing a JetStack AI URL when they open your audit report, they see your brand name in the address bar. This feature is available exclusively on the Ultimate and Custom plans.
What Custom Domains Do
Section titled “What Custom Domains Do”By default, shared audit reports are accessible at URLs like:
https://reports.jetstack.ai/r/abc123With a custom domain configured, the same report is accessible at:
https://your-brand.client-reports.jetstack.ai/r/abc123The custom subdomain replaces the default reports.jetstack.ai hostname. The report content, branding, and functionality remain identical — only the URL changes.
Prerequisites
Section titled “Prerequisites”Before setting up a custom domain, confirm:
- Ultimate or Custom plan — Custom domains are not available on the Pro plan. See Billing & Plans to check your current tier.
- Subdomain name — Decide on the subdomain you want (e.g.,
acmeforacme.client-reports.jetstack.ai). This should be your agency name or brand name.
Setting Up a Custom Domain
Section titled “Setting Up a Custom Domain”- Navigate to Settings > Custom Domains from the left sidebar.
- Click Add Custom Domain.
- Enter your desired subdomain prefix. For example, entering
acmecreates the domainacme.client-reports.jetstack.ai. - Click Save.
Domain Verification
Section titled “Domain Verification”After adding your subdomain, JetStack AI initiates a verification process:
- JetStack AI provisions the subdomain on its infrastructure.
- A DNS check verifies that the subdomain is properly configured. Since the subdomain is under
client-reports.jetstack.ai, no DNS changes are required on your end — JetStack AI manages the parent domain. - Verification typically completes within a few minutes. The status updates from Pending to Verified automatically.
Unlike traditional custom domains that require CNAME records, JetStack AI’s custom subdomain system is fully managed. You do not need to touch your DNS settings.
SSL Auto-Provisioning
Section titled “SSL Auto-Provisioning”Once the domain is verified, JetStack AI automatically provisions an SSL/TLS certificate:
- Certificate type — Let’s Encrypt TLS certificate
- Provisioning time — Usually completes within 5-10 minutes after verification
- Renewal — Certificates are auto-renewed before expiration. No manual intervention required.
- Status — The Custom Domains settings page shows the SSL status: Provisioning, Active, or Error.
All report URLs served from your custom domain use HTTPS. HTTP requests are automatically redirected to HTTPS.
Managing Your Custom Domain
Section titled “Managing Your Custom Domain”Viewing Status
Section titled “Viewing Status”The Custom Domains settings page shows:
| Field | Description |
|---|---|
| Subdomain | Your custom subdomain prefix |
| Full URL | The complete domain (e.g., acme.client-reports.jetstack.ai) |
| Verification Status | Pending, Verified, or Failed |
| SSL Status | Provisioning, Active, or Error |
| Created | Date the domain was added |
Changing Your Subdomain
Section titled “Changing Your Subdomain”To change your subdomain, remove the existing one and add a new one. There is no edit-in-place option because changing a subdomain requires new SSL provisioning.
Old report URLs shared using the previous subdomain will stop working once you remove it. Update any links you have shared with clients.
Removing a Custom Domain
Section titled “Removing a Custom Domain”- Go to Settings > Custom Domains.
- Click Remove next to the domain.
- Confirm the removal.
After removal, all report URLs revert to the default reports.jetstack.ai domain. Previously shared links using the custom subdomain will no longer resolve.
How Reports Use the Custom Domain
Section titled “How Reports Use the Custom Domain”Once a custom domain is active and SSL is provisioned:
- New shared reports automatically use the custom domain URL.
- Existing shared reports — URLs generated before the custom domain was added continue to work at their original
reports.jetstack.aiURLs. They are not automatically migrated to the new domain. - Password-protected reports work identically on custom domains. The password prompt and authentication flow are unchanged.
When you share a report link, JetStack AI generates the URL using your custom domain if one is configured and active. If the custom domain is in a pending or error state, the default domain is used as a fallback.
Troubleshooting
Section titled “Troubleshooting”Verification Stuck on Pending
Section titled “Verification Stuck on Pending”If verification does not complete within 15 minutes, try removing the domain and adding it again. If the issue persists, contact JetStack AI support.
SSL Error
Section titled “SSL Error”An SSL error usually indicates a temporary issue with certificate provisioning. Wait 30 minutes and check again. If the error persists, remove and re-add the domain. JetStack AI support can investigate persistent SSL provisioning failures.
Old Links Not Working
Section titled “Old Links Not Working”If you changed or removed your custom domain, any report URLs that used the old subdomain will stop working. You will need to reshare reports with updated links. Reports themselves are not deleted — only the URL routing changes.