Skip to main content
The Branding & Theme screen manages tenant white-labeling and theming at the route /settings/branding.

​
Overview

The screen is a tabbed hub with four sections: Colors, Typography, Login & assets, and Subdomain. Tab state is URL-synced via useTabUrlState. The active theme is loaded with useActiveTheme; mutations include useUpsertTheme, useResetTheme, and useImportTheme. A reset action triggers an alert dialog for confirmation before clearing org overrides. A preview badge indicates the current theme status. Users with pf.theme.manage can modify theme settings; pf.theme.view grants read-only access.

​
Who it’s for

Required permission: pf.theme.view (access); pf.theme.manage (edit/reset/import — SME: confirm exact manage permission name from code)

​
Before you start

  • You must hold the pf.theme.view permission.

​
Steps

1

Open Branding & Theme

Navigate to Settings → Branding & Theme.
2

Browse tabs

Select Colors, Typography, Login & assets, or Subdomain to view/edit that section.
3

Modify theme settings

Update color tokens, typography, or login page assets as needed.
4

Save changes

Apply changes using the save action within each tab.
5

Import a theme

Use the import action to apply a theme from an external source.
6

Reset to default

Click Reset and confirm in the alert dialog to restore platform defaults.

​
Key concepts

  • useActiveTheme — fetches the current tenant theme override
  • useResetTheme — clears tenant overrides and restores platform defaults
  • useImportTheme — applies a theme from an imported source

Platform Foundation

Platform Foundation overview.

Governance & parity

Documentation coverage and governance.
This page documents shipped product behavior. It is not medical, legal, or billing advice. Verify against your organization’s policies and applicable regulations before using it for clinical, compliance, or billing decisions. Protected health information (PHI) shown in the product is governed by your tenant’s access controls and is never exposed in this documentation.
  • src/routes/platform.tsx
  • src/platform/theming/pages/BrandingSettingsPage.tsx