Overview
White-label branding allows you to replace Reportr’s branding with your own agency identity. Your custom logo, company name, brand colors, and contact information appear throughout the platform and in all generated PDF reports.Available on: Professional and Agency plans, or as a $20/month add-on to Starter plans
Accessing Branding Settings
Navigate to Settings → Branding from your dashboard sidebar. You’ll see the branding configuration interface with a live preview panel.Configuration Options
White-Label Toggle
The master switch that enables or disables white-label branding:Enable White-Label
Toggle the Enable White Label Branding switch to ON. This activates all customization fields.
Company Information
Your agency details that appear in reports and the platform:Agency Name (max 50 characters)Appears on:
- PDF report cover pages
- Dashboard header
- Report footers
- Platform UI
"Acme Digital Marketing"Website URL (max 100 characters)Appears on:
- Report cover pages
- Report footers
https:// (e.g., "https://acmedigital.com")The protocol is stripped in display: acmedigital.comSupport Email (max 100 characters)Appears on:
- Report footers
- Client-facing documentation
[email protected]Company Logo
Upload your agency logo to replace Reportr branding:Supported Formats
- PNG (recommended)
- JPG / JPEG
- GIF
- WebP
Size Requirements
- Maximum file size: 2MB
- Recommended: 400x400px square
- Displayed at: 40x40px (UI), 120x60px (PDF)
Logo Upload Process
File Validation
System validates:
- File type (image formats only)
- File size (must be under 2MB)
Logo Implementation
Logos are base64-encoded and stored in the database:Logo Upload (from source)
Brand Colors
Customize the primary color used throughout the platform:- Preset Colors
- Custom Color
Choose from 8 predefined colors optimized for readability:
- Purple:
#8B5CF6(default) - Blue:
#3B82F6 - Green:
#10B981 - Orange:
#F59E0B - Red:
#EF4444 - Indigo:
#6366F1 - Pink:
#EC4899 - Teal:
#14B8A6
Where Colors Appear
Platform UI
Platform UI
- Sidebar active states
- Primary buttons
- Links and accents
- Progress indicators
- Chart colors
PDF Reports
PDF Reports
- Cover page title
- Section headers
- Chart accent colors
- Company name text
- Divider lines
Color Theming Implementation
Colors are applied using CSS custom properties:Dynamic Color Application
Branded PDF Styles (from source)
Live Preview
The branding settings page includes a real-time preview panel showing:Report Cover
Preview of how your PDF cover page will look with:
- Your logo
- Company name
- Brand colors
- Website URL
Platform Elements
Simulated UI components styled with:
- Primary color buttons
- Branded navigation
- Accent elements
Preview States
- White-Label Enabled
- White-Label Disabled
Shows full branding preview with all your customizations applied in real-time as you make changes.
Validation & Limits
The system validates your branding inputs:- Required when white-label is enabled
- Minimum 2 characters
- Maximum 50 characters
- Character count indicator turns yellow at 80% (40 chars)
- Turns red when exceeding limit
- Optional field
- Must be valid URL format if provided
- Maximum 100 characters
- Automatically validates URL structure
- Optional field
- Must be valid email format if provided
- Maximum 100 characters
- Validates against email regex:
/^[^\s@]+@[^\s@]+\.[^\s@]+$/
- Must be valid hex color
- 6-character hex format:
#RRGGBB - Color picker enforces valid format
- Optional field
- File size: Max 2MB
- Formats: PNG, JPG, GIF, WebP
- Stored as base64 data URI
Validation Implementation
Branding Validation (from source)
Database Schema
Branding settings are stored in the User model:User Branding Fields
Access Control
White-label features are gated by plan:Plan Check (from source)
Upgrade Prompt
Users without access see:PDF Report Branding
When white-label is enabled, PDF reports are fully customized:Cover Page
Cover Page Branding (from CoverPage.tsx)
Report Sections
All section headers use brand color:Section Headers
Footer
Report Footer
Platform Branding
Your branding also appears in the web platform:Dashboard Header
Dashboard Header
- Company logo in sidebar
- Company name in header
- Brand color for active nav items
Buttons & CTAs
Buttons & CTAs
Data Visualizations
Data Visualizations
- Chart accent colors
- Progress bars
- Status indicators
Client-Facing Pages
Client-Facing Pages
- Login/signup screens (future)
- Client portals (future)
- Shared report links (future)
Best Practices
Logo Design
- Use square format (1:1 ratio)
- Transparent background
- High resolution (400x400px minimum)
- Simple, recognizable design
Color Selection
- Choose high-contrast colors
- Test readability on white backgrounds
- Ensure accessibility (WCAG AA)
- Match your existing brand
Company Info
- Use formal company name
- Include www subdomain in website
- Use dedicated support email
- Keep info current
Testing
- Generate test report after setup
- Review all pages in PDF
- Check color rendering
- Verify logo clarity
Common Issues
Logo appears blurry in PDF
Logo appears blurry in PDF
Cause: Low-resolution source imageSolution: Upload a higher resolution logo (at least 400x400px). PDFs render at 300 DPI, so small images appear pixelated.
Brand color looks different in PDF vs web
Brand color looks different in PDF vs web
Cause: Different color rendering between screen (RGB) and PDF (may be converted to CMYK)Solution: This is normal. Test your color choice and adjust if needed. Bright colors may appear slightly different.
Logo not showing in reports
Logo not showing in reports
Cause: File size too large or invalid formatSolution:
- Check file is under 2MB
- Use PNG or JPG format
- Re-upload and save settings
- Generate new report to test
Changes not appearing immediately
Changes not appearing immediately
Cause: Browser cache or unsaved settingsSolution:
- Click “Save Settings” after making changes
- Hard refresh browser (Ctrl+Shift+R)
- Generate new report to see updated branding
Pricing
Professional
$49/monthWhite-label included
- 25 clients
- 100 reports/month
Agency
$99/monthWhite-label included
- Unlimited clients
- Unlimited reports
Starter Add-On
+$20/monthAdd white-label to Starter planBase: 39/month
Related Resources
Report Generation
See how branding appears in reports
Customize Branding
Step-by-step branding setup guide
Upgrade Plan
Compare plans and add white-label