Skip to main content
Guide

Best practices for writing Product updates

  • May 12, 2020
  • 0 replies
  • 192 views

Yoeri
Forum|alt.badge.img+4
  • Gainsight Employee ⭐️⭐️⭐️

Writing Product Updates will help you bridge the transparency gap between you and your customers. In this article we’ll share some best practices and tips around sharing Product Updates:

 

When to write a Product Update

There are various different scenario’s to write a product updates, you can write a product update around:

  • Announcements
  • Releases
  • Improvements
  • (Bug)Fixes
  • Changelogs
  • Roadmap updates

 

General best practices

  • Use a title that speaks the voice of your users
  • Add a featured hero image and label that relates to the content
  • Discussing a specific product? Add a related product that relates to the content
  • Are you giving an update on a specific customer idea that one of your users requested? Link product updates & new features to specific customer ideas
  • Is the product update more complex? Then include a short FAQ at the end that covers the most important questions your users probably will have after reading it.
  • Use Callouts to draw attention to important information
  • Use Pills to summarise short bulleted lists
  • Invite your users to reply with their feedback on the subject