Assign Context Keys
To use this feature of Scroll Documents you will need to install Scroll Viewport first. Trial the app for free for 30 days.
When publishing your documents to a Scroll Viewport help center site, assigning context keys to pages enables you to generate stable links to your articles that can be used for context-sensitive help links in your product.
The more content grows in scope, the more likely it is to change over time. Restructuring content within the document might require content that was previously on one page to be broken up into several or vice versa. As a result, public Scroll Viewport links that have been shared previously in various contexts might no longer point to the correct content after it was restructured.
Context keys address this problem by allowing to add a unique identifier for your page that you can share with readers or embed in your product, and reassign it later if you need it to point to a different page.
Assign and Append Context Keys
Context keys are created in the Document Manager and are valid for all versions of a given page.
You need to update your Viewport site for new or updated context keys to take effect.
Navigate to Manage Context Keys
To start managing context keys, navigate to the space where your document is located and find the document in your document library:
Click on the document card to navigate to the Document Manager.
In the Document Manager, click Manage.
Select Context Keys.
You are now in the Manage Context Keys section of your document from where you can create new keys and assign them to the pages of your document.
Create and edit keys
A context key can be assigned to any existing page of your document. It will apply to all version of the selected page. A page can be assigned to multiple context keys but a Context key can only be applied to one page (in all its versions).
To assign a new key to a page:
Select the Add new key button in the top right corner.
Click on the Page field and select the page you want to assign a Context key to. To find your page, use the dropdown menu or type the title of a page of your document.
In the Key field, type the key you want to assign.
Keep in mind: Acceptable characters are "a-Z", "0-9", "_", "-", "+"
You can now overview the created context keys and see which versions of the page the key will apply to. The key will list all existing versions of your document, except those where the particular page doesn’t exist.
You can modify which page your key applies to at any point. To edit the assigned pages, find your context key in the list:
Select More actions (•••).
Click on the Page field and select the page you want to assign the context key to. To find your page, use the dropdown menu or type the title of a page of your document.
Append context key Parameters to build a Viewport link
To learn more about how to generate and use context to your pages published to Scroll Viewport, please refer to the Scroll Viewport article on Generating Stable Links with Context Keys.