Apps documentation
Theme Extension for Jira Service Management
Theme Extension for Jira Service Management
Documentation
FAQ
Release notes
Articles & Videos
Last updated Oct 22, 2021

Login screens

Learn how to customize the login screen

Theme Extension enables you to customize the login screen which enhances the experience and provides consistency with the company’s design language. You can set the login screen to inherit the colors and layouts from the Help Center or you can configure it differently.

Login screen’s customizable elements include:

  • Background - Upload the image or fill it with color.
  • Announcement - Add an announcement to display a message to your customers. For example, a note about support hours, or a warning about an incident with your tool.
  • Logo - Upload the image (recommended size: height 40 pixels, max. width 160 pixels). If you don’t add a logo, your help center name displays here instead. This help center name can be also modified.
  • Footer - Add a piece of short information about your company, links to external resources, or anything else you need.
Warning
Before you start, log in as a user with the Jira Administrators global permission.

Layouts inherited from Help Center

When the login screen inherits all the settings from the Help Center, it mirrors certain colors to create a consistent layout. Below you can see how the colors are arranged in different elements.

native Help Center

Login screen element Help Center configuration
Top background Banner background or uploaded graphics
Bottom background Gray
Announcement banner Color which is based on the banner background, implemented by Atlassian
Logo Logo
Footer Powered by Jira Service Desk or Powered by Jira Service Management (from JSM 4.14)
Inherited login screen: Native Help Center in Theme Extension for Jira Service Management
Native Help Center in Theme Extension for Jira Service Management

List theme

Login screen element Help Center configuration
Top background Color #2 from List configuration
Bottom background Color #1 from List configuration
Announcement banner Color #1 from List configuration or color configured in the Announcement banner
Logo Text or uploaded graphics configured in the Home Link
Footer Color #1 from List configuration or color configured in the Footer
Inherited login screen: List Help Center in Theme Extension for Jira Service Management
Inherited login screen: List Help Center in Theme Extension for Jira Service Management

Cards theme

Login screen element Help Center configuration
Top background Uploaded graphics or color configured in the Top background
Bottom background Uploaded graphics or color configured in the Bottom background
Announcement banner Color configured in the Announcement banner
Logo Text or uploaded graphics configured in the Logo
Footer Color configured in the Footer
Inherited login screen: Cards Help Center in Theme Extension for Jira Service Management
Inherited login screen: Cards Help Center in Theme Extension for Jira Service Management

Editing the elements

Info

By default, all the elements are inherited from Help Center. In order to modify them, turn off the toggle at top of each configuration panel.

Editing panel with Theme Extensions for Jira Service Management
Inherit toggle in the editing panel

Steps

  1. Go to Jira Administration > Manage apps.
  2. Select Log in screens under Theme Extension.
    Login screen configuration in Theme Extensions for Jira Service Management
    Login screen configuration in Theme Extensions for Jira Service Management
  3. Select the Custom option which allows you to open the editor.
    Note
    The native login screen provided by Atlassian is active as default.
  4. Click Next.
    Login screen configuration in Theme Extensions for Jira Service Management
    Login screen configuration in Theme Extensions for Jira Service Management
  5. Click Elements in the top navigation and edit your selected elements.
    Login screen configuration in Theme Extensions for Jira Service Management
    Login screen configuration in Theme Extensions for Jira Service Management
Tip
You can also access all the editing panels by simply clicking them on the screen.

Background

In order to change the background, click anywhere on the screen and select background type: Divided or Solid.

Note

Solid background has only one configuration panel whereas in Divided background, each one is configured separately.

By selecting Divided background, you can configure the top and bottom graphics. Use drag and drop to upload images or choose colors using the palette. You can also decide on the position of your images.

Login screen: Background settings in Theme Extension for Jira Service Management
Login screen: Background settings in Theme Extension for Jira Service Management

By selecting Solid background, use drag and drop to upload your background image or choose colors using the palette. You can also select how the image fills the background.

Login screen: Background settings in Theme Extension for Jira Service Management
Login screen: Background settings in Theme Extension for Jira Service Management

Announcement banner

Customize your banner by using various styles and colors. Create a message and format your texts and links. You can also upload an image.

Info
The recommended size for the image is 80 x 80 pixels.

Login screen: Announcement banner settings in Theme Extension for Jira Service Management
Login screen: Announcement banner settings in Theme Extension for Jira Service Management

You can always preview the configuration of your banner to check the introduced formatting before saving your changes.

Login screen: Announcement banner preview in Theme Extension for Jira Service Management
Login screen: Announcement banner preview in Theme Extension for Jira Service Management

Customize the logo which appears in the top-left corner of the screen. Type the text and change its color. You can also upload an image.

Login screen: Logo settings in Theme Extension for Jira Service Management
Login screen: Logo settings in Theme Extension for Jira Service Management

Note

If you upload an image, it will replace the text even if it’s in the text field.

Design the configuration of your footer by selecting the style of its background, texts and links. You can insert the footer text and customize its layout.

Login screen: Footer settings in Theme Extension for Jira Service Management
Login screen: Footer settings in Theme Extension for Jira Service Management

You can always preview the configuration of your footer to check the introduced formatting before saving your changes.

Login screen: Footer preview in Theme Extension for Jira Service Management
Login screen: Footer preview in Theme Extension for Jira Service Management

Once you’ve finished editing, apply the settings to your login screen by clicking Save & Publish.

Login screen: Edit mode in Theme Extension for Jira Service Management
Login screen: Edit mode in Theme Extension for Jira Service Management

Result

Your login screen is customized. Open the Help Center in incognito mode to check if the screen is loading properly.

Login screen customized by Theme Extension for Jira Service Management
Login screen customized by Theme Extension for Jira Service Management
Need help?

If you can’t find the answer you need in our documentation, raise a support request.