1. Component Guide
  2. Step by step navigation
  3. Tracking the user journey through the query string
Step by step navigation example

Tracking the user journey through the query string

When the step by step pattern was first introduced, one of the problems we noticed was that if a content page is in more than one step by step journey, it wasn’t practical to expand all of the step by steps, as the sidebar became very long.

We solved this problem in a few ways:

  1. Only show a list of titles for the step by steps that the content page is part of.
  2. Only display this list if the content item is part of fewer than 5 step by step journeys
  3. Allow content designers to optionally hide a step by step journey on content pages.

The consequence of this is that if users land on any of these pages, they lose sight of the journey they are on, and which step of the journey they have reached (the black dot).

The solution is to track the step by step journey the user is on.

This has been achieved by adding a query string to all of the internal links in the step by step that contains the content_id of the step by step.

For example, if the step by step contains a link to /check-uk-visa, the component will render the link as /check-uk-visa?step-by-step-nav=d8f3c2e0-d544-4664-9616-ab71323e4d18

As long as the user follows the links in the step by step (and not the inline links in the content), the component will know which step by step journey the user is on.

If the content item is part of multiple step by steps, the component fetches the content_id of the active step by step from the query string and expands that one. The other step by steps that the content item is part of are displayed as a list of titles under an “Also part of” heading.

Additionally, if content designers have chosen to “hide” a step by step on a content page, but we can see that the user is following a step by step journey (the content_id of the step by step is in the querystring), the step by step will still be displayed and expanded in the sidebar, and the other step by steps that the content item is part of, but content designers have chosen to hide will also be displayed as a list of titles under an “Also part of heading”.

In both cases, we never show more than 5 step by steps in the list.

If the user lands on the content page “cold”, i.e. from Google, and not from the step by step sidebar (or overview page), the original rules for the displaying the step by step sidebar will apply.

The rules are as follows:

  1. Content item is part of one step by step

    Expand the step by step in the sidebar

  2. Content item is part of multiple step by steps

    Show a list of step by steps under the “Part of” heading

  3. Step by step is marked as “hidden” for the content page

    Do not display the step by step

Changes to the rules when the user is on a step by step journey (the query string is in the url):

  1. Content item is part of one step by step

    No change, expand the step by step in the sidebar

  2. Content item is part of multiple step by steps

    Expand the step by step in the querystring

    Show a list of the other step by steps under an “Also part of” heading, if the content item is part of less than 5 step by step journeys

  3. Step by step is marked as “hidden” for the content page

    Expand the step by step in the querystring

    Show a list of the other step by steps (including other step by steps that have been marked as “hidden”) under an “Also part of” heading, if the content item is part of less than 5 step by step journeys

Changes to the rules when there is a secondary step by step linked:

  1. Content item is part of one step by step

    No change. Expand the step by step in the sidebar.

  2. Content item is part of multiple step by steps and no secondary step by step

    No change. Will show a list of primary step by steps under the “Part of” heading. Secondary step by steps will not be shown.

  3. User is on a step by step journey (the query string is in the url)

    No change. Active step by step will be expanded.

  4. Content item is part of multiple primary step by steps and a single secondary step by step

    No change. Show “Part of” step by steps list. Secondary step by step won’t be shown.

  5. Content item is part of multiple step by steps and multiple secondary step by steps

    No change. Show “Part of” step by step list. Secondary step by step won’t be shown.

  6. Step by step is marked as “hidden” for the content page

    No change. “Also part of” component will only show when an active step by step is shown.

  7. Content item is part of one secondary step by step and no other step by steps are linked.

    Show secondary step by step expanded.

  8. Content item is part of multiple secondary step by steps and no other step by steps are linked.

    Show secondary step by step list in “Part of” component.

How it looks (preview)

How to call this example

<%= render "govuk_publishing_components/components/step_by_step_nav", {
  tracking_id: "this-is-the-content-id",
  steps: [
    {
      title: "With query string",
      contents: [
        {
          type: "list",
          contents: [
            {
              href: "/component-guide/step_by_step_navigation/with_links/preview?step-by-step-nav=this-is-the-content-id",
              text: "This is an internal link with a query string"
            },
            {
              href: "http://google.com",
              text: "This is an external link without a query string"
            }
          ]
        }
      ]
    }
  ]
} %>