WHMCS White Label Setup: Building Your Own Branded Hosting Platform

A professional hosting business needs a fully branded customer experience. This guide covers every aspect of white-labeling WHMCS—from visual branding to email customization—so your customers see only your brand throughout their journey.

Step 1: Basic Branding Configuration

Company Information

1. Go to Setup → General Settings → General
2. Set Company Name (appears throughout WHMCS)
3. Configure support email addresses
4. Set default timezone and date format

Logo Configuration

1. Go to Setup → General Settings → General
2. Upload Logo URL (client area header)
3. Set Logo Height for proper sizing
4. Configure Favicon for browser tabs

Logo Best Practices

• Format: PNG with transparent background
• Client area: Max 250px width, 60px height
• Favicon: 32x32 or 64x64 pixels, ICO or PNG
• Email logo: Hosted on CDN for fast loading

Step 2: Theme Customization

Custom Color Scheme

Modify the default theme to match your brand colors:

Method 1: Custom CSS Override

1. Create templates/[theme]/css/custom.css
2. Override default colors with your brand palette
3. Include the file in header template

Key CSS Variables to Override

• Primary color (buttons, links, highlights)
• Secondary color (accents, hover states)
• Header background color
• Navigation colors
• Alert and notification colors

Method 2: Child Theme

1. Copy default theme folder to new name
2. Modify only files you need to change
3. Select new theme in WHMCS settings
4. Child theme survives WHMCS updates

Step 3: Email Template Branding

Global Email Header/Footer

1. Go to Setup → Email Templates → Email Templates
2. Select each email template category
3. Edit templates to include branded header/footer

Email Branding Elements

• Header: Logo + company name
• Colors: Match website brand colors
• Footer: Contact info, social links, legal text
• Signature: Personalized team sign-offs

Email Best Practices

• Host images on CDN (not inline base64)
• Use table-based layouts for compatibility
• Test across email clients (Gmail, Outlook, Apple Mail)
• Include plain text versions
• Add unsubscribe link for marketing emails

Step 4: Invoice and PDF Customization

Invoice Branding

1. Go to Setup → General Settings → Invoices
2. Configure invoice PDF settings:
   • Company logo for invoice header
   • Invoice number format
   • Payment terms text
   • Footer notes (bank details, legal info)

PDF Template Customization

Create custom PDF templates for professional invoices:

• Custom header with logo and company address
• Branded color scheme for table headers
• Custom fonts matching your brand
• QR code for quick payment
• Terms and conditions in footer

Step 5: Remove Third-Party Branding

WHMCS Footer

The WHMCS license typically requires attribution, but you can minimize visibility:

• Check your license terms for branding requirements
• Some licenses allow complete branding removal
• Style the attribution to be less prominent

Server Provider Branding

Remove references to your upstream providers:

• Custom nameservers (ns1.yourdomain.com)
• Branded cPanel/Plesk with your logo
• Custom server hostnames
• Personalized welcome emails

Step 6: Custom Domain for Client Area

Professional URL Structure

• Subdomain: clients.yourdomain.com
• Alternative: my.yourdomain.com
• Avoid: yourdomain.com/whmcs or /billing

SSL Configuration

1. Install SSL certificate for client area domain
2. Force HTTPS redirects
3. Configure HSTS headers

Step 7: Support Experience Branding

Ticket System Customization

• Custom department names (not "Sales" → "Billing Inquiries")
• Branded auto-responses
• Personalized signatures for staff
• Custom ticket statuses with your terminology

Knowledge Base Branding

• Custom categories matching your services
• Branded article templates
• Your logo in article headers
• Custom sidebar with your resources

Step 8: Client Area Navigation

Customize Menu Items

• Rename default menu items to match your branding
• Add custom links (blog, status page, community)
• Remove unnecessary menu items
• Organize by customer priority

Custom Pages

Add branded content pages:

• About Us page within client area
• Custom tutorials specific to your services
• Service status integration
• Promotional announcements

Step 9: Mobile Experience

Ensure branding works on mobile devices:

• Responsive logo (scales properly)
• Touch-friendly navigation
• Readable font sizes
• Properly sized buttons
• Fast loading images

Step 10: Ongoing Brand Maintenance

Update Checklist

After each WHMCS update, verify:

• Custom templates still work
• CSS overrides apply correctly
• Email templates remain branded
• Logo displays properly
• Custom pages are accessible

White Label Quality Checklist

Conclusion

A fully white-labeled WHMCS installation builds customer trust and reinforces your brand at every touchpoint. Take time to customize thoroughly—from logos to email signatures—and maintain your branding through updates. The result is a professional hosting experience that feels entirely your own.