Creating Versions
Versions allow you to organize and manage different iterations of your documentation knowledge base. Each version can contain its own set of sources and operate independently.
Create a new version
- Navigate to your project in the sidebar
- Expand the Versions section
- Click New Version (or navigate to the Versions list and click the create button)
Fill in version details
The version creation form contains three fields:
Title
Enter a descriptive name for your version (e.g., "Version 2", "v2.0", "Beta Release")
Handle
This field is auto-generated from the title and becomes the URL-safe identifier for your version. It is read-only and uses lowercase letters with hyphens.
Description (optional)
Add a brief description to help you and your team understand what this version represents.
Complete version creation
Click Create Version to finalize the new version. The system will create the version and redirect you to its sources page, where you can begin adding content.
Version status badges
After creation, your version will display status badges:
- Published: The version is live and accessible to users
- Default: This version is the primary version served when no specific version is requested
New versions are unpublished by default. You can publish them from the version settings.