Changelog Management
Time to read: 5 minutes
Keep your users informed about product updates with a public changelog. The Pro addon lets you assign changelog entries to specific products, filter them on the frontend, and manage everything from the WordPress admin.
What You’ll Learn
- How changelog entries work with multiple products
- Assigning entries to products
- Displaying product-specific changelogs on your site
- Managing changelog entries in the admin
- What your visitors see on the frontend
What Users See on the Frontend
When you display a changelog using the [roadmap_changelog] shortcode, your visitors see a clean, organized list of releases. Each version appears as a card with:
- Version header — The release version number (e.g., “2.5.0”) displayed prominently
- Release date — Formatted date shown below the version
- Change items — Each change listed with a colored badge indicating its type
- Type badges — Color-coded labels (“New Feature” in green, “Bug Fix” in red, “Enhancement” in blue, etc.)
Entries are sorted by release date, newest first. If you filter by product, only that product’s entries appear.
For a complete walkthrough on creating your changelog page, see Setting Up Your Changelog Page.
Assigning Entries to Products
Single Entry
When editing a changelog entry:
- Open any entry under Roadmap > Changelog
- Find the Changelog Product box in the sidebar
- Select a product from the dropdown
- Click Update
Each entry belongs to one product at a time.
Bulk Assignment
Assign multiple entries at once:
- Go to Roadmap > Changelog
- Select entries using checkboxes
- Open the Bulk Actions dropdown
- Choose Assign to: [Product Name]
- Click Apply
All selected entries move to that product.
Managing Changelog in Admin
Product Column
The changelog list table includes a Product column showing which product each entry belongs to. Click the column header to sort by product.
Filtering by Product
- Go to Roadmap > Changelog
- Use the Filter by Product dropdown above the list
- Select a product
- Click Filter
The list updates to show only entries for that product.
Displaying Changelogs on Your Site
Show All Changelogs
Add this shortcode to any page:
[roadmap_changelog]Show Product-Specific Changelog
Filter by product slug:
[roadmap_changelog product="mobile-app"]Show a Specific Version
[roadmap_changelog version="2.0.0"]Available Shortcode Options
| Option | Description | Example |
|---|---|---|
product | Show entries for a specific product | product="mobile-app" |
version | Show a specific version only | version="2.0.0" |
id | Show a single entry by its ID | id="456" |
Change Types
Each change in an entry is tagged with a type that appears as a colored badge:
| Type | What It Means |
|---|---|
| New Feature | A brand new capability |
| Enhancement | An improvement to something existing |
| Bug Fix | A problem that was resolved |
| Security | A security-related update |
| Update | A general update or maintenance |
| Deprecated | Something being phased out |
| Breaking Change | A change that may require action |
Troubleshooting
Product dropdown is empty
- Verify products exist under Roadmap > Products
- You need at least one product created before you can assign entries
Bulk assignment not working
- Make sure you selected entries before clicking Apply
- Check that products exist under Roadmap > Products
Shortcode not filtering by product
- Use the product slug (e.g.,
mobile-app), not the display name - Clear any caching plugins after changing shortcodes
For developer API endpoints, see the REST API Reference.
Next Steps
- Setting Up Your Changelog Page – Step-by-step page creation
- Multi-Product Management – Set up products for your roadmap
- Analytics Dashboard – Track engagement per product
← Analytics Dashboard | Settings & Configuration →