The Best SaaS Changelog Examples

Changelogs and release notes are a common place of SaaS for both users and developers now, and we are sharing some of the best SaaS changelog examples in this post. Users don’t settle for a one and done solution anymore. Changes, developments, new integrations, and swift fixes and updates are an integral part of your product experience and customer service. Without this, customers will be looking for alternatives. While your team is working hard to make sure that your product is consistently improving, pivoting with market changes, and meeting customers’ expectations, it’s vital that you keep users in the know and aware of the improvements that your team is making to your product.  Now, what are the best ways for SaaS to communicate product changes and updates?

Here are some great SaaS changelog examples:

Good Saas Changelog Example: Mailchimp.

Mailchimp has a section on their site also accessible for logged-in users called “What’s New”. They organize their product updates in a really clean, simple and visual style that is friendly for anyone to explore. This is what we call a good changelog example.

What they get right:

• The latest and greatest is at the top like a big announcement. They have a main update at the top that is very visual with a short description and CTA to go on to the full update post with more information. It’s not overwhelming but it’s still intriguing.
• Updates are chronological below. Below the latest update, they break the rest into chronological order by month. You can also jump down months through a really simple navigation which makes it manageable. The updates are all very simple with short, actionable titles that get to the point of the update. For example, instead of “Update to domains” they say “We’ll help you find the right custom domain for your business”. The value is communicated right away.

Good Saas Changelog Example: Hubspot.

Hubspot takes a little bit of a different approach utilizing both the chronological flow and update segmentation by product to make navigating updates easier. Hubspot has multiple “sections” or “products” within their platform that they have to keep organized for users. This way, users don’t have to scroll through updates to find what they’re looking for.

What they get right:

• A handy navigation system. There is a navigation box that breaks updates down by product (Hubspot Marketing, Sales, and Marketing Free), and then by “Feature Updates” and “All Updates”. This is great because a lot of users looking at a changelog are looking for new feature updates instead of say API updates or big fixes which more developers are focused on. Because the vast majority of Hubspot users are end users in marketing and sales positions, they focus on new features.
• Visual elements. Within their update previews, they include screenshots and images to make them more interesting than just a text preview. Once you click in, the long text is broken up by relevant screenshots that help explain the update better.
• Actionable titles. The titles used focus less on the actual change or update itself, but describe the end value to the end user. For example: “Keep Marketing Organized with Team Permissions for Emails, Forms and CTAs”. They tell users directly what they can now do with Hubspot instead of describing how - because users likely don’t care. They want to know why the product is now better.
• Short and to the point. Hubspot’s updates are very short and to the point. There’s no unneeded extra paragraphs of fluff. They are less than one page in length and really rely on visual elements to get the point across. They include CTAs to get straight to the new feature so that users can start engaging right away. Your changelog is not your blog - it should be to the point of how your product is better.

Maintaining a good changelog.

Maintaining a clear changelog is vital for SaaS platforms to track updates effectively, enhancing transparency and accountability. Categorizing changes ensures easy access while providing links to relevant resources offers valuable context. A well-maintained changelog streamlines development processes and keeps stakeholders informed efficiently.

Importance of changelog in development

Detailed changelog keeps everyone in the loop. Whether you're a SaaS developer immersed in the code or a user just trying to figure out what's new, the changelog has your back. It's the go-to for understanding how the project has changed.

Why keep a changelog.

Keeping a changelog is crucial for tracking updates and improvements to your product or service. It helps users stay informed about new features and bug fixes, building trust and loyalty with your audience.

What is a good changelog?

A good changelog is a detailed record of updates and improvements made to software or a website. It helps users stay informed about new features and bug fixes. It plays a crucial role in enhancing user experience and maintaining transparency in product development.

Automating changelog parsing process.

Automating changelog parsing transforms how you handle updates. Using automation tools boosts efficiency by extracting information quickly and accurately. It saves time, minimizes errors, and provides real-time updates without manual checks. Integrating automation streamlines your workflow, letting you focus on high-value tasks and innovation.

Writing Effective Release Notes.

Effectively communicating changes and updates to users entails crafting clear and concise release notes that spotlight improvements and bug fixes in each update. This practice informs users and cultivates trust and loyalty toward your product or service.

Tips for creating your own changelog.

Decide who your priority audiences are:

It’s important to know who is most interested in your updates as to not miss the mark for either group and alienate them. For many SaaS products, you are communicating changes to both users directly and developers who are working on a higher level with your product. Your updates will need to give both these parties the information they need. Some choose to write updates for users and focus on sharing the value of changes rather than the technical details. If your product is more developer-facing, you may want to be more technical. Segmentation of updates really helps to keep things focused and interesting for each user in this case.

