# Libs.version.toml documentation confusion

**URL:** <https://discuss.gradle.org/t/libs-version-toml-documentation-confusion/52056>\
**Category:** Help/Discuss\
**Created:** [May 22, 2026, 1:15pm UTC](https://discuss.gradle.org/t/libs-version-toml-documentation-confusion/52056 "2026-05-22T13:15:03Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![Martin\_d\_Anjou](https://sea1.discourse-cdn.com/gradle/user_avatar/discuss.gradle.org/martin_d_anjou/32/5248_2.png) [@Martin\_d\_Anjou](https://discuss.gradle.org/u/Martin_d_Anjou)\
**Post date:** [May 22, 2026, 1:15pm UTC](https://discuss.gradle.org/t/libs-version-toml-documentation-confusion/52056/1 "2026-05-22T13:15:03Z")

</div>

On this page [Structuring Multi-Project Builds](https://docs.gradle.org/current/userguide/multi_project_builds_intermediate.html#sec:project_structure) the diagram shows a `libs.version.toml` file at the top of the git repository.

On this other page [Version Catalogs](https://docs.gradle.org/current/userguide/version_catalogs.html), the `libs.version.toml` file is under the `gradle/` folder.

Isn’t that confusing a little?

---

<div class="post-metadata">

**Author:** ![Vampire](https://sea1.discourse-cdn.com/gradle/user_avatar/discuss.gradle.org/vampire/32/9082_2.png) [@Vampire](https://discuss.gradle.org/u/Vampire)\
**Post date:** [May 23, 2026, 10:24am UTC](https://discuss.gradle.org/t/libs-version-toml-documentation-confusion/52056/2 "2026-05-23T10:24:48Z")

</div>

I would say the image does not show paths at all, but logical structure, showing that you have one version catalog in the root project level.

I’d say the main problem is, that in the directory structure right below the graphic, the version catalog is missing where the path to it would then be specified. That would hopefully clear up the confusion.

Besides that those graphics are wrong anyway. For example they call `buildSrc` a sub-project which it is not. It is a separate build that behaves to great lengths like an included build, but it is neither an included build, nor a sub-project.