WPackagist Changelog Action

Automatically comment WordPress plugin changelogs on pull requests when WPackagist dependencies change in your composer.lock or composer.json files.

Support us

We're dedicated to pushing modern WordPress development forward through our open source projects, and we need your support to keep building. You can support our work by purchasing Radicle, our recommended WordPress stack, or by sponsoring us on GitHub. Every contribution directly helps us create better tools for the WordPress ecosystem.

Features

• Detects changes to WPackagist plugins in both composer.lock and composer.json
• Fetches changelogs from WordPress.org API
• Warns about unstable versions when installed version > WP.org's stable tag for the plugin

Usage

Basic Setup

Create a workflow file in your repository (e.g., .github/workflows/wpackagist-changelog.yml):

name: WPackagist Changelog

on:
  pull_request:
    paths:
      - 'composer.lock'
      - 'composer.json'

jobs:
  changelog:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - name: Comment changelogs on PR
        uses: roots/wpackagist-changelog-action@v1

Example Comment

The action creates a formatted comment like this:

🔌 WordPress Plugin Changelogs

woocommerce (v10.2.0)

⚠️ Warning: Installing version 10.2.0 but stable tag is 10.1.2. This may be an unstable version. Learn more

View changelog

10.2.2 2025-09-29

WooCommerce

• Fix - Check if template part is from file system before building the result from file #61171
• Fix - Fix low-resolution images displayed in the Classic Template block gallery #61182
• Fix - Make legacy gallery filters available while rendering blocks #61173

View full changelog on WordPress.org

Community

Keep track of development and community news.

• Join us on Discord by sponsoring us on GitHub
• Join us on Roots Discourse
• Follow @rootswp on Twitter
• Follow the Roots Blog
• Subscribe to the Roots Newsletter