Edit the home page of a help center
Editing the home page of your help center lets you gain control over how help content is displayed to your customer.
You need to be a Jira admin to edit the home page of a help center.
How you edit the home page depends on whether your help center is labeled Modern or Legacy. Find out which help center you're using.
Edit the home page in a Modern help center
In a Modern help center, you edit the home page directly in the editor. You build the page from sections and components, which you can add, arrange and delete. Cards replace topics, and a JSM Help component shows portals as cards so you can feature the ones that matter most.
To edit the home page of a Modern help center:
Select Help centers in the left navigation sidebar.
On the card for the help center you want to edit, select Customize help center (pencil icon).
In the toolbar, select Pages, then select Home.
Add, move or delete sections and components on the page.
To feature portals, add a JSM Help component. On its Source tab, set Type to Portals, then select the spaces whose portals it shows. On its Content tab, you can change the Heading and choose how to Order cards by, such as Popularity.
Select Publish.
Find out more about adding and arranging components on a page. Find out what each component does.
Customize the top of the home page
In a Modern help center, the top of the home page is a Callout banner. It holds the main heading, a description and search. Instead of search, it can show your help center's Rovo agent. On its Style tab, you can change its:
Size, such as Medium
Background type and Background color
Title color
Alignment: left, center or right
Corners
Search type:Normal shows a search bar with a search results page, and None hides search
To customize the top of the home page in a Modern help center:
Open the home page in the editor, then select the callout banner. Its settings open in the side panel.
On the Style tab, change the settings you want. To change the heading, go to the Content tab and edit Title. To add a description, turn on Description, then enter it in Description text. To add a Rovo agent, select Go to help center settings on the Style tab.
To change its width, use the width menu in the toolbar below the banner: Back to center,Go wide or Go full width.
Select Publish.
Edit the home page in a Legacy help center
In a Legacy help center, you edit the home page by managing topics and portals.
In the help center home page, you can:
Manage how topics and portals are organized in the home page
Manage topics and portals
To manage topics and portals:
Select Settings () at the top right.
From the dropdown menu, select Jira apps.
Under the Jira Service Management header, select Help center permissions.
Under Help center management, select View all help centers.
On the card for the help center you want to edit, select … at the top right.
Select Customise look and feel. The help center opens.
Select Customise at the top right, and from the dropdown, select Manage topics and portals.
Once you're in the Manage topics and portals page, make necessary changes to the layout.
You can create and manage topics, manage visibility of topics and portals, and feature and sort portals from here.
Select Publish layout to make the changes you made show up on the help center.
You can also discard the changes you made and revert to the last published version of the home page layout by selecting Cancel.
For information on customizing the fields of a request form shown in your portal, see Customize a request type
Hide topics and portals from the home page
You may not want to show all topics or portals to customers in your help center. For example, some topics or service spaces might contain sensitive information, be used for testing or evaluation, or only be relevant during certain times of the year. In other cases, you may want customers to raise requests to specific service spaces only by email, rather than through the help center.
In these situations, you can hide topics or portals from the help center home page.
You need to be a Jira admin to manage the visibility of portals and topics in the help center home page.
To hide a topic or portal:
Select Settings () at the top right.
From the dropdown menu, select Jira apps.
Under the Jira Service Management header, select Help center permissions.
Under Help center management, select View all help centers.
On the card for the help center you want to edit, select … at the top right.
Select Customise look and feel. The help center opens.
Select Customise at the top right, and from the dropdown, select Manage topics and portals.
Once you're in the Manage topics and portals page, hover over the topic or portal you want to hide and select the Hide from home page icon. Remember that doing this doesn't hide this portal or topic from the home page yet.
Select Publish layout to hide the portal or topic from the home page.
You can revert to the last published version of the home page by selecting Cancel. You'll lose all the changes you've made up until then. Portals or topics you may have hidden in that session will continue to be visible in your help center.
All Jira admins can see and manage hidden portals and topics in the Manage topics and portals page. Currently, these portals and topics will show up in search results, and will also be visible to users who access them via their direct URLs.
To remove a portal and help resources from it, and ensure that they do not show up in the help center, in topics, and in search, you can unlink the service project from your help center.
To make a hidden portal or topic visible in your home page:
Select Settings () at the top right.
From the dropdown menu, select Jira apps.
Under the Jira Service Management header, select Help center permissions.
Under Help center management, select View all help centers.
On the card for the help center you want to edit, select … at the top right.
Select Customise look and feel. The help center opens.
Select Customise at the top right, and from the dropdown, select Manage topics and portals.
Once you're in the Manage topics and portals page, go to the Hidden section under Topics or Portals.
Select the Show in home page icon on the hidden portal or topic of your choice. Remember that doing this doesn't make the portal or topic visible in the home page yet.
Select Publish layout to show the portal or topic in your home page.
You can revert to the last published version of the home page layout by selecting Cancel. You'll lose all the changes you've made up until then.
Feature and organize portals in the home page
You can help customers self-serve by featuring relevant portals at the top of a help center's home page. This is especially useful for promoting portals that are business-critical or are commonly used by customers. You can feature up to 15 portals in a help center.
You need to be a Jira admin to feature portals in a help center.
To feature specific portals on the home page:
Select Settings () at the top right.
From the dropdown menu, select Jira apps.
Under the Jira Service Management header, select Help center permissions.
Under Help center management, select View all help centers.
On the card for the help center you want to edit, select … at the top right.
Select Customise look and feel. The help center opens.
Select Customise at the top right, and from the dropdown, select Manage topics and portals.
On the Manage topics and portals page, select the star icon next to a portal to feature it on the home page.
Reorder portals in the featured section using drag and drop.
Sort the remaining portals by popularity or name.
If you sort by popularity, portals are displayed from most popular to least popular. Popularity is calculated based on average daily portal requests in the last 90 days.
If you sort by name, portals are displayed in alphabetical order.
Select Publish layout to make your changes visible in the help center.
Select Cancel to discard your changes and revert to the last published version of the home page layout.
Once you publish the layout, featured portals will be prominently displayed on the home page, followed by the remaining portals sorted based on your choice. New portals that are added to your Jira Service Management site will be automatically sorted based on your selection in the Manage topics and portals page.
Your customers will only see portals they have permission to view. Read more about managing customer permissions.
Was this helpful?