Versioning

Build separate versions

Setup

1. Structure your docs with version folders (e.g., v1, v2)
2. Add versions to mint.json: "versions": ["v2", "v1"] (first version is default)

Implementation

Groups and Pages

Add versions to groups in navigation or individual pages:

Tabs and Anchors

Control version visibility in navigation:

mint.json

"tabs": [
  {
    "name": "API Reference V1",
    "url": "v1/api-reference",
    "version": "v1"
  }
]

• Content without a version appears in all versions
• Page versions override group versions
• Avoid nesting versioned groups

Troubleshooting

Pages Show Up In Wrong Version

Check for conflicting nested versions between groups and pages.

Missing Pages

Verify version names match exactly with those in mint.json.