Ordering docs and categories
Set the order of docs and categories so your help centre reads in a logical sequence, from first steps to advanced tasks, instead of alphabetically.
📷 Image placeholder: the docs sidebar with categories and docs in a custom order.
Order docs within a category
Each doc has an Order number. Docs with lower numbers appear higher in the sidebar and on category pages.
Open the doc
Open the doc in the editor.
Set the order
In the Settings sidebar, find Order and enter a number. Use 1 for the first doc, 2 for the second and so on.
📷 Image placeholder: the Order field in the doc Settings sidebar.
Update the doc
Click Update, then repeat for the other docs in the category.
Order categories
Open Categories
Go to PinkDocs → Categories.
Set the category order
Set the order of each category, either by dragging categories into position or by entering an order number for each one.
📷 Image placeholder: the Categories screen with categories being reordered.
Check your homepage
Open your docs homepage and sidebar to check the new order.
Suggested order
| Position | Category | Why |
|---|---|---|
| 1 | Get Started | New users look here first. |
| 2 | Customise | Most users set up their look next. |
| 3 | Features | Readers explore features once set up. |
| 4 | Troubleshooting or Miscellaneous | Reference content readers search for when needed. |
Order docs for a reading path
Within each category, order docs the way a reader would work through them:
- Put overview or introduction docs first.
- Follow the order of a real setup, such as install, configure, publish.
- Put advanced or optional tasks last.
Common questions
They're sorted by publish date. Give each doc a different number for a predictable order.
No. Search results are ranked by relevance to what the reader typed.
