Managing Changelog Categories
Organize your changelog entries with categories. Learn how to create, edit, and manage categories to keep your changelog well-organized and easy to navigate.
Default Categories
When you create a changelog, default categories are automatically created:
- New - New features and functionality
- Improvement - Enhancements to existing features
- Fix - Bug fixes and corrections
- Breaking - Breaking changes
- Notification - Important announcements
- Update - General updates
Creating Categories
To create a new category:
- Go to your changelog settings
- Navigate to "Categories" section
- Click "Add Category" or "New Category"
- Enter category name and choose a color
- Save the category
Editing Categories
Modify existing categories:
- Go to Categories section
- Click on the category you want to edit
- Update name, color, or description
- Save changes
Assigning Categories
Assign categories to entries:
- Create or edit an entry
- Use the category selector
- Select one or more categories
- Save the entry
Categories and Email Notifications
Categories also affect how email notifications are sent to subscribers:
- Subscribers can choose to receive notifications for specific categories only
- When you publish an entry, only subscribers interested in that entry's categories will receive an email
- Subscribers with "All categories" selected will receive notifications for any new categories you create
This allows your subscribers to filter updates and only receive what's relevant to them. Learn more about category subscription preferences.
Best Practices
- Keep It Simple - Don't create too many categories (5-10 is usually sufficient)
- Be Consistent - Use categories consistently across entries
- Use Clear Names - Choose descriptive names that subscribers will understand
- Use Colors - Color-code categories for visual organization
- Review Regularly - Remove unused categories
- Consider Subscribers - Think about which categories subscribers might want to filter by
Next Steps