Docs
← Back to site

Status Badges: New, Updated, Beta, Deprecated

1 min readUpdated October 29, 2026

A status badge is a small colored pill next to a doc’s title, letting readers know at a glance whether it’s new, recently updated, still in beta, or deprecated.

Setting a status#

  1. Open a doc for editing.
  2. In the Doc status panel in the sidebar, choose a status from the dropdown.
  3. Update or publish the doc.
The Doc status panel in the editor with the badge options.

Available statuses#

StatusColorSuggested use
NewGreenRecently published docs
UpdatedBlueAfter a significant rewrite
BetaPurpleFeatures still in development
DeprecatedRedWarn readers away from outdated content
None (default)No badgeNo badge shown

These four are the only statuses available; there’s no way to add a custom one.

Where the badge appears#

Once set, the badge shows in two places:

  • Next to the doc’s title on the doc page itself
  • Next to the doc’s link in the sidebar navigation
A New badge next to a doc in the sidebar and on the doc title.

Clearing a badge#

Set the dropdown back to None and update the doc. This removes the badge entirely rather than leaving an empty one.

Was this helpful?

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only