Scroll Viewport uses the pages and page tree of your space or Scroll Document to define articles pages and an article navigation for your site.

All the pages in your space or Scroll Document (except your space overview page or document root page) are transformed into article pages, like the one below:

article page on a live Viewport site

  • Your Confluence page title will be your article title.

  • Your top-level parent pages will additionally show as topics on your content source page.

  • Your space’s or document’s page tree will show as an expandable article navigation on the left sidebar of article pages.

  • You can further customize the appearance of your articles using the theme editor.

To change the order of articles and topics, move pages within your page tree in Confluence.

To add new articles and topics use the page Create option in Confluence. Edit article content using the Confluence Cloud editor.

Using the Confluence editor

Open the Confluence editor to add and edit content on new or existing articles. Click Publish when you are done.

Your content updates will not appear immediately on your Viewport site. We recommend reviewing your content with the help of the article preview. Once checked, update your site to go live with changes.

When using the Confluence editor, please note the following:

  • We recommend enhancing content on articles with editor features and macros – but not all macros are supported yet. Please refer to our list of Supported Macros and Features for an overview of macros that will work on your Viewport site.

  • Confluence pages of the type Blog posts are currently not supported.

  • By default, images are displayed in their original image size but are scaled smaller if they exceed the width of the article content column and/or a maximum height of 1000px. Learn how to Resize and Align Images.

Creating theme-optimized content

The following tips help you optimize your content for display on a Scroll Viewport site with the Help Center theme.

Use formatting, especially headings H2-H4.

Format your text to increase readability and navigability of content. Make use of headings to structure articles and help users navigate the content.

If you enable the table of content option for articles in the theme editor, Viewport will automatically generate a structured list of links pointing to all headings styled H2 - H4 on the article.

We recommend you do not use headings in H1 style. In the Help Center theme, your article titles will display in the (HTML) Heading 1 style. If you format your headings as H1s in the Confluence editor you will end up with more than one H1 tags on your article page.

Display a list of children on topic pages.

Add the children display macro to parent pages to help your users overview the content of a specific topic. Viewport overrides the Confluence view of the macro to generate a nice-looking and themed output.

Define meta descriptions for articles.

By default, Viewport uses the first 150 characters of your Confluence page to define meta description for your site’s pages. Meta descriptions are used by search engines to create short descriptions of your pages.

To improve how search engines rank and index your site's articles, we recommend optimising descriptions with the excerpt macro. Add the macro to all pages and set it to ‘hidden’ if you don’t want the content to be part of the article itself. The description limit is 165 characters.

Name files and add image alt-texts.

Make sure your images have meaningful file names. Check and edit file names from the Confluence Attachments page. When inserting an image in the editor, include an alt-text as an image description (useful for users with visual limitations who use screen readers).

Insert links to other articles.

Add links to other articles in your help center to help users find relevant or related content. Select Link from the editor toolbar and use the search bar to find the right page in your space or document.

Inserting links via page search will ensure that they remain stable even if you re-name or move pages around (as long as they remain in the same space or document).