Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.withgiga.ai/llms.txt

Use this file to discover all available pages before exploring further.

Custom Domains

Custom domains let you publish audit reports at a branded URL — for example, audits.acme.com — instead of a generic WithGiga URL. MSSPs use this to deliver white-labeled reports per client; security teams use it to embed reports into existing portals.

What gets branded

When you assign a custom domain to a workspace, audit reports for that workspace are served at your domain:
  • Report view URLhttps://audits.acme.com/audit/{auditId}
  • PDF report headers and footers — replace WithGiga branding with your logo
  • Shareable links posted to Slack — use your domain
  • Webhook callback origins — referenced from your domain
The WithGiga dashboard itself is unaffected — you continue to manage audits from build.withgiga.ai.

Setting up a custom domain

Step 1: Add the domain in WithGiga

  1. Go to Domains in the main sidebar
  2. Click Add Domain
  3. Enter the subdomain (e.g., audits.acme.com)
  4. Optionally upload your logo for PDF and report-view branding
  5. Click Save
WithGiga provides a DNS target.

Step 2: Configure DNS

Add a CNAME record at your DNS provider:
TypeNameValue
CNAMEauditsprovided by WithGiga
Propagation typically completes within minutes on modern DNS providers.

Step 3: Assign to a workspace

  1. Open the workspace
  2. Workspace Settings → Domain
  3. Select the domain you added
  4. Click Save
All future audit reports for that workspace are accessible at your domain. Past audits are also accessible at the new domain.

Domain verification

WithGiga checks DNS automatically. Status appears on the Domains page:
StatusMeaning
pendingDNS record not yet detected
verifiedDNS is pointing correctly, certificate provisioned
errorDNS misconfigured — check your CNAME
Once verified, WithGiga provisions and renews a TLS certificate via Let’s Encrypt automatically.

Multi-workspace setup (MSSP)

MSSPs typically assign a unique custom domain per client workspace:
  • client-a.comaudits.client-a.com → Workspace A
  • client-b.comaudits.client-b.com → Workspace B
Each domain serves only the reports from its assigned workspace. Cross-workspace data leaks are impossible — the routing is strictly scoped.

Logo branding

Upload a logo (SVG preferred, PNG also supported) for use in:
  • PDF report headers
  • Report view top-left corner
  • Shareable preview cards
For maximum flexibility, use a transparent-background SVG. The logo is resized to a max 40px height in the report header.

Removing a domain

Removing a domain from WithGiga doesn’t delete past reports — they remain accessible at the default WithGiga URL. New reports also fall back to the default URL. You can re-add the domain at any time.

Limitations

  • Apex domains (e.g., audits.com without a subdomain) are not supported — use a subdomain
  • Wildcard domains are not supported per workspace
  • You can register up to 20 domains per Starter Pro account, unlimited on Max