Create a walkthrough

Configuration

  1. Navigate to the Walkthroughs application and select New walkthrough. You will be prompted to name the walkthrough and select a save location.

Create a new walkthrough.

  1. Next, enter the walkthrough editor to configure the walkthrough contents.

Configure a walkthrough.

  1. Fill out the Name field to provide a title for your walkthrough.
  2. Enter a brief description in the Description field.

Note: Both the name and description will appear in the Walkthroughs landing page, and can help users determine the appropriate walkthroughs to complete.

  1. Optionally customize the walkthrough icon by selecting Customize icon, or by uploading a custom image.
  2. Optionally enable the Documentation toggle to show a dedicated overview panel for displaying long-form walkthrough details using Markdown.

Add steps

The primary elements in a walkthrough are called steps. Each step should include a thorough description of the actions that users should perform. You can optionally include links to related resources, or add documentation in the Documentation configuration during setup. This will be discoverable through the Learn more option during the walkthrough. We recommend only adding a single resource to a given step to streamline end-user experience. To preview a walkthrough, select Preview on the top right at any time.

  1. In the Steps section, select Click to add new step. A new panel will appear on the right side of the screen for step configuration.
  2. Provide a name and description for the step.
  3. Add associated resources by selecting the Add resource dropdown menu and selecting the type of resource you want to add. Added resources will open in the same window.

Add Steps to your walkthrough.

Publish your walkthrough

  1. Select the Preview option to test the rendering and readability of your content.
  2. Select Save.
  3. When you are ready to make your walkthrough discoverable to users with access, select Publish.

Walkthrough translations

To translate a walkthrough, select the language dropdown menu.

Select to translate from language dropdown menu.

You can manually input translations, or use AIP to generate suggested translations for each description in the walkthrough.

Configure translation with helper.