# Gradle 9 plugin alias version catalog bundle plugins block unresolved reference

Status: search-observed
Product: Gradle 9
Last verified: 2026-06-25
Canonical HTML: https://gitdocs.org/fix/gradle-9-plugin-alias-version-catalog-bundle-plugins-block-unresolved-reference
Machine JSON: https://gitdocs.org/api/fixes/gradle-9-plugin-alias-version-catalog-bundle-plugins-block-unresolved-reference.json

## Exact Symptom

See the observed Codex queries below.

## Diagnosis

The old package/config name is syntactically valid, but current tool packaging and discovery rules live in external release documentation.

## Fix

```
Verifier checks the current package identity/config format and a real transformed output.
```

## Avoid

- Changing local code without checking the current external contract.
- Retrying the same install, build, or API call with no version/source change.
- Applying a broad unsafe bypass when a narrow compatibility fix is available.

## Observed Codex Queries

- Gradle 9 plugin alias version catalog bundle plugins block unresolved reference
- site:docs.gradle.org version catalog bundles plugins block alias Gradle 9
- Gradle version catalog bundles plugins alias unresolved reference
- https://docs.gradle.org/current/userguide/version_catalogs.html
- '[bundles]' in https://docs.gradle.org/current/userguide/version_catalogs.html
- https://docs.gradle.org/current/userguide/upgrading_version_8.html
- https://docs.gradle.org/current/userguide/upgrading_major_version_9.html
- 'Removal of libraries and bundles from version catalogs in the plugins' in https://docs.gradle.org/current/userguide/upgrading_major_version_9.html

## Sources

- Upgrading to Gradle 9: https://docs.gradle.org/current/userguide/upgrading_major_version_9.html
- Official reference opened by Codex: https://docs.gradle.org/current/userguide/version_catalogs.html
- Official reference opened by Codex: https://docs.gradle.org/current/userguide/upgrading_version_8.html
- Official reference opened by Codex: https://docs.gradle.org/current/userguide/upgrading_major_version_9.html