Configure versions

This is the default configuration:

versions:
  v1.0.0:
    weight: 0

[versions]
  [versions.'v1.0.0']
    weight = 0

{
   "versions": {
      "v1.0.0": {
         "weight": 0
      }
   }
}

Base settings

Configure the following base settings:

defaultContentVersion: v1.0.0
defaultContentVersionInSubdir: false

defaultContentVersion = 'v1.0.0'
defaultContentVersionInSubdir = false

{
   "defaultContentVersion": "v1.0.0",
   "defaultContentVersionInSubdir": false
}

defaultContentVersion

(string) The project’s default version. When one or more versions are defined, this value must match one of the defined version names.

defaultContentVersionInSubdir

(bool) Whether to publish the default content version to a subdirectory matching the defaultContentVersion. Default is false.

Version settings

Use the following setting to define how Hugo orders versions.

weight

(int) The version weight. When set to a non-zero value, this is the primary sort criteria for this version.

Sort order

Hugo sorts versions by weight in ascending order, then by their semantic version in descending order. This affects build order and complement selection.

Example

The following configuration demonstrates how to define multiple versions with specific weights.

versions:
  v1.0.0:
    weight: 20
  v2.0.0:
    weight: 10

[versions]
  [versions.'v1.0.0']
    weight = 20
  [versions.'v2.0.0']
    weight = 10

{
   "versions": {
      "v1.0.0": {
         "weight": 20
      },
      "v2.0.0": {
         "weight": 10
      }
   }
}