White Label
Customize Workestra with your own branding, domain, and login experience for your organization.
White Label
White-label lets you present Workestra under your own brand. Your team sees your logo, your colors, and your domain — with no mention of Workestra unless you choose to show it.
White-label is available on the Enterprise plan and requires Admin or Owner permissions.
What You Can Customize
| Area | What Changes |
|---|---|
| App name | Browser tab title, sidebar footer, login page, PWA |
| Logos | Sidebar (expanded + collapsed), login page, mobile header |
| Colors | Primary, secondary, and accent brand colors |
| Font | Font family across the entire interface |
| Login page | Welcome text, description, background image |
| Domain | Custom domain (e.g., crm.yourcompany.com) |
| Favicon | Browser tab icon |
| PWA | App name, icon, and colors when installed on mobile |
| Sender name, domain, and logo in outgoing emails | |
| "Powered by" | Can be hidden entirely |
Getting Started
Navigate to Settings > Administration > White Label. The configuration is organized into six tabs.
General
- App Name — Your company or product name. Appears in the browser tab, sidebar, and login page.
- Hide Workestra Branding — When enabled, removes all Workestra references from the interface.
- Hide "Powered by" — Removes the "Powered by Workestra" text from the login page footer.
- Custom CSS — Advanced: inject custom CSS rules to fine-tune styling beyond the standard options.
- Meta Title — Override the browser tab title (defaults to app name if empty).
Branding
- Full Logo — Horizontal logo for the sidebar and login page. Recommended: 120x24px, PNG or SVG.
- Icon Logo — Square logo for the collapsed sidebar and PWA icon. Recommended: 24x24px.
- Favicon — Browser tab icon. Recommended: 32x32px, .ico or .png.
- Primary Color — Main brand color used for buttons, links, and accents.
- Secondary Color — Optional secondary accent.
- Accent Color — Optional tertiary accent.
- Font Family — The font used across the interface (e.g.,
Inter,Roboto,Poppins).
Login Page
- Welcome Text — Large heading on the left panel of the login page (replaces the default carousel).
- Description — Subtitle below the welcome text.
- Background Image — Optional background image for the login page left panel (displayed at 30% opacity).
When white-label is active, the login page:
- Shows your logo instead of the Workestra logo
- Displays your welcome text and description
- Uses your favicon and page title
- Hides Workestra terms/privacy links
- Shows "Powered by Workestra" only if enabled
PWA (Progressive Web App)
These settings control how the app appears when installed on a mobile device or desktop:
- PWA Name — Full app name in the install dialog.
- PWA Short Name — Abbreviated name on the home screen.
- Background Color — Splash screen background.
- Theme Color — Status bar color on mobile.
Domain
Connect a custom domain so your team accesses the platform at your own URL.
Setup steps:
- Enter your desired domain (e.g.,
crm.yourcompany.com) - Save — a verification token is generated automatically
- Add the domain in your Vercel project settings (Settings > Domains)
- At your domain registrar, create a CNAME record pointing to the value Vercel provides
- Optionally, add a TXT record with the verification token for ownership verification
- Contact your Workestra administrator to mark the domain as verified
Use the CNAME target from the Vercel dashboard, not from the instructions card. Each domain gets a unique target.
DNS changes can take up to 48 hours to propagate. Vercel automatically provisions SSL once the CNAME is detected.
- From Name — Display name for outgoing emails (e.g., "BatiOffice Support").
- From Domain — Custom sender domain. Requires DNS verification (SPF, DKIM, DMARC records).
- Email Logo — Logo included in email templates.
How It Works
When someone visits your custom domain:
- Marketing pages are blocked —
/,/pricing, and other public pages redirect to/login - Login page loads your branding — Logo, colors, welcome text, favicon appear instantly
- After sign-in — The sidebar, page titles, and UI elements all use your branding
- PWA installs use your app name and icon
Your team's data remains fully isolated. Other workspaces on the same Workestra infrastructure cannot see your data, and you cannot see theirs.
Asset Recommendations
| Asset | Size | Format | Notes |
|---|---|---|---|
| Full logo | 120 x 24 px | SVG or PNG | Horizontal layout, transparent background |
| Icon logo | 24 x 24 px | SVG or PNG | Square, for collapsed sidebar |
| Favicon | 32 x 32 px | ICO or PNG | Browser tab icon |
| Login background | 1920 x 1080 px | JPG | Optional, displayed at 30% opacity |
| Email logo | 200 x 50 px | PNG | For email template headers |
Upload assets to a publicly accessible URL (e.g., your CDN or cloud storage). Paste the URL into the corresponding field.
FAQ
Can I change the branding after setup?
Yes. All changes take effect immediately after saving. Users may need to refresh their browser to see updates.
Will my team see "Workestra" anywhere?
Not if you enable Hide Workestra Branding and Hide "Powered by". The only remaining reference would be in the URL if you haven't configured a custom domain.
Can I use my own subdomain?
Yes. Any subdomain works (crm., app., portal., hub., etc.). Multiple clients can use the same subdomain prefix (e.g., crm.clienta.com and crm.clientb.com) since they're different domains.
What happens if I visit the Workestra URL directly?
You'll see the standard Workestra interface. White-label branding only applies when accessing through your custom domain.
Can I add custom CSS?
Yes, via the Custom CSS field in the General tab. This is injected into the page and can override any styling. Note that certain unsafe CSS patterns (@import, javascript:) are automatically stripped for security.
Does the mobile app (PWA) get branded too?
Yes. When users install the app from your custom domain, the PWA manifest returns your app name, icon, and theme colors.