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

# MSP Branding & Whitelabel

> Customize the StatusStack experience for your clients with your own logo, colors, custom domain, and white-label settings

## Overview

StatusStack gives MSPs two layers of branding control:

1. **MSP Branding** — Per-client branding profiles that apply your (or a client's) brand identity to their portal experience.
2. **Whitelabel Settings** — Global white-label configuration that removes StatusStack branding and replaces it with your MSP's identity across all clients.

***

## MSP Branding Profiles

Branding profiles let you assign a specific brand identity to individual client organizations. This is useful when you manage white-labeled portals for clients who want their own branding.

### What You Can Customize

<CardGroup cols={2}>
  <Card title="Brand Identity" icon="palette">
    Company name, tagline, logo (light/dark), and favicon
  </Card>

  <Card title="Colors" icon="swatch">
    Primary, secondary, accent, text, and background colors
  </Card>

  <Card title="Custom Domain" icon="globe">
    Point a client's own domain to their StatusStack portal
  </Card>

  <Card title="Email Branding" icon="envelope">
    Branded email header logo and sender name
  </Card>
</CardGroup>

### Creating a Branding Profile

Navigate to **Settings** → **Branding** in the MSP Console.

<Steps>
  <Step title="Click New Branding">
    Click the **New Branding** button.
  </Step>

  <Step title="Select Organization">
    Choose which client organization this branding applies to. You can also apply branding to your own MSP organization.
  </Step>

  <Step title="Set Brand Identity">
    * **Company Name** — Appears in the portal header (leave blank to use the organization name)
    * **Tagline** — Optional brand tagline
    * **Logo** — Upload a light-mode logo (recommended: 200×50px)
    * **Dark Logo** — Optional separate logo for dark mode
    * **Favicon** — Browser tab icon (recommended: 32×32px)
  </Step>

  <Step title="Configure Colors">
    Set your brand colors using the color picker:

    * **Primary Color** — Main brand color (buttons, links, accents)
    * **Secondary Color** — Supporting brand color
    * **Accent Color** — Highlight color for badges and indicators
    * **Text Color** — Primary text color
    * **Background Color** — Default background color
  </Step>

  <Step title="Activate the Profile">
    Toggle **Active** on. Only one branding profile can be active per organization at a time — activating a new one deactivates the previous one.
  </Step>
</Steps>

***

## Whitelabel Settings

Whitelabel mode applies your MSP's branding globally across your client portal, replacing StatusStack's identity with yours.

Navigate to **Settings** → **Whitelabel Settings** in the MSP Console.

### Enabling Whitelabel Mode

Toggle **Enable White-Label Mode** on. When enabled:

* Your MSP logo and colors replace StatusStack branding
* Email notifications use your sender name and logo
* The "Powered by StatusStack" attribution is hidden

### Branding Configuration

**Logo & Favicon**
Upload your MSP logo and favicon. These appear in the portal header and browser tab for all clients.

* Logo: recommended 200×50px, PNG or SVG
* Favicon: recommended 32×32px

**Light/Dark Mode Logos**
You can upload separate logos for light and dark mode portal themes.

**Brand Colors**
Configure your primary, secondary, accent, text, and background colors. These override the default StatusStack theme for your clients.

### Email Settings

Customize how notification emails appear to your clients:

* **Sender Name** — The "From" name in notification emails
* **Support Email** — Reply-to address for client inquiries
* **Email Header Logo** — Logo that appears at the top of all notification emails

### Custom Domain

Point your own domain to the client portal so clients see `status.yourcompany.com` instead of a StatusStack URL.

<Steps>
  <Step title="Enter Your Domain">
    In the **Portal Settings** tab, enter your custom domain (e.g., `status.yourcompany.com`) — without `http://` or `https://`.
  </Step>

  <Step title="Verify DNS Ownership">
    Click **Verify Domain** to generate a verification token. Add the provided **TXT record** to your domain's DNS settings to prove ownership.
  </Step>

  <Step title="Configure DNS CNAME">
    Once ownership is verified, add a **CNAME record** pointing your domain to the StatusStack CDN endpoint shown in the console.
  </Step>

  <Step title="Wait for Propagation">
    DNS changes typically propagate within 15–60 minutes. The console will show a verified status once the domain is confirmed.
  </Step>
</Steps>

<Note>
  Both the TXT verification record and CNAME record are required. The TXT record proves DNS zone ownership; the CNAME routes traffic to the portal.
</Note>

***

## Per-Client vs. Global Branding

| Feature                         | MSP Branding Profile    | Whitelabel Settings      |
| ------------------------------- | ----------------------- | ------------------------ |
| Scope                           | Per client organization | All clients globally     |
| Logo & Colors                   | ✅                       | ✅                        |
| Custom Domain                   | ✅                       | ✅                        |
| Email Branding                  | ✅                       | ✅                        |
| Removes StatusStack attribution | ❌                       | ✅                        |
| Multiple configurations         | ✅ (one active per org)  | ❌ (single global config) |

***

## Related Guides

* [Client Management](/guides/msp-client-management)
* [MSP Console Overview](/guides/msp-setup)