Skip to main content

​
Creating Your First Announcement

Let’s walk through creating a great first announcement for your changelog.

​
What makes a good announcement?

Before we dive in, here are some tips:

Be specific

“Improved dashboard performance by 40%” beats “Made things faster”

Lead with value

Start with what users can now do, not what you built

Keep it scannable

Use headings, bullets, and short paragraphs

Show, don't tell

Screenshots and GIFs help users understand changes

​
Step-by-step guide

​
1. Click “New Announcement”

From your dashboard, click the New Announcement button in the top right. [TODO: ADD IMAGE - DASHBOARD WITH NEW ANNOUNCEMENT BUTTON HIGHLIGHTED]

​
2. Write a compelling title

Your title should be clear and specific. Users should know what the update is about at a glance.
  • “New: Dark mode is here”
  • “Faster exports with bulk download”
  • “Fixed: Login issues on Safari”
  • “API v2 now available”

​
3. Write your content

Use the rich text editor to describe your update. A good structure: 
## What's new
Brief description of the feature or change.

## How it works
Step-by-step or key details.

## Why we built this
Optional: context on user feedback or your roadmap.
[TODO: ADD IMAGE - EDITOR WITH SAMPLE CONTENT]

​
4. Choose a category

Categories help users filter and scan your changelog. We create three by default:
CategoryWhen to use
NewBrand new features
ImprovementEnhancements to existing features
FixBug fixes and corrections
You can create custom categories in Settings → Changelog → Categories

​
5. Add a cover image (optional)

Cover images make your announcements more eye-catching, especially when shared on social media. Recommended specs:
  • Size: 1200 x 630px (2:1 ratio)
  • Format: PNG or JPG
  • Keep text minimal — it may be cropped on some platforms
[TODO: ADD IMAGE - ANNOUNCEMENT WITH COVER IMAGE EXAMPLE]

​
6. Preview and publish

Click Preview to see how your announcement will look on your public changelog. When you’re happy with it, click Publish. Your announcement is now live!
Pro tip: You can also save as a draft and come back later, or schedule it for a future date.

​
Announcement templates

Here are some templates to get you started: 
We're excited to introduce [Feature Name]!

## What's new
[Brief description of what users can now do]

## How to use it
1. Go to [location]
2. Click [button]
3. [Next step]

## What's next
We're already working on [related improvement]. Stay tuned!

We've made [Feature] even better.

## What changed
- [Improvement 1]
- [Improvement 2]
- [Improvement 3]

## Why we made this change
Based on your feedback, we [reason].

Let us know what you think!

We've fixed an issue affecting [description].

## What was happening
[Brief description of the bug]

## What we fixed
[What users can expect now]

Thanks to everyone who reported this issue!

​
Next steps

Writing great announcements

Deep dive into announcement best practices