Changelogs
Changelogs keep your users informed about product updates, new features, and improvements. Display them as an in-app widget or a public changelog page.
How Changelogs Work
Changelogs appear in two ways:
In-App Widget - A corner button that opens a modal with recent updates
Public Page - A standalone webpage with your full changelog history
Users see a notification badge when new updates are available.
Creating a Changelog Entry
1. Start a New Changelog
Go to Messages in the sidebar
Click New Message
Select Changelog
Choose a template or start from scratch
2. Configure Entry Details
Entry Date
When this update was released. Users see entries sorted by date.
Category
Categorize your update:
New
Green
New features
Improved
Blue
Enhancements
Fixed
Orange
Bug fixes
You can add and edit categories directly in the changelog editor using the + and settings buttons next to the category dropdown.
3. Write the Content
Title
The headline for this update:
"Introducing Dark Mode"
"Performance Improvements"
"Fixed Export Bug"
Description
Use the rich text editor for details:
Explain what changed
How it benefits users
Link to documentation
Add images or screenshots
4. Customize Appearance
Position
Where the launcher button appears:
Bottom Right (default)
Bottom Left
Colors
Background Color - Widget background
Text Color - Title and body text
5. Set Up Targeting (Optional)
By default, changelogs are visible to all users. Add targeting to show specific updates to segments:
Example: Show feature to Pro users only
6. Publish
Click Publish to make the entry live.
Managing Categories
Customize changelog categories to match your workflow:
In the changelog editor, click the + button next to the category dropdown to add a new category
Click the settings icon next to an existing category to edit its name and color
Set category name and color
Default categories:
New (Green, #22C55E)
Improved (Blue, #3B82F6)
Fixed (Orange, #F59E0B)
Add custom categories like:
Security
Performance
Deprecated
Coming Soon
Public Changelog Page
Share your changelog publicly with a dedicated page.
Your Public URL
Your public changelog page is available at: app.cueflow.so/changelog/[your-workspace-slug]
Customization
Customize the appearance in Settings > Theme:
Workspace Logo - Appears in the header
Primary Color - Accent color for links and badges
Secondary Color - Secondary UI elements
Features
The public changelog page includes:
Category Filtering - Filter by New, Improved, Fixed
Search - Find specific updates (Cmd/Ctrl+K)
Pagination - Load more as users scroll
Timeline View - Chronological layout
Sharing
Share your public changelog:
Link from your marketing site
Include in release emails
Add to your footer
Best Practices
Writing Updates
Be specific - What exactly changed?
Focus on benefits - Why should users care?
Keep it scannable - Use headings and bullets
Add visuals - Screenshots help comprehension
Frequency
Don't overwhelm - Batch small fixes together
Highlight big releases - Major features deserve attention
Maintain consistency - Regular updates build trust
Categories
Use categories consistently
Don't over-categorize - 3-5 categories is enough
Consider your audience - technical vs. non-technical
Targeting
Major features: Show to everyone
Plan-specific: Target relevant users
Beta features: Target beta testers
Templates
New Feature
New
Major feature launch
Improvement
Improved
Enhancement to existing feature
Bug Fix
Fixed
Issue resolution
Major Release
New
Significant version update
Examples
New Feature
Bug Fix
Improvement
Analytics
Track changelog engagement:
Views - Users who opened the changelog widget
Entry Views - Which updates get the most attention
Public Page Views - Traffic to your public changelog
Use these insights to understand what updates resonate with users.
Last updated