Docs
← Back to site

Drag-and-Drop Nav Builder

2 min readUpdated October 29, 2026

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.

The drag-and-drop nav builder with docs placed in category buckets.

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?

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