# White Label

White Label lets you serve client reports from your own custom domain with your branding. Instead of sharing `ringtonic.app` links, your clients see your agency's domain (e.g., `reports.youragency.com`).

{% hint style="info" %}
White Label is available on the **Agency plan** only.
{% endhint %}

<div data-full-width="false"><figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2FsxuXoDpohEt4bX1mc713%2FXnapper-2025-12-09-11.23.08.png?alt=media&#x26;token=ff4d612c-ccf1-4f35-b892-e82f85f0b4d0" alt=""><figcaption><p>White Label Portal</p></figcaption></figure></div>

### How It Works

1. **Add your domain** in Ring Tonic settings
2. **Configure DNS** to add a CNAME record to your system
3. **Wait for automatic verification** (checked every 5 minutes)
4. **Customize branding** with your logo and colors
5. **Set up custom email delivery** so notifications come from your email address
6. **Migrate webhooks** so calls route through your domain

Once set up, your clients access reports at `https://reports.youragency.com` instead of `ringtonic.app`, with your branding throughout—including email notifications.

***

### Adding Your Domain

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2FrYP3w2d6TXUetFsxT833%2FXnapper-2025-12-09-11.26.27.png?alt=media&#x26;token=1efad2fc-0c74-4a5b-83a5-a2189a6f4931" alt="" width="375"><figcaption><p>Access White Label from the User Setting dropdown</p></figcaption></figure>

1. Go to **Settings** → **White Label**
2. Enter your custom domain (e.g., `reports.youragency.com`)
3. Click **Add Domain**

{% hint style="warning" %}
**Use a subdomain:** We recommend using a subdomain like `reports.youragency.com` rather than your root domain.
{% endhint %}

***

### Configuring DNS

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2FAiF5QLRrI42MN3ntoCoi%2FXnapper-2025-12-09-11.31.14.png?alt=media&#x26;token=31cd8cf7-4a2f-457f-babe-76d8df129567" alt="" width="563"><figcaption><p>Configure your DNS after adding a domain</p></figcaption></figure>

After adding your domain, configure your DNS with a CNAME record:

| Type  | Name                     | Value              |
| ----- | ------------------------ | ------------------ |
| CNAME | `reports.youragency.com` | `to.laravel.cloud` |

{% hint style="info" %}
**DNS propagation** can take up to 48 hours, though it's usually much faster.
{% endhint %}

***

### Verification

Ring Tonic automatically checks pending domains every 5 minutes. Once your DNS is correctly configured:

1. Ring Tonic detects the DNS change
2. SSL certificate is automatically provisioned
3. Your domain becomes active

You can also manually trigger a check by clicking **Check Verification** on the White Label settings page.

{% hint style="success" %}
**Automatic SSL:** Ring Tonic automatically provisions and renews SSL certificates. No manual configuration needed.
{% endhint %}

#### Verification Status

| Status       | Meaning                                    |
| ------------ | ------------------------------------------ |
| **Pending**  | Waiting for DNS verification               |
| **Verified** | DNS correct, SSL being provisioned         |
| **Active**   | Domain fully working, ready to use         |
| **Failed**   | DNS misconfigured, check your CNAME record |

***

### Customizing Your Branding

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2FLV06dsUqHVSzT2CM7zaY%2FXnapper-2025-12-09-11.32.43.png?alt=media&#x26;token=1b54ea31-ac4d-4585-9f81-9f16126eee20" alt="" width="563"><figcaption><p>Full branding customization</p></figcaption></figure>

After your domain is active, customize the appearance:

1. Go to **Settings** → **White Label**
2. Update your branding:
   * **Brand Name:** Your agency name (used in browser titles and as logo fallback)
   * **Logo:** Your company logo (PNG, JPG, SVG, WebP)
   * **Favicon:** Browser tab icon
   * **Support Email:** Where clients contact for help
3. Click **Save**

#### Brand Name

The brand name appears in two places:

| Location          | When It's Used                                               |
| ----------------- | ------------------------------------------------------------ |
| **Browser title** | Always shows as suffix (e.g., "Call Activity - Your Agency") |
| **Page header**   | Only when no logo is uploaded                                |

{% hint style="info" %}
**No logo?** If you haven't uploaded a logo, your brand name displays as text in the header. This is useful if you want a text-based branding without creating a logo image.
{% endhint %}

{% hint style="success" %}
**Pro Tip:** Use a transparent PNG for your logo so it looks good on both light and dark backgrounds.
{% endhint %}

***

### Custom Email Delivery (Optional)

By default, Ring Tonic sends notifications (call log exports, webhook migration updates, workspace invitations, etc.) from our email address. With Custom Email Delivery, these notifications are sent through **your own mail server** so clients see your agency's sender identity.

