GoldenGecko
PlaybooksGuidesFeaturesPricing
  1. Playbooks
  2. /Referral
  3. /Build a public changelog people share
Linear/Canny

You ship features but nobody notices

Build a public changelog people share

Every shipped feature is a micro-launch opportunity. A well-written changelog turns updates into shareable content your users spread for you.

ReferralBeginner
1-2 weeks to build, ongoing effort per update

When to use

You ship regularly and have active users who care about your product's direction. Best for products with an engaged community or niche audience.

Hypothesis template

If we publish a [public changelog] with storytelling and [shareable updates], feature adoption will increase and users will share updates because they feel part of the journey.

Method

The problem: You ship features every week but nobody notices. You send a bland "what's new" email that gets 8% opens. Your biggest fans don't know about the improvements they asked for.

What Linear did: Built a beautifully designed public changelog where each update tells a story: the problem, the solution, and why it matters. Each entry has a share button and a direct link.

The result: Linear's changelog gets shared widely on Twitter and in Slack channels. Feature adoption increased 30%+ compared to in-app notifications alone. Users feel invested in the product's evolution and become evangelists.

How to do it:

  1. Create a public changelog page at [yourapp.com/changelog]
  2. For each update, write it as a mini-story: "You told us [problem]. Now you can [solution]"
  3. Add visuals: before/after screenshots, short demo GIFs
  4. Make each entry shareable with its own URL and open graph image
  5. Post weekly or biweekly—consistency matters more than volume
  6. Cross-post to Twitter/X with the highlight and a link to the full entry
  7. Email subscribers a digest of recent changes monthly

Key insight: A changelog isn't a release notes dump. It's a series of micro-launches. Each update is a chance for your users to say "look what my favorite tool just shipped."

Success metrics

  • •Changelog page views
  • •Social shares per update
  • •Feature adoption rate
  • •Email open rate for changelog digests
  • •New signups from changelog referrals

Prerequisites

  • Regular shipping cadence (at least biweekly)
  • Ability to build a public page
  • Someone who can write updates in a compelling way

Common pitfalls

  • •Writing boring release notes instead of stories
  • •Shipping a changelog and then not updating it
  • •Too technical (focus on outcomes, not implementation details)
  • •No visuals (screenshots and GIFs make updates 3x more shareable)

Source: Linear/Canny. Public changelogs increase feature adoption 30%+.

Suggested ICE scores

6Impact
7Confidence
8Ease
referralchangelogtransparencyword-of-mouthlinear

Ready to run this experiment?

Sign up free to use this playbook with step-by-step guidance and track your results.

More referral playbooks

Your product is invisible to potential users

Embed a "powered by" badge in your product

ReferralBeginner

Nobody uses your referral program

Give both sides a reward

ReferralIntermediate

Your content attracts visitors but not buyers

Create a free email course that sells

ReferralIntermediate

Explore other categories

Acquisition

Get more visitors and sign-ups

Activation

Turn sign-ups into active users

Retention

Keep users coming back

Monetization

Increase revenue per user

Run experiments like a pro

Get experiment suggestions, track results, and learn what works.

GoldenGecko

Always know what to test next. Proven playbooks, matched to your goals.

Product

  • Features
  • Pricing
  • Playbooks

Resources

  • Guides
  • Common problems
  • Glossary
  • Comparisons
  • Documentation

Geckoverse

  • Silver Gecko — SEO
  • Local Gecko — local SEO

Company

  • About
  • Privacy
  • Terms

© 2026 GoldenGecko. All rights reserved.