Edit the home page layout in a help center

Editing the home page layout 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 layout in your help center.

To edit the layout and content in your help center, you can:

• Create and manage topics

• Feature and sort portals

• Add rich content to the home page [in BETA]

• Hide and reorder sections in the home page [in BETA]

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. You can create and manage topics, 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.

Add rich content to the home page

To add images, texts, links and other rich content to your help center 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 Edit page layout.

5. Hover between sections in the home page and select Add rich content.

6. From the editor that opens up, you can add text, images, links, emojis, tables and other elements here.

7. Once you’re done customising the content, select Publish layout to make the changes you made show up on the help center.

Rich content you can add to your home page

You can add rich content to your home page directly from the editor or by using slash commands.

Layouts

Layouts allow you to organize your content into columns and sections, making it easier to present information in a structured and visually appealing manner.

There are six different column layouts available in the editor. To add a layout, select the Layouts icon () from the editor. By default, a two-column layout gets added to your home page. You can easily switch between the options.

Content doesn't get lost when you change the column layout; additional columns are added to the right, and when you change to a layout with fewer columns, the content moves to the left.

Text

You can add text and format it as normal text or you can assign up to six levels of headings to it. You can also add emphasis to your text with formatting such as italics, bold, underline as well as text color and alignment. 

You can also create bulleted and numbered lists.

Images, videos, emojis

Add an image, video or GIF by selecting the Image icon or by typing the slash command /image. You can also drag and drop images from your computer directly into the editor.

Resize images and videos by dragging the handles on their sides. Media will proportionally grow or shrink based on how much you drag the mouse in and out. When you select an uploaded image or video, a floating toolbar appears. You can use this toolbar to align the image, add links to it and add alt text.

Adding links to images to turn them into clickable elements that can help users navigate to different relevant pages. Alt text will help ensure that your content is accessible to screen reader users.

Select the emoji icon on the editor or type /emoji to quickly add this element from the slash command. 

Expand

Create a collapsed section that reveals more information for the people who seek it. This is particularly useful for creating FAQs or sections that contain a lot of information, as it helps in compressing content and improving the overall user experience. To add an expand, select the plus icon on the editor toolbar and choose Expand or type /expand to quickly add this element from the slash command. 

Date

Make a date stand out with grey background; the default date format is Mon DD, YYYY. To add a date, select the plus icon on the editor toolbar and choose Date or type // to bring up a date picker.

Divider

Separate sections of text using a horizontal line. To add a divider, select the plus icon on the editor toolbar and choose Divider or type /divider to quickly add this element from the slash command.

Panel

Emphasize information by choosing a preset panel type to consistently communicate ideas like info, note, error, success, and warning.  To add an info panel, select the info icon on the editor toolbar or type /panel to quickly see the options and add this element from the slash command. 

Quote

Emphasize a quote by adding a vertical line on its left margin and adjusting the font color. To add a quote, select the plus icon on the editor toolbar and choose Quote or type /quote to quickly add this element from the slash command.

Status

Highlight text to stand out on the page and choose a background color that fits its meaning. To add a status, select the plus icon on the editor toolbar and choose Status or type /status to quickly add this element from the slash command.

Hide and reorder sections in the home page

To hide and reorder sections in the 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 Edit page layout.

5. Hover over any section in the help center to see the Hide button on the top right.

6. To show a hidden section, hover over it and select Show on the top right.

7. To reorder a section, hover over it and drag and drop it to your preferred position.

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