> ## 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

> Publish audit reports to your own branded subdomain

# 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 URL** — `https://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:

| Type  | Name     | Value                |
| ----- | -------- | -------------------- |
| CNAME | `audits` | provided 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:

| Status     | Meaning                                            |
| ---------- | -------------------------------------------------- |
| `pending`  | DNS record not yet detected                        |
| `verified` | DNS is pointing correctly, certificate provisioned |
| `error`    | DNS 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.com` → `audits.client-a.com` → Workspace A
* `client-b.com` → `audits.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