Skip to main content
Skip table of contents

How Does Scroll Sites Construct URLs?

Sites published with Scroll Sites use human-readable and SEO-friendly URLs that can be customized.

URLs for Space Content Sources

For a space content source the URL is constructed as follows:

https:// your-company . scroll-sites.com / site-path / content-source / content

The URL consists of the following paths:

  • Subdomain, e.g. your-company: This URL path is a unique string of URL-safe characters. It is chosen upon site creation and can be changed in Site settings.

  • Domain, e.g scrollhelp.site: By default, all Scroll sites carry this path in their URL. You can also choose to Connect a Custom Domain .

  • Site path: Optionally, you can add a site path. This will let you host multiple Scroll sites under the same subdomain.

  • Content source path: This path is a string of URL-safe characters and must be unique per site. By default it is set to the space key or document title but can be specified when the content source is added to the site and modified anytime after.

  • Content path: By default, this part is derived from a URL-safe version of the Confluence page title. The default path is set when the page is first added to a Scroll site and does not change when the Confluence page title changes. To ensure this stability, make sure that Scroll Sites has view and edit permissions for the page(s) or set a custom article path manually.

What URL-safe characters are allowed for the article segment?

Scroll Sites will only allow the following URL-safe characters in the content path of the published URL:

  • alphanumeric characters:

    • 0 1 2 3 4 5 6 7 8 9

    • a b c d e f g h I j k l m n o p q r s t u v w x y z

  • the following special characters:

    • -

    • _

    • .

If any other special characters are present in the page title (like ß or ?), then Scroll Sites will omit them completely in the published URL or in the cases of accented characters, fall back to the “base character” (e.g. ç will become c).

Please note that your URLs might also include a language-code before the content source path if your site includes Scroll Documents with enabled languages (see below).

URLs for Scroll Document Content Sources

For a Scroll Document content source your URLs will look at follows:

/ content-source / version / variant / article

  • The version path is always part of the URL for your document content sources, even if only one version is selected for the Scroll site.

  • The variant path is only part of the URL if the document has variants set up in Scroll Documents.

By default, the version and variant paths are set to the version name and variant name that you have defined in Scroll Documents. You can customize these values when adding and editing your content sources in Scroll Sites.

Additionally, a language-code will be added to the URL of all your content sources if languages are enabled for at least one of the site’s Scroll Document content sources.

The language code is added before the content source path:

/ language-code / content-source / version / variant / article

The language code can’t be customized.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.