Status Badges: New, Updated, Beta, Deprecated
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#
- Open a doc for editing.
- In the Doc status panel in the sidebar, choose a status from the dropdown.
- Update or publish the doc.

Available statuses#
| Status | Color | Suggested use |
|---|---|---|
| New | Green | Recently published docs |
| Updated | Blue | After a significant rewrite |
| Beta | Purple | Features still in development |
| Deprecated | Red | Warn readers away from outdated content |
| None (default) | No badge | No 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

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?
Thanks for your feedback!
✓ Feedback received. Thank you!