White-Label Authentication: Custom Login Branding

Your users' first interaction with your platform is the login screen. If it looks generic or doesn't match your brand, it erodes trust before they even sign in. White-label authentication lets you control every pixel of that experience.

Why Login Branding Matters

Trust — Users are trained to be suspicious of unfamiliar login pages. A branded login screen with your company's logo and colors signals legitimacy. An unbranded, generic page triggers phishing alarms.

Professionalism — If you're selling a B2B platform, your customers expect a polished experience. Their employees logging into your tool should see the customer's branding, not yours.

Consistency — A jarring transition from your app's design to a completely different login page breaks the user experience. Consistent branding keeps users oriented and confident.

Branding Levels in Calimatic Identity

Calimatic Identity supports branding at multiple levels, giving you fine-grained control over the login experience:

Platform-Level Branding — The default branding applied when no organization or application-specific branding is configured. Set your company logo, primary color, and a welcome message.

Organization-Level Branding — Each organization can override the platform defaults with their own logo, colors, and messaging. When users from Acme Corp log in, they see Acme's branding. When users from Globex log in, they see Globex's branding.

Application-Level Branding — Different applications can have different login experiences. Your internal admin tool might have a different look than your customer-facing SaaS product, even though they share the same identity platform.

What You Can Customize

Here's the full list of customizable elements:

Logo — Upload your logo (PNG, SVG, or WebP). Displayed prominently on the login page.
Primary Color — Your brand color, applied to buttons, links, and accents.
Background — Choose a solid color, gradient, or image background.
Welcome Message — A custom heading displayed above the login form.
Support Text — Custom text below the form, typically used for support contact information.
Favicon — Custom browser tab icon for the login page.

Custom Domains

For the ultimate white-label experience, Enterprise plan customers can use custom domains for their login pages. Instead of auth.calimatic.com, your users see login.yourcompany.com.

Custom domains include:

Automatic SSL certificate provisioning
DNS verification workflow
Session cookie scoping to your domain
Full branding control

How It Works Technically

When a user navigates to the login page, Calimatic Identity determines which branding to apply:

Check the URL — If a custom domain is configured, use the organization associated with that domain.
Check the email domain — If the user has entered their email, look up the organization associated with their email domain.
Check the application — If the login was initiated by a specific application (via OAuth redirect), use that application's branding.
Fall back to platform defaults — If no specific branding matches, use the platform-level branding.

This resolution happens in milliseconds and is completely transparent to the user.

Setting Up Branding

Branding is configured in the admin panel under Settings > Branding (for platform-level) or within each organization's settings (for org-level).

Navigate to the branding settings
Upload your logo
Select your primary color using the color picker
Enter your welcome message and support text
Preview the login page in real-time
Save and publish

Changes take effect immediately — no deployment required.

Best Practices

Keep it simple — A clean logo on a solid background with a single accent color performs better than complex designs. Users want to log in quickly, not admire your art direction.

Test on mobile — More than half of authentication happens on mobile devices. Ensure your logo scales well and your colors have sufficient contrast on small screens.

Use SVG logos — SVGs scale perfectly at any resolution and typically have smaller file sizes than PNGs. This keeps your login page loading fast.

Maintain accessibility — Ensure sufficient color contrast between your text and background. Calimatic Identity's branding preview includes a contrast ratio checker to help you stay accessible.