{% hint style="info" %}
**Requires verified domain:** The Email Delivery section only appears after your white-label domain is verified and active.
{% endhint %}

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2FKi518ysyYmyRAfxq7df9%2FXnapper-2026-02-21-18.03.36.png?alt=media&#x26;token=664b8f12-f5a3-4246-9313-8c2be443e56b" alt=""><figcaption><p>Email Delivery settings within the White Label configuration</p></figcaption></figure>

#### Setting Up Custom SMTP

1. Go to **Settings** → **White Label**
2. Scroll to the **Email Delivery** section
3. Enter your SMTP credentials:

| Field          | Description                  | Example                     |
| -------------- | ---------------------------- | --------------------------- |
| **SMTP Host**  | Your mail server address     | `smtp.youragency.com`       |
| **Port**       | SMTP port number             | `587` (TLS) or `465` (SSL)  |
| **Username**   | SMTP authentication username | `noreply@youragency.com`    |
| **Password**   | SMTP authentication password | Leave blank if not required |
| **Encryption** | Connection security          | None, TLS, or SSL           |
| **From Email** | Sender email address         | `noreply@youragency.com`    |
| **From Name**  | Sender display name          | `Your Agency Name`          |

4. Click **Test Connection** to verify your credentials
5. Click **Save**

{% hint style="warning" %}
**Test before saving.** Always use the **Test Connection** button to verify your SMTP credentials are correct before saving. Incorrect settings won't prevent Ring Tonic from sending emails—it will fall back to the default sender—but your clients won't see your branding.
{% endhint %}

All app notifications (exports, invitations, alerts, etc.) will be sent through your SMTP server. Password reset and email verification emails always use Ring Tonic's default sender for security.

#### Clearing SMTP Settings

To stop using your own mail server and revert to Ring Tonic's default:

1. Click **Clear SMTP** in the Email Delivery section
2. Click **Save**

All future notifications will be sent from Ring Tonic's default email address.

<details>

<summary>What happens to email delivery if I downgrade my plan?</summary>

Your SMTP credentials are preserved, but email delivery automatically reverts to Ring Tonic's default sender while your domain is inactive. If you upgrade again, your custom SMTP settings are restored automatically—no reconfiguration needed.

</details>

<details>

<summary>Can I use any SMTP provider?</summary>

Yes. Any SMTP server works, including Gmail, Amazon SES, Mailgun, Postmark, SendGrid, or your own mail server.

</details>

<details>

<summary>What if my SMTP server is down?</summary>

Ring Tonic will automatically retry failed notifications. If your server remains unreachable, notifications will be skipped for that attempt.

</details>

***

### Migrating Webhooks (Optional)

When you enable White Label, your tracking numbers can be updated to route calls through your custom domain.

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2F4iMEwsHaMIl8vvcvWQ5R%2FXnapper-2025-12-09-11.34.42.png?alt=media&#x26;token=e261be4c-b99c-4f25-b04d-487332cecb96" alt="" width="563"><figcaption><p>Update existing Twilio webhooks to use your white-label domain</p></figcaption></figure>

1. Go to **Settings** → **White Label**
2. Click **Update now** under your domain
3. Review how many numbers need updating
4. Click **Update** to migrate them
5. You'll receive an email when migration completes

{% hint style="info" %}
**No downtime:** Calls continue working throughout the migration.
{% endhint %}

***

### Common Questions

<details>

<summary>Do I need my own SSL certificate?</summary>

No. Ring Tonic automatically provisions and manages SSL certificates for your white-label domain.

</details>

<details>

<summary>Can I use my root domain (e.g., youragency.com)?</summary>

Technically yes, but we recommend using a subdomain to keep your main website separate.

</details>

<details>

<summary>How long does DNS verification take?</summary>

Once your DNS is correctly configured, verification typically happens within minutes. DNS propagation can take up to 48 hours.

</details>

<details>

<summary>What happens if I remove my white-label domain?</summary>

Your reports will revert to using `ringtonic.app`. Existing shared links using your custom domain will stop working.

</details>

<details>

<summary>Can I change my white-label domain?</summary>

Yes, but you'll need to remove the current domain and add a new one. This requires re-verifying DNS and migrating webhooks again.

</details>

<details>

<summary>Do all my workspaces use the same white-label domain?</summary>

Yes, white-label settings are tied to your user account, not individual workspaces.

</details>

<details>

<summary>What happens to call tracking if I downgrade my plan?</summary>

Call tracking and webhooks continue working normally even after downgrading. Only client-facing pages are affected - they'll be redirected to the main application domain.

</details>