Include visuals:

All test updates are a nightmare for both a developer or user. They also get lower engagement. Include screenshots or videos to break up text. It’s also harder to understand what you’re describing in your update without adding a visual element. Videos and GIFs are great for showing functionality and giving a brief tutorial on the new change and where to find it.

Focus on the end benefit for the audience:

Regardless of whether you’re speaking with developers or users, it’s best to focus on the added value of the change you’ve made - even if it’s a fix. Focus on how the experience has improved for the user and what pain point has been eliminated or new functionality has been added as a result. For example: “Now you can target the right customers more effectively with new segmentation”. The focus isn’t new segmentation but what the user is able to do with that feature.

Make it short and sweet:

It really is best to keep things short, especially when it’s important information. Eliminate fluffy text and opening paragraphs and keep updates as short and informative as possible. They should be quick reads that are easy to digest and apply for users.

Make it actionable:

It really helps to include clear CTAs and next steps for users in your changelog and release notes. This helps to keep them moving and exploring your product. The more they start interacting with your changes and new features, the more likely they are to be a success. Immediate interaction helps increase engagement and adoption.

Offer more information if they want:

It’s great to have a short to-the-point preview and then allow more information if the reader is interested. This is especially helpful for situations where you want to communicate a change to both end users and more technical roles. You can offer the gist of a change or new feature and it’s benefit in a short preview and then allow users to click through to a more technical document if they want.

Allow comments and feedback:

Updates are an excellent opportunity for feedback. Users’ reactions and comments on your recent changes can provide your team with a lot of important data for what’s working and what’s not. Open up the opportunity to provide feedback within your changelog and release notes in a way that’s convenient for users.

Host it somewhere that makes sense for everyone:

Your changelog should not be hard to find. It should be accessible for users both on your website not logged in and within your app or platform. They should see updates intuitively and not have to go out of their way to find them. Sending emails for updates and changes used to be the usual practice but it can be annoying and the open and engagement rates for those are fairly low.

Standard changelog format guidelines.

When crafting a changelog, adhering to standard format guidelines for clarity and organization is crucial. A changelog is a chronological record of changes made to your offering, providing transparency to users and stakeholders.

• Ensure your changelog is structured clearly and consistently. It simplifies understanding the evolution of your product over time.
• Include essential details such as the version number, release date, and a brief update description. It helps track the progress of features and bug fixes.
• Organize the changelog in a user-friendly layout to enhance the overall user experience, making it more accessible and digestible for new and existing customers.
• Categorize updates based on their significance or impact to assist users in identifying the most relevant changes.

Remember, a well-crafted changelog informs users about updates and demonstrates your commitment to continuous improvement and customer satisfaction.

Common changelog mistakes to avoid:

• Neglecting to strike the proper balance between detailed information and conciseness can be detrimental. A meticulous changelog serves as a roadmap for both users and developers. Clear delineation of each update aids in understanding the product's progression and how it aligns with their needs and expectations.
• Neglecting to categorize updates according to their importance and influence can lead to confusion. An organized changelog helps users navigate the changes and locate the most relevant updates.
• Neglecting to include context for each update in the changelog can hinder understanding. Explaining specific changes, user feedback influence, and the benefits of new features helps users grasp the changes and demonstrates the developer's dedication to improvement and user satisfaction.
• Omitting screenshots, GIFs, or videos from the changelog may diminish user engagement and comprehension. Visual elements enable users to witness the changes in action and comprehend their impact on the product. Additionally, they generate excitement and interest, motivating users to explore the new product version.

By maintaining a detailed, organized, and visually appealing changelog, developers can enhance their relationship with users and instill trust in their product development process.

Beamer is a much more intuitive way to update users on changes, bug fixes, updates, etc. Beamer is an in-app changelog that sits in your website and app interface. Users can open Beamer by clicking “What’s New” or an icon in your interface. The changelog discreetly opens on any page with a list of updates in chronological order. You can include photos, screenshots, or videos in your updates to make them more engaging. You can add CTAs to a longer post or page with more information or to the feature itself. You can also use segmentation to send targeted updates for users based on plan, demographic, location, language, and past behavior. With Beamer, you can send out push notifications every time you post an update to bring users back to explore your update. It’s much more intuitive and in context than an email and a page somewhere on your site away from activity.

A changelog and consistent updates can be a great way to boost engagement, show users that your product is improving for them, and make sure your updates are noticed and adopted by your users. An evolving product is what keeps customers loyal. Your changelog is what communicates that consistently. For the best way to present changes and updates in a changelog, try Beamer on your site and in your app.