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

Roots is an independent open source org, supported only by developers like you. Your sponsorship funds WP Packages and the entire Roots ecosystem, and keeps them independent. Support us by purchasing Radicle or sponsoring us on GitHub — sponsors get access to our private Discord.

• Detects changes to WP Packages 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

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

name: WP Packages 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/wp-packages-changelog-action@v3

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.

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

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