> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waverunnerai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# White-Label

> Rebrand Wave Runner under your agency's identity — custom logo, colors, domain, and client billing — with zero technical overhead or development cost.

White-labeling lets you deliver Wave Runner's AI voice platform to your clients entirely under your own brand. Your clients see your logo, your domain name, and your company name throughout the dashboard, email notifications, and all client-facing pages — with no Wave Runner branding visible. You set the pricing, you collect the revenue, and the platform handles everything else.

## Requirements

White-label features require a plan that has white-label access enabled. Contact your account manager or check the Billing page to confirm whether your current plan includes it. If you are on a plan without white-label access, you will need to upgrade before proceeding.

<Info>
  White-label is a one-time activation per account. Once your subdomain is claimed, it cannot be renamed. Choose your slug carefully before activating.
</Info>

## What you can customize

<CardGroup cols={2}>
  <Card title="Company name" icon="building">
    Set the brand name that appears in the dashboard header, email subjects, and client-facing pages.
  </Card>

  <Card title="Logo" icon="image">
    Upload your agency's logo. It replaces the Wave Runner logo everywhere in the UI.
  </Card>

  <Card title="Custom domain" icon="globe">
    Point your own domain or subdomain at your branded dashboard (e.g., `app.youragency.com`).
  </Card>

  <Card title="Default theme" icon="palette">
    Choose the default UI theme (glass or minimal, dark or light) that your clients see when they first sign in.
  </Card>
</CardGroup>

## Activating white-label

<Steps>
  <Step title="Open White-Label settings">
    Go to **Settings → Account** and find the **White-Label** section, or navigate directly to the white-label setup page from the Settings menu.
  </Step>

  <Step title="Choose your subdomain slug">
    Enter a slug for your branded subdomain (e.g., `myagency`). This creates `myagency.chattrvox.com` as your platform URL. The slug must be lowercase, 3–50 characters, and contain only letters, numbers, and hyphens.
  </Step>

  <Step title="Enter your brand name">
    Type your company or brand name. This is required and appears throughout the platform.
  </Step>

  <Step title="Upload your logo">
    Upload your logo file. SVG and PNG with a transparent background work best.
  </Step>

  <Step title="Activate">
    Click **Activate White-Label**. Your branded subdomain goes live immediately and you are redirected to it automatically.
  </Step>
</Steps>

<Warning>
  Once activated, your slug is permanent. All your data, client accounts, and configuration are tied to this identifier and cannot be changed.
</Warning>

## Setting up a custom domain

After activating white-label, you can replace the default subdomain with your own domain (e.g., `app.youragency.com`).

<Steps>
  <Step title="Add your domain">
    In **Settings → Account → White-Label**, enter your custom domain in the **Custom Domain** field and save.
  </Step>

  <Step title="Create a DNS record">
    Log in to your DNS provider and add a CNAME record pointing your domain to the platform's customer endpoint:

    ```
    Type:  CNAME
    Name:  app  (or your chosen subdomain)
    Value: customers.yourmainplatformdomain.com
    ```

    DNS propagation typically takes a few minutes, but can take up to 48 hours with some providers.
  </Step>

  <Step title="Verify the domain">
    Return to the White-Label settings and click **Verify Domain**. Wave Runner checks your DNS record and, if the CNAME is pointing correctly, provisions an SSL certificate and activates your custom domain automatically.
  </Step>
</Steps>

<Tip>
  If verification fails, double-check that the CNAME value matches exactly what the settings page shows and that you have not included `https://` in the record value.
</Tip>

## Client sub-workspaces (agency accounts)

On the Enterprise plan with an Agency workspace, you can create and manage sub-workspaces on behalf of your clients. Each client gets their own isolated workspace — their own assistants, campaigns, contacts, and call data — while you retain admin access across all of them from your agency workspace.

To create a client sub-workspace:

<Steps>
  <Step title="Switch to your agency workspace">
    Use the workspace switcher in the top navigation to select your agency workspace.
  </Step>

  <Step title="Create a client workspace">
    In **Settings → Workspace**, click **Create Workspace** and set the type to **Client**. Enter the client's name and any initial configuration.
  </Step>

  <Step title="Invite the client">
    Invite the client to their workspace with the **Member** or **Viewer** role so they can access their own data without modifying account-level settings.
  </Step>
</Steps>

## Setting up client billing with Stripe Connect

To charge your clients directly through your branded platform, connect a Stripe account. Wave Runner uses Stripe Connect Express, so your payouts go to your own Stripe account.

<Steps>
  <Step title="Start Stripe onboarding">
    In **Settings → Account → White-Label**, find the **Stripe Connect** section and click **Connect Stripe Account**.
  </Step>

  <Step title="Complete Stripe onboarding">
    You are redirected to Stripe's onboarding flow. Provide your business details, bank account, and identity verification as prompted. When complete, Stripe redirects you back to your dashboard.
  </Step>

  <Step title="Verify account status">
    Once onboarding is complete, the Stripe Connect section shows your account as active with charges and payouts enabled. If requirements are still pending, click **Open Stripe Dashboard** to resolve them.
  </Step>

  <Step title="Set client pricing">
    With Stripe Connect active, you can configure per-minute pricing for your clients in the **Minutes Pricing** section. Clients purchase minutes at your rate, and funds are transferred to your Stripe account.
  </Step>
</Steps>

<Note>
  Stripe Connect onboarding is separate from the Stripe account you use for your own Wave Runner subscription. You need both: one for paying Wave Runner, and one (Connect) for receiving payments from your clients.
</Note>

## Where your branding appears

Once white-label is activated, your logo, brand name, and domain appear in:

* The main dashboard header and navigation
* Email notifications sent to your team members and clients (invitation emails, alerts)
* The client-facing sign-in and sign-up pages
* The client workspace dashboard
* Receipt and invoice documents

<Tip>
  Set a custom `contact_email` in the White-Label settings so that support links and reply-to addresses in emails point to your agency, not a platform default.
</Tip>