We're busy updating our docs, some areas (especially Settings) may be out of date
Skip to main content
Support

Understanding Stale

Use Stale marking to flag outdated articles needing review. A soft reminder system that tracks content drift, prevents gaps between product and docs, and sends weekly freshness reports.

River Sloane
Updated by River Sloane
2 min read
Table of Contents

Ever feel like your documentation is playing catch-up with your product updates? Stale is your workflow for flagging outdated articles, even when you don't have everything ready to fix them yet.

Think of it as an advanced Post-it note for your Knowledge Base. You spot something out of date, stick a note on it, and move on. Your future self (or your team) can sort it out later (hopefully!).

When and Who Should Use Stale

Team

When to Mark as Stale

Support

Customer reports outdated information

Engineering

Features mentioned in articles get updated or removed

Content Teams

Scheduling content reviews in upcoming sprints

Anyone

Spotting outdated info without having update details ready

Spotting Stale Content

A Stale badge will appear on the article row. If your article has a Stale reason, hover over the badge to read your note.

Example Stale badge with a reason.
  • When your article is currently Stale, a Stale notification will appear alongside your article status dropdown.
  • If the article is due to go Stale in a set amount of time, the Set Stale button Set stale button with time to Stale displayed will display the time left until it does.

  1. Inside Home, click the x stale articles pill
  2. This will filter and show you any articles marked as Stale
Knowledge Base dashboard showing tabs for drafts, working copies, and stale articles.

Weekly Email Reports

Automated email reports help you keep content fresh without constantly checking by hand. Each weekly report shows:

  • Total count of Stale articles
  • New and existing Stale articles, alongside how long they've been Stale for
An example Stale weekly email

To enable weekly reports:

  1. Head to Profile (or click here)
  2. Toggle on Send me weekly Stale emails
  3. Hit Save Changes

Next Steps

Once you've updated the content, you'll want to mark your articles as Fresh to peel off the Post-it.

Ready to leave your first note? Learn how to mark articles as Stale πŸ“

What did you think of this doc?

Next Marking an Article as Fresh

Get in touch