# Update to OpenUSD's crate/usdc versioning support

**URL:** <https://forum.aousd.org/t/update-to-openusds-crate-usdc-versioning-support/2342>\
**Category:** Announcements\
**Created:** [March 29, 2025, 12:59am UTC](https://forum.aousd.org/t/update-to-openusds-crate-usdc-versioning-support/2342 "2025-03-29T00:59:31Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![spiff](https://sea2.discourse-cdn.com/flex016/user_avatar/forum.aousd.org/spiff/32/22_2.png) [@spiff](https://forum.aousd.org/u/spiff)\
**Post date:** [March 29, 2025, 12:59am UTC](https://forum.aousd.org/t/update-to-openusds-crate-usdc-versioning-support/2342/1 "2025-03-29T00:59:31Z")

</div>

Hi all,  
In working with the AOUSD’s core Spec group and TAC, and Pixar’s desire to retire some (quite old now) technical debt, we’d like to adopt the following policy - please holler if you have concerns!

1. Moving forward, crate version 0.8.0 (the introduction of list-editable payloads) will be the **minimum** supported version, for both OpenUSD and the forthcoming USD spec.
2. Version 0.8.0 will be (as of the next release) the default version authored to crate files, bumped up automatically per-file whenever newer features are used.
3. OpenUSD will retain support for 0.8.0 onward, for archival purposes, for the foreseeable future.
4. At some point soon, we will remove support for earlier than 0.8.0 versions from OpenUSD. 0.8.0 was released in 2018.

You will retain the ability to specify a different (higher) default version by setting the `USD_WRITE_NEW_USDC_FILES_AS_VERSION` env var.

Thank you!

---

<div class="post-metadata">

**Author:** ![deadpin](https://avatars.discourse-cdn.com/v4/letter/d/43a26b/32.png) [@deadpin](https://forum.aousd.org/u/deadpin)\
**Post date:** [March 29, 2025, 9:14am UTC](https://forum.aousd.org/t/update-to-openusds-crate-usdc-versioning-support/2342/2 "2025-03-29T09:14:58Z")

</div>

Related to point 2, wasn’t the default crate version already bumped to 9.0[1] and then to 10.0[2] recently?  
[1] [Update default USD Crate format to 0.9.0 by dgovil · Pull Request #2838 · PixarAnimationStudios/OpenUSD · GitHub](https://github.com/PixarAnimationStudios/OpenUSD/pull/2838)  
[2] [Blaming OpenUSD/pxr/usd/usd/crateFile.cpp at release · PixarAnimationStudios/OpenUSD · GitHub](https://github.com/PixarAnimationStudios/OpenUSD/blame/release/pxr/usd/usd/crateFile.cpp#L105)

FWIW, that 10.0 bump is very aggressive and we’ve patched that locally back to 9 as the env. var. escape hatch is too onerous for users.

But pre-8 versions can easily go away.

---

<div class="post-metadata">

**Author:** ![spiff](https://sea2.discourse-cdn.com/flex016/user_avatar/forum.aousd.org/spiff/32/22_2.png) [@spiff](https://forum.aousd.org/u/spiff)\
**Post date:** [March 31, 2025, 5:14pm UTC](https://forum.aousd.org/t/update-to-openusds-crate-usdc-versioning-support/2342/3 "2025-03-31T17:14:00Z")

</div>

Correct on both counts, @deadpin … what we’re saying is, we acknowledge those bumps were more aggressive than they needed to be, and we’re going **back** to 0.8.0 to align with the language that will be in the AOUSD USD specification.

Cheers!

---

<div class="post-metadata">

**Author:** ![asluk](https://sea2.discourse-cdn.com/flex016/user_avatar/forum.aousd.org/asluk/32/771_2.png) [@asluk](https://forum.aousd.org/u/asluk)\
**Post date:** [April 1, 2025, 5:29pm UTC](https://forum.aousd.org/t/update-to-openusds-crate-usdc-versioning-support/2342/4 "2025-04-01T17:29:15Z")

</div>

> Version 0.8.0 will be (as of the next release) the default version authored to crate files, bumped up automatically per-file whenever newer features are used.

Thanks @spiff – so we’ll see [OpenUSD/pxr/usd/usd/crateFile.cpp at dev · PixarAnimationStudios/OpenUSD · GitHub](https://github.com/PixarAnimationStudios/OpenUSD/blob/dev/pxr/usd/usd/crateFile.cpp#L105) set back to 0.8.0 in OpenUSD v25.05 ? 🙏🏼

---

<div class="post-metadata">

**Author:** ![spiff](https://sea2.discourse-cdn.com/flex016/user_avatar/forum.aousd.org/spiff/32/22_2.png) [@spiff](https://forum.aousd.org/u/spiff)\
**Post date:** [April 2, 2025, 12:11am UTC](https://forum.aousd.org/t/update-to-openusds-crate-usdc-versioning-support/2342/5 "2025-04-02T00:11:11Z")

</div>

That’s right, @asluk - the change went in today.
