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 Roundup Email

The weekly roundup lands once a week. Stale articles show up in its Stale section, so you can keep content fresh without checking by hand.

The Stale section is only included for people who have permission to receive Stale emails.

Who gets it:

  • People who join from now on start with the roundup switched on.
  • If you have chosen a setting (in your profile or with the email's unsubscribe link) you get what you chose.
  • If you haven't chosen, the roundup follows your old weekly Stale email setting.

To switch the roundup on or off:

  1. Head to Profile (or click here)
  2. Toggle Weekly roundup on or off
  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