You’re in the home stretch of your release cycle. It’s time to ship your product...and you have to write release notes.
Many companies treat release notes as an afterthought. They rush to put something—anything—together to check the “release notes” box of that particular development cycle. The release notes end up being full of technical jargon users will not understand.
However, release notes are an opportunity to keep your customers excited about your investment in the product. Well-written release notes not only make your customers aware of new features (hello, product adoption!) but also remind them of the value your product provides.
Don't skimp on your release notes—they're your chance to share the culmination of your hard work. Using product release notes effectively will help you re-engage users, build excitement around your entire product, and extend your reach to new audiences. Well-crafted release notes are better for you, the internal teams, and ultimately, the customer. Here are some tips on how to write the best release notes—and examples of awesome release notes to help inspire you.
What are release notes?
A release note is a report published alongside new or updated software that details the technical features of the product. For new releases, these notes provide end-users with a brief summary of the product itself. For updates to existing products, the notes educate end-users on how the new version of the software improves upon the former.
Release notes are often distributed to users on a designated page within the app itself. This approach allows for companies to maintain comprehensive lists of changes to their software going back to the product’s first version for their customers. Keeping these running lists shows customers that a product is in a constant state of improvement. It also tells customers that the company behind the product listens to its customer feedback and is dedicated to providing the best possible customer experience.
However, forcing customers to journey through your app to find important release information can be disruptive to UX. Sometimes other methods of distribution should be used to reach users. These channels include:
- Email. These can be used to directly communicate updates to customers instead of waiting for them to use your product. They’re often used to celebrate exciting updates or announce important changes to the status quo.
- Blog posts. These are designed to handle longer-form content than a standard email or in-app message. This makes them a perfect format for releases that deserve more copy or explanation.
- Social media. This is a great way to spotlight single features and build hype for new releases and updates.
- App Store/Google Play Store. Release notes are common in Apple’s App Store and the Google Play Store. For example, users looking to buy or update a web or mobile app in the App Store can view an extensive list of release notes when selecting a product. The TikTok app version history looks like this:
Distributing release notes using Appcues
Companies also have the option to deliver release notes through in-app messaging. A customer receiving an email or browsing a blog post is reading about the new features and experiencing them later. In-app messaging allows a customer to read about the new product or updates as they are experiencing them within the app itself.
Appcues enables companies to easily use in-app messaging to deliver release notes. Modal windows can be deployed when a user first opens the app or pulls up a new feature that gives an overview of the changes in store. Slideouts are often used to explain new features or changes to the UI as users engage with the elements in question. Each of these options provides an explanation of new or updated features before a user has the chance to be frustrated by them.
There is a time and place for modals and slideouts. If your new release updates 60 different features, a user is bound to be annoyed by reading and closing out of 60 individual messages. These in-app messages are meant to improve UX, not disrupt it. In-app messaging should be used to highlight the most important new features or give a brief overview, not bog the user down in minute details.
How to write release notes
Release notes have the potential to inform and even delight your users or frustrate them with vague updates or indecipherable jargon. Luckily, adhering to a few simple tips can elevate your release notes from “Ooookay...” to “Okay!” in a jiffy.
1. Make the intent of the changes clear
The people who scan release notes are there for a reason—they want information on what's been changed and how that affects them. Make sure the text clearly shows what’s been changed, and highlight what those changes mean to the user. Also, don’t be afraid to use some humor to put the user at ease.
Make sure the text clearly shows what’s been changed, and highlight what those changes mean to the user. Also, don’t be afraid to use some humor to put the user at ease.
Clarity is key in your release notes. You need to find a balance between providing enough detail and not overwhelming users with big, confusing blocks of text. Web users don’t read—they scan—so make your release notes scannable. One way is to highlight important keywords you want the user to notice.
Keep explanations short and simple, but don’t oversimplify. For example, saying, “Bug fixed and updates applied” is short but vague. On the other hand, “We improved the ability to switch apps, reducing unexpected software crashes” is clearer, highlights the benefits in more detail, but still isn’t too long or overwhelming.
2. Focus release notes on the user
Remember, release notes are a great line of communication with your customer. Empathize with your user—assume their role in seeking information. Understand them, know them, learn about them. When compiling your notes, ask what are they looking for? Can they easily find it?
Keeping their needs top-of-mind when writing them will help you relate to your user and keep your updates engaging and easy to read. The user is more likely to understand your changes and will pay more attention to your release notes.
It’s important to know your customer—77% of consumers would preferably purchase from brands that share their values.
3. Explain changes with visuals
Most consumers only remember about 20% of the text they read when it's not accompanied by visuals, and according to one eLearning website, “ well-selected images can improve comprehension and insight when developers strategically place such graphics.” If your release notes need a lengthy explanation, include a short GIF or a helpful screenshot that shows exactly what that change does.
An example would be the Magic: The Gathering card game release notes. One release notes update contains as many as 51 pages of update information— it’s a lot to take in. However, MtG has done a good job of summarizing those notes on their front page with visuals and recaps of the most important features that were updated.
4. Keep release notes organized
Users will become numb when asked to read or scan a wall of text. Keep things organized and segmented by using subheads, drop-down menus, bullet points, and paragraph breaks. Breaking up big blocks of text in your release notes will help the user readily find which change applies to them.
A good example is Amazon Business, which has a dedicated release notes page that allows drop-down menus to segment notes by category, product offering, month, and year.
5. Don’t get technical
Release notes can serve different purposes—promoting new features, building a relationship with the customer, helping users find solutions to their problems—but it’s hard to do that when notes are peppered with highly technical and difficult niche language.
Lose the jargon.
Use straightforward, easily understandable words and phrases. Once you’ve finished writing, read the release notes out loud to a friend or family member—someone who doesn’t know about the technical background of the release. Does the explanation make sense to them? Chances are, if your little brother or sister gets what you're talking about, so will most of your users. “You can now use GIFs in our messaging service” is far more understandable than “We have implemented the ability to use Graphics Interchange Format bitmap images which includes file compression, transparency, interlacing and storage of multiple images within a single file for our messaging service.”
Also, use jargon-less notes as a way of connecting with the customer. If your brand is funny and light-hearted, your notes should reflect that. If your brand is eco-aware and green-friendly, adopt that messaging in your release notes as well. This will build the bonds of loyalty and empathy with your customer, who’s used to your style and sees it reflected in even the most laborious task, like release notes.
6. Go ahead and promote your brand...carefully
You can use release notes as a way to promote your brand messaging, but don't overdo it with heavy self-promotion. Too much self-promotion can erode a customer's trust in your brand. But can you sneak a little self-promotion into your release notes to help boost your brand's messaging.
Be careful how you pitch, though. A poor pitch in the release notes inflates the brand and overpromises before mentioning the change. “We’re here to save the planet, something we've done successfully with every updated release. You're welcome. Our new hotfix includes 50% less energy consumption.” It comes across as arrogant, a real trust-killer with your audience.
Instead, a softer (and more humble) approach would be “Bugfix: 00100 — Software now reduces end-user energy consumption by 50%. One of many ways we aim for a sustainable future.” You see what we did there? We told you the fix, then threw in that we’re watching out for you--all without sounding performative.
Employ the 80/20 rule used in social media; 80% of your content should be useful, and only 20% should be self-promotion. This rule is not only useful for release notes but for any type of content you produce.
7. Use a Release Notes Template
A template helps to organize your thoughts by giving you a blueprint for what comes next in the process, making it easy for developers and product managers to put together.
A template should start with an introduction and brief overview of the changes, show impacted users, changes to previous release notes, fixed issues, issues/challenges/obstacles/limitations, and a plan on how the changes will be made.
Here’s one we created that’s basic but helpful and can assist you in organizing your release note writing.
5 examples of great release notes
The format of your release notes should be a balance of meaningful content and a reflection of your brand’s voice. Below are five examples of great release notes and an explanation of how you can emulate them to make a bigger impact with your next update.
1. Help Scout reminds users of existing features
While announcing a new feature (a bulleted list), HelpScout also draws users’ attention to Messages editor features some may not be currently using.
The screenshot shows how the Markdown feature is used with an example and how the link on the word Markdown takes the user to an in-depth article on the feature. When composing release notes, the Markdown feature is helpful in pointing out where the user should be looking, eliminating aimless searching throughout the document.
2. Retool categorizes types of changes for easy user skimming
Retool categorizes their updates as “Minor,” “Improvement,” and “New.” If a user wants to focus only on “New” features within the list, they’re easy to find.
Each release note section has a spot for users to leave feedback, so Retool can capture user sentiment about a release. This kind of feedback loop is essential in developing even better release notes because you can address exactly what the customer did or didn’t like.
3. UiPath includes a Table of Contents for easy navigation
The ease-of-use UiPath offers with its table of contents feature makes the navigation of the release notes even easier. If users have questions about past releases, they can easily access the release notes table of contents.
4. Amplitude incorporates video
Amplitude uses a combination of short videos and screenshots when explaining new features. Video is very effective when engaging an audience. Seventy-nine percent of people say watching a video has convinced them to buy an app, and “explainer” videos are viewed by 96% of consumers.
Amplitude’s animated intro gives users an explanation of the new feature first and then dives into the application to show the feature “in action.”
5. Feefo’s in-app update announcement gives you the release notes immediately
Some users don’t want to scrounge around a lengthy release note document on your website or through email. Feefo uses Appcues to announce its latest features, releases, and announcements in the app itself. This communication is especially effective since the app is where the changes will have the biggest effect.
The slideout grabs attention and notifies users about updates without taking them out of the app itself. Users can click a button to access the full release notes.
Find out how Appcues can help you improve your activation rate, increase campaign opt-in, and reduce support burden through contextual, targeted in-app communication.
Make a bigger impact with great product release notes
Appcues can help manage the weary chore of writing release notes. Their in-app user engagement platform can help take the most technical task and simplify it for your teams while skipping the part where you barrage your IT department with requests.
Want help planning the perfect product launch? Try our Product Launch Planner tool for free!