This section explains what the Content Source template is and which configurations can be made.

Definition

The space overview page (or in the case of a Scroll Document, the document root page) will be transformed into the overview page of a content source.

The content source template offers several different layout options as well as optional components. It can be styled with different layouts and can contain additional content, like a description of your content source.

Layouts

You can choose between three different layouts for your content source that will each give your help center a different look and feel. Here are the three options:

Hero Layout

The hero layout displays the space home page with a large hero banner that wraps the search bar. This layout looks similar to the the Portal Page and is particularly useful if you're only using one content source in your help center.

  • The banner wraps the space overview page title (or in the case of a Scroll Document, the document title), the excerpt macro text that is placed on the space overview or Scroll Document root page and a search bar with a background image.

Using custom images: Attach custom images to the overview page of your content spaces to select them in the attachment picker inside the theme editor. If you’re using a Scroll Document as a content source, upload the attachments to the root page of the working version of one of your added documents.

  • In the bottom part of the page, you can choose how you want users to navigate to the pages within the space. You can choose between the list view, tiles or the accordion menu which is shown in the example.

Detail Layout

The detail layout includes more information about the space and is particularly useful when using a multi-space help center in which every space is centered around a different product.

  • The banner isn’t as prominent as it is in the hero layout and only wraps the search bar.

  • Detailed information about the content source.

    • Logo. The image is taken from the space logo or document cover image that you have uploaded in Confluence.

    • Title. The title is taken from the space overview page title or document title.

    • Description. The description is taken from the space overview page or document root page (working version) in Confluence, specifically from the text you have added to an excerpt macro on those pages. If there is no excerpt macro but any other text included on the page, Viewport will take this text and cut it off after 160 characters.

  • In the bottom part of the page, you can choose how you want users to navigate to the pages within the space. You can choose between the list view, tiles, or the accordion menu which is shown in the example.

Article Layout

Choosing the article layout will display your content source overview as an article and for example reveals the content of your space overview page.