Versioning#

Enable versioning in lore.yml:

versioning: true
defaultVersion: v2

Each top-level directory in your docs becomes a version:

docs/
  v1/
    index.mdx
    configuration.mdx
  v2/
    index.mdx
    configuration.mdx

Lore adds a version switcher to the header. The defaultVersion is the one shown when visiting the site without a version in the URL — navigating to / redirects to /<defaultVersion>/.

With Internationalization#

If internationalization is also enabled, version directories are nested inside locale directories:

docs/
  en/
    v1/
    v2/
  fr/
    v1/
    v2/

See Internationalization.