Skip to main content

Create and bind themes

Create custom themes to personalize web pages and messages.

Themes are built using Golang-based HTML templates. You can create and preview a theme before applying it to one or more workspace.

Create theme

Don't want to start from scratch?

Duplicate an existing custom theme to avoid starting from the default SecureAuth branding.

Click the three dots next to the theme you want to duplicate, and click Duplicate theme.

  1. In your workspace, go to Tenant Settings > Appearance. Select Themes.

    Tenant settings
  2. Click + CREATE THEME.

    1. Provide a unique name for your theme.

    2. Optional. Provide a URL for a theme icon. This logo is not applied to branded pages but is used to distinguish themes in the themes view.

    3. Click Create.

      Result: Your new theme appears in the Themes list.

  3. Select the theme you want to customize.

  4. Edit the HTML template for each page or message you want to customize. Check your changes in the preview window.

    The templates are organized by the following categories:

    • Pages – The UI as viewed by the end user.

    • Messages – The messages sent to users during different flows.

      To learn more, see Customize messages.

    • Components – Elements used in multiple templates. For example, headers.

      Preview for individual components is unavailable. To preview your changes, check the affected template under Pages.

  5. Save your changes.

    Tip

    If the Save button is inactive, check the console for errors.

Bind theme

Bind (assign) a theme to one or more workspaces. Each workspace can have only one theme assigned.

  1. From the Themes list, click the three dots next to theme you want to bind.

  2. Click Bind to Workspace.

  3. Select the workspace and click Save.