Docs
← Back to site

Version Groups (linking related docs across versions)

2 min readUpdated October 29, 2026

When a product has versioning turned on, two notices already appear automatically on any doc that has a version assigned, even without doing anything else:

  • An older version banner, if the reader isn’t on the product’s latest version, linking them to that version.
  • An “Also available in” list of chips for every other version of the product.

Without any further setup, both of these link to the version itself (the product’s page for that version), not to a specific equivalent doc. Version groups upgrade this: they let you link a doc directly to its exact counterpart in another version, so those same notices take the reader straight to the matching doc instead of a general version landing page.

Linking a doc to its sibling in another version#

While editing a doc, find the Version Group panel in the sidebar:

  1. Type part of the sibling doc’s title into the search field.
  2. Click a matching result to link it.
The Version Group panel in the editor, listing the copies of this doc in other versions.

Once linked, that doc appears in a Linked sibling docs list in the same panel, showing its title and version. Repeat this for as many versions as you have equivalent docs for; a doc can be linked to more than one sibling (one per other version).

Unlinking#

Click the × next to a sibling in the Linked sibling docs list to remove just that one link. The other doc keeps its own links to any remaining siblings.

What changes once docs are linked#

An older version of a doc with the notice pointing to the latest version.
  • The version switcher (see The Version Picker & Cookie Persistence) takes the reader to the exact sibling doc when one exists for the version they’re switching to, instead of that version’s product page.
  • The “Also available in” chips link directly to each sibling doc.
  • The older version banner‘s “Switch to [latest]” link also goes to the exact sibling in the latest version, if one is linked.

For any version where no sibling has been linked yet, these all fall back to the generic version-landing behavior instead of a broken link.

Was this helpful?

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only