Beautiful layouts, email notifications, roadmap with voting, and Gutenberg blocks.
Sakurato Changelog is the most comprehensive changelog management plugin for WordPress. Create beautiful, organized changelogs with multiple display layouts, smart filtering, email notifications, public roadmap with voting, and native Gutenberg blocks.
📋 Sakurato Changelog Documentation
Complete guide to professional changelog management
🚀 Quick Start (5 Minutes)
Step 1: Create Your First Entry
- Go to Changelog → Add Entry
- Enter a Version (e.g., "1.0.0")
- Set the Release Date
- Choose a Change Type (Added, Fixed, etc.)
- Write your changelog content
- Click Publish
Step 2: Display on Your Website
Add this shortcode to any page, post, or widget:
[sakurato_changelog]✨ Features by Tier
🆓 Free Plan
- ✅ Unlimited changelog entries – no restrictions
- ✅ 1 Product – perfect for single-product sites
- ✅ Default Layout – clean, professional design
- ✅ 7 Change Types – Added, Changed, Fixed, Improved, Removed, Deprecated, Security
- ✅ Client-side Search – instant filtering
- ✅ Collapsible Sections – expand/collapse versions
- ✅ 5 Translations – EN, PL, ES, DE, FR
💎 Basic Pro
- ✅ Everything in Free +
- 🎨 5 Premium Layouts – Timeline, Compact, Detailed, Cards, Dark
- 🏢 Unlimited Products – manage multiple projects
- 🔍 Advanced Filters – filter by product, type, date range
- 📧 Email Support
🚀 Professional Recommended
- ✅ Everything in Basic Pro +
- 📧 Email Notifications – automated subscriber alerts
- 👥 Subscriber Management – dashboard with double opt-in
- 📥 Import/Export – JSON, CSV, Markdown formats
- 🗺️ Public Roadmap – share development plans
- 🗳️ Roadmap Voting – let users vote on features
- 🎯 Priority Support
🏢 Enterprise
- ✅ Everything in Professional +
- 🎨 White Label – complete rebranding
- 🧱 3 Gutenberg Blocks – Changelog, Roadmap, Subscription
- 📦 3 Classic Widgets – sidebar widgets
- 🎯 Priority Support
🎨 Display Layouts
Choose from 6 professionally designed layouts to match your brand:
Default Free
Clean, professional layout with collapsible sections. Perfect for documentation sites.
layout="default"
Timeline Pro
Visual chronological display with alternating sides. Great for storytelling.
layout="timeline"
Compact Pro
Space-efficient one-line entries. Ideal for sidebars.
layout="compact"
Detailed Pro
Documentation-style with rich formatting. Best for comprehensive release notes.
layout="detailed"
Cards Pro
Modern grid layout with hover effects. Eye-catching and interactive.
layout="cards"
Dark Mode Pro
Dark-themed design for modern interfaces. Reduces eye strain.
layout="dark"
⚡ Shortcode Reference
Changelog Shortcode
Display your changelog with customizable options:
[sakurato_changelog layout="default" limit="-1"]Available Parameters:
| Parameter | Options | Default | Description |
|---|---|---|---|
layout |
default, timeline, compact, detailed, cards, dark | default | Visual style |
product |
Product slug | (empty) | Filter by product |
limit |
Number or -1 | -1 | Max entries (-1 = all) |
search |
true, false | true | Show search box |
collapsible |
true, false | false | Enable expand/collapse |
Examples:
// Basic changelog with search
[sakurato_changelog]
// Timeline layout, last 10 entries
[sakurato_changelog layout="timeline" limit="10"]
// Collapsible, only latest open
[sakurato_changelog collapsible="true" default_open="latest"]
// Filter by product
[sakurato_changelog product="my-app"]Subscription Form Professional
[sakurato_changelog_subscribe title="Get Updates"]Roadmap Professional
[sakurato_roadmap show_voting="true"]📧 Email Notifications Professional
How It Works
- Users Subscribe – Enter email and choose frequency
- Double Opt-in – Confirmation email sent (GDPR compliant)
- Auto Notify – Subscribers receive emails when you publish
Configuration
Go to Changelog → Settings → Email to configure:
- Enable/Disable – Master switch for notifications
- From Name & Email – Customize sender info
- Email Footer – Add custom text
- Test Email – Verify configuration
Notification Frequencies
| Frequency | When Sent | Best For |
|---|---|---|
| Instant | Immediately on publish | Critical updates, security fixes |
| Daily Digest | Once per day (8 AM) | Active development |
| Weekly Digest | Once per week (Monday) | Stable products |
📥 Import & Export Professional
Backup your changelog or migrate from other systems with 3 formats:
JSON
Full data with metadata. Best for backups.
CSV
Spreadsheet compatible. Great for Excel/Sheets.
Markdown
Keep a Changelog format. Perfect for Git.
How to Export
- Go to Changelog → Settings → Import/Export
- Choose format (JSON, CSV, or Markdown)
- Optionally filter by product
- Click Download Export
How to Import
- Prepare your file (JSON, CSV, or Markdown)
- Go to Changelog → Settings → Import/Export
- Select import format
- Upload file (max 10MB)
- Enable "Skip Existing" to avoid duplicates
- Click Start Import
🗺️ Public Roadmap Professional
What is the Roadmap?
Share your development plans and let users vote on features. No login required!
Roadmap Statuses
| Status | Value | Description |
|---|---|---|
| 🔍 Under Review | under_review |
Evaluating feasibility |
| 📋 Planned | planned |
Scheduled for development |
| 🚧 In Progress | in_progress |
Currently developing |
| ✅ Completed | completed |
Released and live |
Display Options
// Basic roadmap
[sakurato_roadmap]
// Kanban board view
[sakurato_roadmap layout="kanban"]
// Show only active items
[sakurato_roadmap show_status="planned,in_progress"]
// Read-only (no voting)
[sakurato_roadmap show_voting="false"]How Voting Works
- One vote per person – Tracked by user ID or cookie
- No login required – Maximizes engagement
- Anonymous voting – Privacy-focused
- Real-time updates – Vote counts update instantly
🔧 Troubleshooting
Changelog Not Displaying
Solutions:
- Verify you have published entries (not drafts)
- Check product filter - remove parameter if needed
- Clear your site cache
- Check browser console for errors
Email Notifications Not Sending
Solutions:
- Check master switch is enabled
- Send test email to verify SMTP
- Verify subscriber status is "Active"
- Check "From Email" is valid
- Review email queue for errors
Premium Layouts Not Working
Solutions:
- Verify plan at Changelog → Account
- Ensure license is activated
- Try deactivating and reactivating plugin
❓ FAQ
Is the free version fully functional?
Yes! The free version includes unlimited entries, search, collapsible sections, and the default layout.
Do I need coding skills?
No! The plugin includes an interactive shortcode builder that generates code for you.
Does it work with page builders?
Yes! Works with Elementor, Beaver Builder, Divi, Gutenberg, and all major builders.
How do email notifications work?
Users subscribe via form, confirm email (double opt-in), then receive notifications when you publish. They choose frequency: instant, daily, or weekly.
Is roadmap voting anonymous?
Yes! Users don't need to log in. One vote per person per item.
Can I import existing changelogs?
Yes! Professional plan includes import from JSON, CSV, and Markdown formats.
What's the difference between plans?
- Free: 1 product, default layout
- Basic Pro: Unlimited products, 5 layouts
- Professional: Email, import/export, roadmap
- Enterprise: White label, blocks, analytics