Drag-and-Drop Nav Builder
This doc covers the actual mechanics of the Navigation page’s drag-and-drop builder. For what auto mode vs. manual mode means and how they interact, see Auto-Generated Navigation vs. Manual Override first.
Placing a doc#
Drag a doc card from the All docs list on the left into a category bucket on the right. The card stays visible in the library afterward, now marked with a “placed” badge, rather than disappearing from the list. A doc that’s already placed can’t be dragged again from the library until it’s removed from wherever it currently sits.

A doc can only be in one bucket at a time#
If you drag a doc into a second category bucket, it’s automatically removed from wherever it was placed before. There’s no way to have the same doc listed in two categories through this builder.
Reordering within a bucket#
Drag a doc card by its handle (the ⋮⋮ icon) or by its title to move it up or down within the same bucket. This changes the order docs appear in that category’s sidebar section.
Removing a doc from a bucket#
Click the × button on a doc card inside a bucket. This returns it to an unplaced state (the “placed” badge disappears from its library card), rather than dragging it back to the library list.
Reordering categories#
Use the ↑ and ↓ buttons on a bucket’s header to move that whole category earlier or later in the sidebar. Categories aren’t reordered by dragging, only by these buttons.
Filtering the doc list#
If a product has a lot of docs, type into the Filter docs… search box above the library list. It filters by title as you type and only affects the library column; bucket contents are always fully visible.
Saving#
Click Save navigation. This saves over AJAX, without reloading the page, and the status pill updates to “Custom order, saved override” once it succeeds. If saving fails (for example, a network error), a message appears next to the button instead of silently failing.
Resetting#
Click Reset to auto mode. You’ll get a confirmation prompt warning that your custom layout will be lost, since this can’t be undone. Confirming reloads the page back into auto mode.
Was this helpful?
Thanks for your feedback!
✓ Feedback received. Thank you!