PingOne

Adding a theme (early access)

PingOne delivers several built-in themes. Use the Branding and Themes page to add a theme to the current environment. The new theme will use your Company Name and Logo if you added them in Global Settings. Learn more in Editing environment branding (early access).

Steps

  1. In the PingOne admin console, go to User Experience > Branding and Themes.

  2. Click the icon.

  3. On the Choose a Base Theme page, click the theme you want to start with.

    When you select a base theme, PingOne generates a unique name for the new version. For example, if you select the Focus theme to start from, your new theme is named Focus 1 by default. You can edit this name before you continue.

  4. Click Next and select the tabs on the Customize page to change settings for the different page types.

    Page previews are displayed in the left panel, and the settings are configured from the right panel. The previews update in real time as you make changes to the settings. To switch between previews for desktop or mobile devices, click the Desktop or Mobile icon (ea p1 branding themes desktop mobile icon).

  5. Click the All tab to update settings that apply to all pages using the theme that don’t have page-specific settings.

    Setting Description

    Logo

    An image to represent the environment. Hover over the box and click the Camera icon to upload an image. Select an image in .jpg, .jpeg, .gif, or .png format up to 2 MB in size.

    To change the image used for the logo, click the Camera icon and select Upload New Image.

    To delete a logo from a theme, click the Camera icon, and select Remove Image.

    Footer

    Text that appears at the bottom of each page. Click the toggle to the right (blue) to enable footer text, then enter the text.

    You can include HTML in the footer, including the following elements and attributes:

    • a(href, target)

      To use an href, you must include the protocol in the address, such as ftp, http, https, mailto, tel, or sms.

    • b

    • blockquote(cite)

    • br

    • cite

    • code

    • dd

    • dl

    • dt

    • em

    • i

    • li

    • ol

    • p

    • pre

    • q(cite)

    • small

    • span

    • strike

    • strong

    • sub

    • sup

    • u

    • ul

    Button

    Configure the color of the buttons, such as the Sign on and Save buttons:

    • Button Fill: The background color for the buttons.

    • Button Text: The color of the text on the buttons.

    • Link Text: The color of the text for links displayed on the buttons.

    Text

    The color of the text on the pages:

    • Heading Text: The color of the text in headings.

    • Body Text: The color of non-heading text.

    Background

    The background to use on each page.

    • None: Do not use a background.

    • Image: To use an image for the background, hover over the box and click the Camera icon to upload an image. Select an image in jpg, jpeg, gif, or png format up to 2 MB in size.

      To change the image used for the background, click the Camera icon and select Upload New Image.

      To delete a background image from a theme, click the Camera icon, and select Remove Image.

    • Color: Select a color to use for the background.

    Card Color

    The color of the box around form fields.

  6. Click the Forms tab to see how your updates to the Global Styles settings affect the PingOne forms in your environment.

    There are no page-specific settings for Forms.

  7. Click the Verify tab to see how your updates to the Global Styles settings affect the appearance of identity verification pages in your environment.

    There are no page-specific settings for Verify.

  8. Click the End User Application tab to update the settings that control the appearance of system applications, such as the Application Portal and Self-Service - My Account.

    Setting Description

    Background Color

    The background color used for the application.

  9. Click the Authentication Policy tab to see how your updates to the Global Styles settings affect the sign-on and registration pages in your environment.

    There are no page-specific settings for Authentication Policy.

  10. Click Save.

    The theme is added to the list on the Branding and Themes page.

    You can also customize an existing theme. Learn more in Editing a theme (early access).

Next steps

Selecting an active theme (early access)