Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Packagist shows an old version

Diagnose why Packagist or composer require does not offer the newest release of a theme - a missing or failing hook, a tag Packagist could not read, a composer.json error, or a cached client - and fix each.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/designers/distribution/stale-packagist-version.md

On this page

Packagist shows an old version

This page is for designers whose new release does not appear on Packagist, or whose users still get an older version from composer require.

Diagnose in order

  1. Is the tag on the remote? git ls-remote --tags origin | grep v1.0.25. No output: push the tag.

  2. Does Packagist know it?

    curl -s https://repo.packagist.org/p2/yourvendor/mytheme.json | grep -o '"version":"[^"]*"' | head -3

    The new version missing: go to step 3. Present: go to step 5.

  3. Is there a hook? gh api repos/yourvendor/mytheme/hooks --jq '.[].config.url' lists a packagist.org URL. No hook is the most common cause: a package can stay on an old version for months without one. Set it up (Keeping Packagist up to date automatically) and press Update on the package page.

  4. Could Packagist read the tag? The package page shows errors from its last read. A broken composer.json in the tagged commit, or a version field that disagrees with the tag, makes Packagist skip that version. Fix it in the next release; never move the tag.

  5. Is the user's Composer cached or constrained?

    CheckCommand
    What the user's constraint allowscomposer why-not yourvendor/mytheme 1.0.25
    Clear Composer's cachecomposer clear-cache
    Which version is installedcomposer show yourvendor/mytheme

A table of causes

SymptomCauseFix
Packagist lists only dev-mainNo tag yetRelease a tag
Packagist months behindNo update hookAdd the hook, press Update
One version missing between otherscomposer.json invalid in that tagRelease the next version with it fixed
Packagist fine, user still oldConstraint or cachecomposer why-not, composer clear-cache

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x