Skip to content
Latchkey

Dependabot "couldn't find a compatible version" in CI

Dependabot evaluated the available releases and none fit every constraint your manifest and lockfile impose at once. This mirrors a resolver conflict: a shared dependency is capped below what the new version needs.

What this error means

The Dependabot tab shows "Dependabot couldn't find a compatible version" for a package, and it never appears as an update PR even though a newer release exists.

Dependabot
Dependabot couldn't find a compatible version of "django-storages".
Latest is 1.14.2 but it requires Django >= 4.2 while your project pins Django < 4.2.

Common causes

A cap in your manifest excludes the new release

You pin a shared dependency (a framework, a runtime) below the floor the new version requires, so no compatible release exists.

The ecosystem version constraint is too narrow

A runtime or engine constraint (Python range, Node engines) rules out every version that would otherwise satisfy the bump.

How to fix it

Raise the capping constraint first

  1. Read which base dependency the message names as the blocker.
  2. Bump that constraint to a range that admits the target version.
  3. Re-run "Check for updates" so Dependabot re-evaluates.
requirements.txt
# widen the cap so a compatible version exists
# requirements: Django>=4.2,<5.1

Group the framework bump with its plugins

Update the framework and its plugins together so the shared floor rises in one PR instead of blocking each package individually.

How to prevent it

  • Keep runtime and framework caps as loose as your code allows.
  • Upgrade a framework and its ecosystem plugins together.
  • Review Dependabot "couldn't find" notes to catch stuck caps early.

Frequently asked questions

What causes ""couldn't find ... a compatible version""?
You pin a shared dependency (a framework, a runtime) below the floor the new version requires, so no compatible release exists.
How do I fix "couldn't find ... a compatible version"?
Raise the capping constraint first

Related guides

References

Run this faster and cheaper on Latchkey managed runners - self-healing included. Start free → 30-day trial · No credit card