Skip to main content

White-Label & Branding

What White-Labeling Means​

White-labeling means you can replace every mention of "LeadHub" with your own brand. Your clients see your company name, your logo, and your colors — not LeadHub's. To them, it looks like software you built yourself.

This is useful if you are an agency selling this platform to clients, or if you want to run it under your own product brand.

Branding Settings Page​

Go to Settings → Branding in the sidebar.

This is where you control how the app looks everywhere.

Application Name​

The Application Name field replaces "LeadHub" everywhere: the browser tab title, the sidebar header, email subject lines, and any automated messages.

Example: if you set this to "Acme CRM", your clients will see "Acme CRM" instead of "LeadHub".

Colors​

FieldWhat it affects
Primary ColorThe main brand color — buttons, active menu items, links, and highlights
Accent ColorA secondary color used for badges, chips, and secondary highlights

Click the color swatch to open a color picker, or type a hex code directly (e.g. #e63946).

Upload your logo under Upload Logo. Recommended size: 300 x 80 pixels, PNG or SVG format. The logo appears in the sidebar and on the login page.

If you do not upload a logo, the app name text is shown instead.

Favicon​

The favicon is the tiny icon that appears in the browser tab. Upload a square image, at least 64 x 64 pixels, PNG or ICO format.

Footer Text​

The Footer Text field appears at the bottom of every page and in emails. You can use this for a copyright notice, your company name, or a tagline.

Example: © 2026 Acme CRM. All rights reserved.

Login Page​

You can customize the login page background:

  • Background Color — sets a solid color behind the login form
  • Background Image — upload an image to use as the login page background

These options let you make the login page feel completely on-brand.

Click Save at the top of the page when you are done.

How Branding Applies Across the App​

Once you save your branding settings, the changes take effect immediately across:

  • Login page — your logo, colors, and background
  • Sidebar — your logo and app name
  • Browser tab — your app name and favicon
  • Emails — your sender name, from address, and footer text
  • Lead capture forms — your primary color and app name
  • Embedded widgets — inherit the colors you set per widget

Per-Tenant Branding​

If you are running LeadHub as a platform with multiple clients (workspaces), each workspace can have its own brand.

Each tenant's branding settings are completely independent. Client A sees their own logo and colors. Client B sees theirs. They never see each other's branding.

To set branding for a specific tenant:

  1. Log in to that tenant's workspace (or switch to it in the Super Admin panel).
  2. Go to Settings → Branding.
  3. Configure their branding and save.

Custom Domain Setup​

Go to Settings → Custom Domain in the sidebar.

By default, your LeadHub workspace is accessible at your server's domain or subdomain. With a custom domain, each tenant can access their workspace at their own URL — for example, crm.acmecorp.com.

Steps to Set Up a Custom Domain​

  1. Go to Settings → Custom Domain.
  2. Enter the domain in the Custom Domain field (without https://). Example: leads.yourcompany.com.
  3. Click Save Domain.
  4. Now go to your domain registrar (GoDaddy, Namecheap, Cloudflare, etc.) and add a DNS record:
    • Type: CNAME
    • Name: leads (or whatever subdomain you are using)
    • Value: the main domain of your LeadHub installation (shown on the settings page)
  5. DNS changes can take a few minutes to a few hours to take effect globally.

Once the DNS record points correctly, the workspace becomes accessible at the custom domain.

SSL Note: Your server needs an SSL certificate for the custom domain. If you are on shared hosting with cPanel, the AutoSSL feature usually handles this automatically once DNS is pointing correctly. On a VPS, your system administrator handles this.

Email Branding​

Go to Settings → Branding and look for the Email Sender section.

FieldWhat it does
Email Sender NameThe "From" name that appears in email clients (e.g. "Acme CRM")
From Email AddressThe email address emails are sent from

These settings work together with your SMTP configuration (see the Email Configuration page). The From Email must match a real, authorized email address for your SMTP provider — otherwise emails may be rejected or go to spam.

Login Page Customization​

The login page is the first thing your users see. You can customize it fully:

  • App Name — shown above the login form
  • Logo — shown above the app name
  • Primary Color — used for the login button and focus states
  • Background Color — the color behind the login form card
  • Background Image — an image fills the login page background

All of these are set in Settings → Branding.

Branding Checklist for a Complete White-Label​

Use this checklist to make sure you have fully replaced the LeadHub brand:

  • Set Application Name to your product name
  • Upload your Logo (300x80px PNG or SVG)
  • Upload your Favicon (64x64px PNG)
  • Set Primary Color to your brand color
  • Set Accent Color to a complementary color
  • Set Footer Text to your copyright notice
  • Set Email Sender Name to your product or company name
  • Set From Email Address to a real address at your domain
  • Set Login Background Color or upload a Login Background Image
  • (Optional) Configure a Custom Domain for each tenant