Apps documentation
Theme Extension for Jira Service Management
Cloud Server/Data Center
Theme Extension for Jira Service Management

Cloud

Server/Data Center

Documentation
FAQ
Release notes
Last updated Nov 5, 2022

Page editor

Learn how you can tailor the Page’s design to your needs

Warning

Before you start, log in as a user with Jira Administrators global permissions. For more information, see Atlassian documentation.

After adding a Page, you can manually change all the details of its currently applied template and add various elements for better customer experience.

In the Page editor, customization occurs in the following categories:

Accessing the editor

Steps

  1. In the configuration panel, go to Pages.
  2. Click the three pen icon next to the desired Page.
    Theme Extension for Jira Service Management - Edit button
    Theme Extension for Jira Service Management - Edit button

Result

Page editor is accessed. You can now see the currently applied template.

Theme Extension for Jira Service Management - Page editor
Theme Extension for Jira Service Management - Page editor

Warning

If you click Back or close the browser tab without publishing the Page, all the changes will be lost.

Theme Extension for Jira Service Management - Warning
Theme Extension for Jira Service Management - Warning

Visual

Visual category lets you change the active template and configure colors of both sections along with fonts and headers.

Below you can see a Page with highlighted components and their names so that it’s easier to find your way around the editor.

Theme Extension for Jira Service Management - Page layout
Theme Extension for Jira Service Management - Page layout
  1. Main section
  2. Navigation section
  3. Primary font
  4. Secondary font
  5. Main section link
  6. Header
  7. Page name
  8. Selected element
Note

Any change in the Visual category will automatically switch the active template to Custom which can later be saved as a new template in order to preserve the already existing ones.

Steps

  1. Set the colors of the Main section using the color picker, HEX code, or RGB codes.
    Theme Extension for Jira Service Management - Color picker
    Theme Extension for Jira Service Management - Color picker
    Tip

    Use the minus icon to turn off the configuration of individual colors. That way they will automatically match the background color to create the best possible composition. You can always configure them manually by clicking the plus icon.

    Theme Extension for Jira Service Management - Automatic colors
    Theme Extension for Jira Service Management - Automatic colors
  2. Turn on the toggle if you want the request type icons to be visible on the Page.
    Theme Extension for Jira Service Management - Show request type icons
    Theme Extension for Jira Service Management - Show request type icons
  3. Set the colors of the Navigation section using the color picker, HEX code, or RGB codes.
Note

Navigation section colors can also inherit the color composition from the Main section background color.

Result

The visual layer is configured, you can now proceed to edit the General settings.

Theme Extension for Jira Service Management - Visual result
Theme Extension for Jira Service Management - Visual result

General

In the General category, you can change the name of the Page which is visible on the configuration panel. In order to do so, click on the text field and start typing.

Theme Extension for Jira Service Management - General
Theme Extension for Jira Service Management - General
Note

Page name can be maximum 48 characters long.

You can now proceed to adding Elements to your Page.

Theme Extension for Jira Service Management - Elements tab
Theme Extension for Jira Service Management - Elements tab

Elements

With Elements you can insert additional information that will be displayed on your Page. Each Element is unique to each Page and can be configured only in the Page editor.

Currently, there are four configurable Elements:

  • Logo/Home link
  • Searcher
  • Header
  • Announcement banner
  • Footer

Steps

  1. Click on the pen icon to expand the Logo/Home link panel.
    Theme Extension for Jira Service Management - Home link section
    Theme Extension for Jira Service Management - Home link section
  2. Choose the text of the link with up to 48 characters. Alternatively you can upload an image using drag and drop or by browsing files.
    Note

    Supported formats are JPG, JPEG, PNG, HEIC.

  3. Choose the target of the link.
  4. Click Save.
    Theme Extension for Jira Service Management - Home link configuration
    Theme Extension for Jira Service Management - Home link configuration

Result

Logo and Home link are configured.

Searcher

Steps

  1. Click on the pen icon to expand the Searcher panel.

    Theme Extension for Jira Service Management - Searcher
    Theme Extension for Jira Service Management - Searcher

  2. Turn on the toggle if you want to add a search bar to your Page.

  3. Optionally, you can create a custom Placeholder text to be visible in the search bar.

  4. Set the colors of the search bar using the color picker, HEX code, or RGB codes.

  5. Click Save.

    Theme Extension for Jira Service Management - Searcher Configuration
    Theme Extension for Jira Service Management - Searcher Configuration

Result

Your search bar is configured.

Steps

  1. Click on the pen icon to expand the Header panel.
    Theme Extension for Jira Service Management - Header section
    Theme Extension for Jira Service Management - Header section
  2. Turn off the toggle if you want to hide the header from the Page.
  3. Change the text of the header.
  4. Click Save.
    Theme Extension for Jira Service Management - Header configuration
    Theme Extension for Jira Service Management - Header configuration

Result

Header is configured.

Announcement banner

Steps

  1. Click on the pen icon to expand the Announcement banner panel.
    Theme Extension for Jira Service Management - Announcement banner configuration
    Theme Extension for Jira Service Management - Announcement banner configuration
  2. Turn on the toggle to display the announcement banner.
  3. Choose the colors of the font, background, and border.
    Note

    Default colors of the announcement banner are inherited from the Navigation section colors.

  4. Enter the text of the banner. You can format it using the Rich text editor.
  5. Upload an image.
    Note
    • Maximum dimensions are 32x32 pixels.
    • Supported formats are JPG, JPEG, PNG, HEIC.
  6. Click Save.
    Theme Extension for Jira Service Management - Announcement banner configuration
    Theme Extension for Jira Service Management - Announcement banner configuration

Result

Announcement banner is added.

Steps

  1. Click on the pen icon to expand the Footer panel.
    Theme Extension for Jira Service Management - Footer configuration
    Theme Extension for Jira Service Management - Footer configuration
  2. Turn on the toggle to display the footer.
  3. Choose the colors of the font and background.
    Note

    Default colors of the footer are inherited from the Main section colors.

  4. Enter the text of the banner. You can format it using the Rich text editor.
    Theme Extension for Jira Service Management - Footer configuration
    Theme Extension for Jira Service Management - Footer configuration

Result

Footer is added. You can now proceed to adding more service projects to your Page.

Theme Extension for Jira Service Management - Footer configuration
Theme Extension for Jira Service Management - Footer configuration

Projects

You can add more service projects to the Page that will be displayed in the Navigation section along with their request types groups.

Steps

  1. Click on the field to expand a drop-down list.
  2. Select as many projects as you want or delete the existing ones.
    Theme Extension for Jira Service Management - Projects configuration
    Theme Extension for Jira Service Management - Projects configuration
    Note

    Types of supported projects are:

    • Team-managed
    • Service
    • Classic

Result

Projects are added.

Publishing

Once you’ve configured your Page, you can now publish it and make it available for customers. In order to do so, click Publish in the bottom right corner.

Theme Extension for Jira Service Management - Publish button
Theme Extension for Jira Service Management - Publish button

Click Save as new if you want to save your design as a new template. Alternatively, click Publish to make the design exclusive to the current Page.

Theme Extension for Jira Service Management - Publish Page
Theme Extension for Jira Service Management - Publish Page

The Page is now published.

Theme Extension for Jira Service Management - Page published
Theme Extension for Jira Service Management - Page published

Need help?

If you can’t find the answer you need in our documentation, raise a support request.
Include as much information as possible to help our support team resolve your issue faster.