The changelog is one of the most visited pages on our website. It's visually appealing, informative, and recently a new way to distribute content to our users.

We are using it as a new marketing channel and you can too.

"Your changelog is one of the best I know because it's transparent, you can always see what's going on and see that the app keeps improving fast…"

Simon M.

What is a changelog?

For those who aren't familiar with the concept, a changelog is a tool used to announce changes to a project in a chronological order. Most websites out there with changelogs usually limit to technical updates for current users, but not us. We want ours to be a detailed timeline of our company's journey for new and existing users.

We're not reinventing the wheel here; we are only experimenting with this format of updating customers but with a twist, and we're sharing our experience with you.

Here are a few takeaways and a free goodie for you as well!

Be succinct

Try to keep it short, preferably with only one line of text. The tags (for example IMPROVEDBETANEW) immediately tell the user what the change is about, helping you to go straight to the point.

Sometimes notes are needed to complement the text. We opted for formatting them in smaller font size and different color.

If one line and note is not enough, add a read more link and bring the user to a separate in-depth article.

Add images, gifs, or videos.

Without graphics, it's just a long list of boring text. Try adding images or short videos to enhance the content.

But you don't want to cover the changelog with images. Otherwise, it will become hard to read, losing its appeal.

We usually add images to make the content clearer. For example, if you see this:

You have no idea what this is about; you have no context. But when adding a zoomed-in screenshot, you immediately understand it all.

Make it more than just the product.

Traditional changelogs usually contain modifications to the software like new features, bug fixes, and improved functionality. But this is where you can be creative.

We weren't getting many views on our blog posts and we knew people liked the changelog page, so we added a BLOGtag to the changelog, and people started reading our posts more!

Other tags have been added recently as well. We hired a new employee, so we added a HIREDtag, and one of our users took the time to write an email, welcoming the new teammate!

Email it too!

It's an excellent alternative to the classic overused email newsletter. At the end of 2019, we sent a newsletter formatted as the changelog. It turned out to be a success. The email open-rate was good, our blog post views went up, and we even received encouraging messages to keep this going!

Are you convinced?

Yes! But how can you implement it? Well, there are many changelog SAAS that offer precisely this. Here are three great options:

• Canny: A single service to that lets you implement a changelog, a roadmap, and a feature requests system.
• Beamer
• Changefeed

Or you can build your own like us! It's a simple YAML file in our Rails app. Maybe we can do another blog post about it. Reach out if you would like that.

We hope your users enjoy this as much as ours did!