{"id":2361,"date":"2020-05-06T09:00:58","date_gmt":"2020-05-06T13:00:58","guid":{"rendered":"http:\/\/blog3.canny.io\/wordpress\/?p=2361"},"modified":"2024-04-18T19:56:58","modified_gmt":"2024-04-18T23:56:58","slug":"should-you-use-a-changelog-tool","status":"publish","type":"post","link":"https:\/\/canny.io\/blog\/should-you-use-a-changelog-tool\/","title":{"rendered":"Should you use a changelog tool?"},"content":{"rendered":"<p>Listening to customer feedback and requests is crucial when it comes to building the right features.<\/p>\n<p>But what happens after you listen? What happens after you <a href=\"https:\/\/canny.io\/blog\/roadmap-prioritization-guide\/\" target=\"_blank\" rel=\"noopener noreferrer\">decide what\u2019s worth building<\/a>, add it to <a href=\"https:\/\/canny.io\/blog\/should-you-have-a-public-roadmap\/\" target=\"_blank\" rel=\"noopener noreferrer\">your roadmap<\/a>, and then actually build the feature?<\/p>\n<p>If your answer is \u201cship it and then move on,\u201d we\u2019d understand. You\u2019re done\u2014time to move on to the next thing!<\/p>\n<p>But, we\u2019d argue that there\u2019s a better way\u2014one that actually shares vital information with your user base, and gives you a chance to highlight the hard work you\u2019re doing by improving your product.<\/p>\n<p>The final piece of the puzzle? A public changelog.<\/p>\n<h2>What is a changelog?<\/h2>\n<p>Typically, a changelog is a file where product changes or versions are listed chronologically. It\u2019s just a <em>log<\/em> of <em>changes<\/em> (go figure).<\/p>\n<p>But, the type of changelog we\u2019re focusing on here is one that is public-facing, and intended for people who use your product.<\/p>\n<p>Now, depending on your customer base, they might be technical. Or, they might not be. Naturally, the types of details you include, and how technical you make your changelog, will vary depending on your customer base.<\/p>\n<h3>But broadly, a changelog that you share with the world will show:<\/h3>\n<ul>\n<li>A record of feature updates<\/li>\n<li>When new versions of your product have been released<\/li>\n<li>Bug fixes<\/li>\n<li>New integrations<\/li>\n<li>And so on<\/li>\n<\/ul>\n<h2>Should you use a changelog tool?<\/h2>\n<p>Why should you keep a changelog? And not only that\u2014why should you display it publicly?<\/p>\n<h3>1. It keeps all updates in one place<\/h3>\n<p>Without a changelog, you have a couple of options for how to share updates with your users.<\/p>\n<p><strong>You can:<\/strong><\/p>\n<ol>\n<li>Email them, or in some other way reach out directly<\/li>\n<li>Share updates on your social channels or blog<\/li>\n<li>Push notifications within your product (or some other in-app, one-time update)<\/li>\n<li>Not tell anyone at all, ever<\/li>\n<\/ol>\n<p>Options 1, 2, and 3 don\u2019t make it easy for users to look back on recent changes, or find everything in one place.<\/p>\n<p>If product updates are mixed in with your regular blog posts, they\u2019re not super easy to find. And, most of us don\u2019t hold onto emails indefinitely.<\/p>\n<p>So, users might never see your updates if they\u2019re just going out in a blog post or via email. They won\u2019t have a way to easily find these updates at a later date. And, if you\u2019re sharing updates that include info on how to set up or use certain features, having to hunt through an inbox or blog isn\u2019t convenient.<\/p>\n<p>If you\u2019re going to share changes with users, it makes sense to share them in one permanent place.<\/p>\n<p>(And while option 4 is certainly <em>available<\/em> to you, we\u2019d recommend you actually tell people when you\u2019ve changed something about your product. We\u2019ll touch on why that is throughout this article.)<\/p>\n<h3>2. Close the feedback loop on feature requests<\/h3>\n<p>If we had to highlight the <em>most<\/em> valuable thing about having a changelog, it would be this:<\/p>\n<p><em><strong>A changelog closes the loop from user feedback to execution.<\/strong><\/em><\/p>\n<p><a href=\"https:\/\/canny.io\/blog\/should-you-be-collecting-customer-feedback\/\" target=\"_blank\" rel=\"noopener noreferrer\">Collecting feedback is the beginning of this process<\/a>. You find out what your users have to say, what they want to see from your product, and what\u2019s working and what isn\u2019t.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"border alignnone wp-image-2363 size-full\" src=\"https:\/\/canny.io\/blog\/wp-content\/uploads\/2020\/04\/Canny-feedback-loop.avif\" alt=\"using a changelog helps close the feedback loop\" width=\"1698\" height=\"1037\" srcset=\"https:\/\/canny.io\/blog\/wp-content\/uploads\/2020\/04\/Canny-feedback-loop.avif 1698w, https:\/\/canny.io\/blog\/wp-content\/uploads\/2020\/04\/Canny-feedback-loop-300x183.avif 300w, https:\/\/canny.io\/blog\/wp-content\/uploads\/2020\/04\/Canny-feedback-loop-768x469.avif 768w, https:\/\/canny.io\/blog\/wp-content\/uploads\/2020\/04\/Canny-feedback-loop-1677x1024.avif 1677w, https:\/\/canny.io\/blog\/wp-content\/uploads\/2020\/04\/Canny-feedback-loop-196x120.avif 196w\" sizes=\"auto, (max-width: 1698px) 100vw, 1698px\" \/><\/p>\n<p>From there, you <a href=\"https:\/\/canny.io\/blog\/should-you-have-a-public-roadmap\/\" target=\"_blank\" rel=\"noopener noreferrer\">build your public roadmap<\/a>, incorporating the feedback that makes sense for your business and your tool, along with other things you\u2019ve decided internally are a priority.<\/p>\n<p>Finally, you release updates, add new features, fix what needs fixing.<\/p>\n<p>A changelog is a viewable culmination of this work. It\u2019s a way to log what you did, and tell users about it. They can see that you actually executed on feedback that was given.<\/p>\n<p>This is huge\u2014both when it comes to keeping existing users loyal to your business, and in terms of attracting potential customers.<\/p>\n<p><!--HubSpot Call-to-Action Code --><span id=\"hs-cta-wrapper-e1d55d08-a2cf-44a3-a9a0-f3ca5ff21dfa\" class=\"hs-cta-wrapper\"><span id=\"hs-cta-e1d55d08-a2cf-44a3-a9a0-f3ca5ff21dfa\" class=\"hs-cta-node hs-cta-e1d55d08-a2cf-44a3-a9a0-f3ca5ff21dfa\"><!-- [if lte IE 8]>\n\n\n<div id=\"hs-cta-ie-element\"><\/div>\n\n\n<![endif]--><a href=\"https:\/\/cta-redirect.hubspot.com\/cta\/redirect\/5705808\/e1d55d08-a2cf-44a3-a9a0-f3ca5ff21dfa\" target=\"_blank\" rel=\"noopener noreferrer\"><img loading=\"lazy\" decoding=\"async\" id=\"hs-cta-img-e1d55d08-a2cf-44a3-a9a0-f3ca5ff21dfa\" class=\"hs-cta-img aligncenter\" style=\"border-width: 0px;\" src=\"https:\/\/no-cache.hubspot.com\/cta\/default\/5705808\/e1d55d08-a2cf-44a3-a9a0-f3ca5ff21dfa.png\" alt=\"Canny free trial\" width=\"1300\" height=\"642\"><\/a><\/span><script charset=\"utf-8\" src=\"https:\/\/js.hscta.net\/cta\/current.js\"><\/script><script type=\"text\/javascript\"> hbspt.cta.load(5705808, 'e1d55d08-a2cf-44a3-a9a0-f3ca5ff21dfa', {\"region\":\"na1\"}); <\/script><\/span><!-- end HubSpot Call-to-Action Code --><\/p>\n<h3>3. It\u2019s the perfect place for documentation<\/h3>\n<p>If you\u2019ve <a href=\"https:\/\/canny.io\/blog\/release-notes\/\"  data-wpil-monitor-id=\"41\">released a new feature<\/a>, you\u2019ll probably need to explain to users how to use it or set it up.<\/p>\n<p>Your changelog is the perfect place to do this. You can tell customers how to use or set up a new feature, link to a help center article, or include screenshots and videos.<\/p>\n<p>This will also cut down on the amount of outreach your customers have to do. If a new feature has been released and customers don\u2019t know how to set it up, they\u2019ll contact you. (Or, they just won\u2019t use the feature at all\u2014not great.)<\/p>\n<p>This means time spent on their end reaching out (not ideal), and time spent by your Customer Success team following up (also not ideal).<\/p>\n<p>Having a changelog gives you a \u201chome\u201d for all updates, and the documentation that goes with them. It makes it easy to tie new features to their associated documentation from the get-go.<\/p>\n<h3>4. It\u2019s an announcement and proof of deliverable all in one<\/h3>\n<p>Your changelog is a place to highlight your new features and give them a chance to shine.<\/p>\n<p><iframe loading=\"lazy\" src=\"https:\/\/www.youtube.com\/embed\/MvmaA_WLy1U\" width=\"560\" height=\"315\" frameborder=\"0\" allowfullscreen=\"allowfullscreen\"><\/iframe><\/p>\n<p>Jokes aside, as we\u2019ve touched on in the video, the changelog is your chance to spotlight the great new things you\u2019ve released. Rather than just silently shipping updates, you can share what you\u2019ve been working on, and tell your customers why they\u2019ll love it.<\/p>\n<p>It\u2019s also a place to showcase that you act on feature requests from your customers. It shows that you act on feedback and deliver what you\u2019ve promised.<\/p>\n<p>And, it\u2019s not just valuable to customers: Your sales team can use your changelog as a sales tool with prospects.<\/p>\n<p>Your changelog shows that you listen and act on customer input, and are continually working to build something better for your users. This is valuable to potential new users, as well as your existing user base.<\/p>\n<h2>How we use a changelog at Canny<\/h2>\n<p>Of course, we use our own <a href=\"https:\/\/feedback.canny.io\/changelog\" target=\"_blank\" rel=\"noopener noreferrer\">Changelog feature<\/a> here at Canny\u2014just like we <a href=\"https:\/\/feedback.canny.io\/\" target=\"_blank\" rel=\"noopener noreferrer\">use Canny to collect feedback <em>on<\/em> Canny<\/a>. (It all gets a little meta.)<\/p>\n<p>Here\u2019s an example of how we use it: We recently introduced our Slack integration. Here, you can see it at the top of our changelog page:<\/p>\n<figure id=\"attachment_2364\" aria-describedby=\"caption-attachment-2364\" style=\"width: 1017px\" class=\"wp-caption alignnone\"><img loading=\"lazy\" decoding=\"async\" class=\"border wp-image-2364 size-full\" src=\"https:\/\/canny.io\/blog\/wp-content\/uploads\/2020\/04\/Canny-changelog.avif\" alt=\"Canny changelog\" width=\"1017\" height=\"646\" srcset=\"https:\/\/canny.io\/blog\/wp-content\/uploads\/2020\/04\/Canny-changelog.avif 1017w, https:\/\/canny.io\/blog\/wp-content\/uploads\/2020\/04\/Canny-changelog-300x191.avif 300w, https:\/\/canny.io\/blog\/wp-content\/uploads\/2020\/04\/Canny-changelog-768x488.avif 768w, https:\/\/canny.io\/blog\/wp-content\/uploads\/2020\/04\/Canny-changelog-189x120.avif 189w\" sizes=\"auto, (max-width: 1017px) 100vw, 1017px\" \/><figcaption id=\"caption-attachment-2364\" class=\"wp-caption-text\">Our entry on our Slack integration on the Canny Changelog<\/figcaption><\/figure>\n<h3>With the changelog update, we\u2019re able to:<\/h3>\n<ul>\n<li>Tell users about the new integration<\/li>\n<li>Show how it works<\/li>\n<li>Link the <a href=\"https:\/\/help.canny.io\/en\/articles\/766734-slack-integration\" target=\"_blank\" rel=\"noopener noreferrer\">help center article<\/a><\/li>\n<li>Notify users that have been waiting for the integration to be released<\/li>\n<\/ul>\n<p>&#8230;all in one place.<\/p>\n<h2>How to set up a public changelog<\/h2>\n<p>Realistically, your changelog can take whatever form makes the most sense for your team, your company, and the type of product you make.<\/p>\n<p>You can set up a blog-style page, with articles on each change. An extreme MVP version of a changelog could even be a regularly-updated Google doc.<\/p>\n<p>As a note: Neither of these options are particularly sustainable or organized. And, they require a lot more effort on your part than using a tool with a changelog feature. But, it\u2019ll be better than nothing.<\/p>\n<p><a href=\"https:\/\/canny.io\/features\/changelog\" target=\"_blank\" rel=\"noopener noreferrer\">Canny has a changelog feature built in<\/a>, which makes it easy to set up a changelog for your product, and close the loop from feedback to feature. The changelog product widget gives users updates while they\u2019re within your product. And, users can also click through to see your full changelog, read related help center documentation, and more.<\/p>\n<p>You can read more about the <a href=\"https:\/\/canny.io\/blog\/canny-changelog\/\" target=\"_blank\" rel=\"noopener noreferrer\">Canny Changelog here<\/a>, and learn more about why having a changelog is valuable.<\/p>\n<p>Ultimately: It\u2019s smart to use a changelog, regardless of how you set it up or what tool you use. It closes the feedback loop, shows that you deliver on your plans, and gives you a chance to showcase your hard work.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>A changelog shows what new features, fixes, or versions of your product you&#8217;ve released. Here&#8217;s why using a changelog tool is valuable for your user base, and for prospective customers. <\/p>\n","protected":false},"author":10,"featured_media":6364,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"content-type":"","_lmt_disableupdate":"","_lmt_disable":"","footnotes":""},"categories":[2],"tags":[],"class_list":["post-2361","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-building-saas"],"aioseo_notices":[],"modified_by":"Maria Vasserman","_links":{"self":[{"href":"https:\/\/canny.io\/blog\/wp-json\/wp\/v2\/posts\/2361","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/canny.io\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/canny.io\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/canny.io\/blog\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/canny.io\/blog\/wp-json\/wp\/v2\/comments?post=2361"}],"version-history":[{"count":13,"href":"https:\/\/canny.io\/blog\/wp-json\/wp\/v2\/posts\/2361\/revisions"}],"predecessor-version":[{"id":6683,"href":"https:\/\/canny.io\/blog\/wp-json\/wp\/v2\/posts\/2361\/revisions\/6683"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/canny.io\/blog\/wp-json\/wp\/v2\/media\/6364"}],"wp:attachment":[{"href":"https:\/\/canny.io\/blog\/wp-json\/wp\/v2\/media?parent=2361"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/canny.io\/blog\/wp-json\/wp\/v2\/categories?post=2361"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/canny.io\/blog\/wp-json\/wp\/v2\/tags?post=2361"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}