add-to-nav

To add a new page to Mintlify docs.json navigation, you provide the page path, the Insert operation, and the target location, which automatically places the article under the correct tab and group while validating the JSON structure.

To move an existing page to a different tab in docs.json, you specify the page path, the Move operation, and the target location, which relocates the article while preserving the overall navigation structure and order.

Manually editing docs.json navigation often breaks documentation because JSON syntax errors and misplaced structural elements easily occur during insert or move operations, disrupting the coherent navigation structure.

To update Mintlify navigation structure successfully, you need to provide the exact page path, the specific operation type whether Insert or Move, and the precise target location within the docs.json file.

Updating docs.json navigation validates the JSON structure automatically, ensuring that inserting new pages or relocating existing ones maintains a valid and coherent navigation structure without breaking the file.

You can register a new article into an existing group in docs.json without breaking the order by using the Insert operation with a specified target position, which maintains the sequence and validates the navigation structure.