We're updating our terminology in Jira

'Issue' is changing to 'work item'. You might notice some inconsistencies while this big change takes place.

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.

In the help center home page, you can:

Manage topics and portals

To manage topics and portals:

  1. Go to Settings () > Products > Jira Service Management > Configuration.

  2. In the Help center section, select View all help centers.

  3. Select the help center of your choice.

  4. Once in the help center, select Customize from the top navigation, and from the dropdown, select Manage topics and portals.

  5. Once you’re in the Manage topics and portals page, make necessary changes to the layout.

    1. You can create and manage topics, manage visibility of topics and portals, and feature and sort portals from here.

  6. 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.

Hide topics and portals from the home page

You may not to show all topics or portals on your site to your customers on your help center. Some of them may have sensitive information that shouldn’t be accessed by all customers.

Some topics or service projects may have been created for testing purposes or to evaluate certain features. Or, a topic may contain information that is seasonal in nature and needs to be shown only during a specific time period.

Admins and organizations may even want their customers to raise requests to certain service projects only via email. In such cases and more, it becomes helpful to hide these portals from your help centers.

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:

  1. Go to Settings () > Products > Jira Service Management > Configuration.

  2. In the Help center section, select View all help centers.

  3. Select the help center of your choice.

  4. Select the help center of your choice.

  5. Once in the help center, select Customize from the top navigation, and from the dropdown, select Manage topics and portals.

  6. 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.

  7. 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:

  1. Go to Settings () > Products > Jira Service Management > Configuration.

  2. In the Help center section, select View all help centers.

  3. Select the help center of your choice.

  4. Once in the help center, select Customize from the top navigation, and from the dropdown, select Topics and portals.

  5. Once you’re in the Manage topics and portals page, go to the Hidden section under Topics or Portals.

  6. 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.

  7. 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 portals:

  1. Go to Settings () > Products > Jira Service Management > Configuration.

  2. In the Help center section, select View all help centers.

  3. Select the help center of your choice.

  4. Once in the help center, select Customize from the top navigation, and from the dropdown, select Manage topics and portals.

  5. Once you’re in the Manage topics and portals page, select the star icon on your portal to feature it on your home page.

  6. You can also reorder your portals in the featured section using drag and drop.

  7. You can sort your remaining portals by popularity or name.

    • When sorted by popularity, portals are displayed from most popular to least popular. Popularity is calculated as the average daily requests created in a portal in the last 90 days.

    • When sorted by name, portals are displayed in the ascending order of their names.

  8. Select Publish layout to make the changes you made show up on the help center.

    • Select Cancel if you wish 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.

 

Still need help?

The Atlassian Community is here for you.