A WordPress plugin changelog page is a public page on your own site that lists every release with its version, date, and changes. The fastest way to build one is to add the Changeloger block to a page, paste or upload your changelog, and publish. For a broader overview, see our practical guide to displaying a changelog in WordPress.

This article is the plugin-focused version: where your plugin changelog page should live, which Changeloger display method fits each situation (block, tabs, shortcode, Release Hub, or embed), and how to keep the page useful after launch.

Why your plugin needs its own WordPress plugin changelog page

The WordPress.org Changelog tab is useful, but you do not control its design, and it only reaches people who are already on the plugin directory. A changelog page on your own site gives you more:

• A link to share: support can send one URL instead of pasting release details.
• Search visibility: people who search for your plugin’s updates land on your site.
• Trust: a dated, well-organized history shows the plugin is maintained.
• Brand control: your colors, your layout, your calls to action.

Build a WordPress plugin changelog page in five steps

1. Create a new page, such as /changelog/ or /plugin-name/changelog/.
2. Install and activate Changeloger Free, then add the Changeloger block.
3. Choose Add Changelog, then paste your text or upload a .txt file. You can also load the sample data first to see the layout.
4. Open the block sidebar and turn on the version sidebar, dates, and your brand’s tag colors.
5. Preview on mobile and desktop, then publish and link the page from your readme and menu.

Changeloger’s parser understands WordPress-style, traditional, and Markdown changelogs and sorts words like “added” or “hotfix” into the right category automatically.

Choose the right way to display your WordPress plugin changelog page

The Changeloger block for a single changelog

Best for one plugin with one changelog. The Free block includes a clickable version sidebar, optional dates, custom version links (Download, Docs, Release notes), and recolorable change tags. Pro adds a search box, category filter buttons, and pagination for long histories.

The Tabbed Changeloger block for several plugins

Selling more than one plugin, or keeping separate free and pro changelogs? The Tabbed block shows several changelogs in tabs, each with its own label. See the full walkthrough on multi-product changelogs with tabs.

The Release Hub block for releases, feedback, and roadmap

The Release Hub pulls releases you manage inside Changeloger and shows them with Feedback and Roadmap tabs. It is ideal when your changelog page should be your full product update home. Choose the product, rename tabs, and set releases per page. The Roadmap board is a Pro feature. Learn more in our Release Hub block guide.

Shortcode for sidebars, posts, and widgets

Need the changelog somewhere the block editor does not reach? Use the shortcode, for example

. A one-click Shortcode button in the admin generates it for you, and it works on any page, post, or widget area in the Free version.

Embed on another website (Pro)

With Pro you can generate an iframe or lightweight embed snippet to show your changelog on an external site, in light or dark theme, with an optional “Powered by Changeloger” badge.

Make the page work for plugin users and buyers

A WordPress plugin changelog page serves two audiences. Existing users want to know what changed and whether it is safe to update. Prospects want proof that the plugin is actively improved. Put the newest release at the top, keep the dates visible, and add a version link such as Docs or Release notes to releases that need more explanation.

Give the page a clear title and a one-sentence introduction that names your plugin and links to its download page. That small step helps both visitors and search engines understand what the page covers.

Pick a layout that fits your plugin changelog page

Free includes the classic Stack layout and the tighter Compact layout. Pro adds Rail, Ticker, and Mosaic. Set one globally or override it on a single block. Stack suits detailed release notes; Compact suits plugins with dozens of small releases.

Keep your WordPress plugin changelog page useful after launch

• Publish each new release in the same format, with a date and labels.
• Use the admin release builder with draft and publish, so you can prepare notes before launch day.
• Link to the page from your plugin readme, support docs, and update emails.
• Import older history once instead of retyping it. See how to import a plain text changelog.
• Automate the repetitive parts with WordPress release notes automation.

Want to compare options first? Read our guide to choosing a WordPress product changelog plugin, and check the Free vs Pro page for exactly what each plan includes.

Finally, test the page the way a visitor would. Open it on a phone, click a version in the sidebar, and expand a long release. If you can find the change you want in under ten seconds, your readers can too.

Frequently asked questions

Ready to launch your WordPress plugin changelog page? Install Changeloger Free from WordPress.org, add the block, and publish your first release today.