Table of Contents

Getting Started with Stale Articles

Jarratt Isted Updated by Jarratt Isted

As your product and company evolve, it's often difficult to keep your docs evolving at the same pace.

By marking articles as stale inside HelpDocs, your team knows exactly what needs updating even if they don’t have all the information they need right then to update it.

Once you update a stale article, it'll automatically remove the stale status. You can also do this from the content table.

When should I mark an article as stale?

Think of stale articles as a way of setting you and your team a reminder that some information needs updating. This can be particularly useful for meetings or updating sprints. 

You might want to set an article as stale if:

  1. A customer notices something is outdated
  2. You're an engineer changing or removing of a feature that article refers to
  3. You manage article writers and you'd like some information to be updated
  4. You know the information is outdated but don't yet have all the information to update it

How Do I Know If an Article is Stale?

There's a few ways to know whether an article is stale in-app.

Within the Content List

Stale articles will show up in the content list with a yellow badge next to the article status.

Within the Article Editor View

When you click on a stale article, it'll show a message in the top bar. Clicking it gives you the ability to mark it as Fresh or view/add a reason.

To learn more about marking an article as stale, head over to Marking an Article as Stale.

Get weekly email reports

You can quickly enable simple email reports that are sent weekly to get the lowdown on:

  • How many articles are stale in your dashboard
  • The articles that went stale this week
  1. Head to your profile (or click here)
  2. Toggle on Send me weekly stale emails
  3. Hit Save Changes

What did you think of this doc?

Marking Articles as Stale

Get in touch