> [!abstract] Summary > **HDA versioning** in Houdini — how to read and set an HDA's version, plus the **major.minor** convention used in this vault and the OSMIUM pipeline: **major** = breaking changes (incompatible parameters, hierarchy changes), **minor** = additive / non-breaking changes. --- # Show / Set HDA Version In the **Asset Manager** (or right-click on the HDA → **Type Properties**): ![[DoNOTDelete/Attachments/6.127 Houdini Asset version/Pasted image 20230620115558.png]] ![[DoNOTDelete/Attachments/6.127 Houdini Asset version/Pasted image 20230620115601.png]] --- # Versioning Convention Filename pattern (see [[../../../PROTOCOL/FOUNDATION/PROTOCOL Naming Convention|PROTOCOL Naming Convention]]): ``` XXX_[context]_nameOfHDA.<major>.<minor>.hdanc ``` Examples: - `OSM_lop_folderGenerator.1.0.hdanc` — initial release. - `OSM_lop_folderGenerator.1.1.hdanc` — added a parameter, fully backward-compatible. - `OSM_lop_folderGenerator.2.0.hdanc` — renamed parameters, breaks downstream scenes. ## Bump rules | Change type | Bump | |---|---| | Adding a new parameter with a default that preserves existing behaviour | **Minor** (`1.0 → 1.1`) | | Fixing a bug that doesn't change the API | **Minor** | | Renaming / removing parameters | **Major** (`1.x → 2.0`) | | Changing input/output structure | **Major** | | Changing internal hierarchy of subnet HDAs in a way users see | **Major** | > [!tip] Two HDAs side by side > When you ship a **major** bump, keep the old HDA installed alongside the new one so existing scenes still load. Artists can opt in to the new version when they're ready. --- # 🔗 Related - [[../HOUDINI MOC|HOUDINI MOC]]. - [[../HDA/HOUDINI HDA Render Stat display|Render Stat display HDA]]. - [[../SOLARIS/HDA/HOUDINI HDA SceneInspector|HDA — Scene Inspector]]. - [[../SOLARIS/HDA/HOUDINI HDA PythonPrinter|HDA — Python Printer]]. - [[../../../PROTOCOL/FOUNDATION/PROTOCOL Naming Convention|PROTOCOL Naming Convention]] — naming rules for HDAs. - [[../../../ARTFX OSMIUM/TOOLS/TOOLS MOC|OSMIUM TOOLS MOC]] — production HDAs.