Page Branding

By default, hosted auth pages use Wristband's standard styling. Configuring page branding lets you customize colors, logos, and other visual elements so these pages match your brand instead. This applies to all hosted auth pages across signup, login, MFA, password reset, and more, unless overridden at the tenant level.

In the Wristband Dashboard, a preview pane lets you visualize your branding changes in real time as you edit. You can also cycle through different hosted pages to see how various configurations impact the appearance.

Common Configurations

You can customize a variety of common page and form elements to better align with your branding. These common configurations apply for hosted pages for the following workflows:

• Signup
• Tenant Discovery
• Login
• MFA Challenge and Enrollment
• User Invite
• Change Email
• User Activation
• Email Verification
• Password Reset

The image below shows how the common branding configurations map to various components on the hosted pages.

Page-Specific Configurations

You can configure custom side panel content for hosted login and signup pages. This allows you to tailor messaging, imagery, or other content specific to your brand or user journey. Side panels can be customized individually for the following pages:

• Application-Level Login
• Application-Level Signup
• Tenant-Level Login
• Tenant-Level Signup

One powerful feature of side panel configuration is the ability to embed dynamic content by pointing to a custom URL. This gives developers full control to display rich, branded marketing content tailored to their audience. It also enhances white-labeling by allowing each tenant to have a completely customized experience.

All iframe URLs are sandboxed, and strict Content Security Policy (CSP) headers are applied to ensure robust security for embedded content.

Tenant-Level Override

If you need to customize the page branding for a specific tenant, you can override the default configurations in the Tenant View of the Wristband Dashboard:

1. Select the tenant you want to customize from the side navigation menu.

   

2. Go to the 'Hosted Pages' submenu under the Branding section.

3. Enable the override by clicking the toggle at the top of the page to apply tenant-specific branding.

   

Once the tenant override for page branding is enabled, you can edit and save the tenant's branding configurations. These settings will take precedence over application-level branding for all hosted auth pages, except in the following cases:

• Application-Level Signup
• Tenant Discovery