Skip to content

Create and organize a map

Maps define the structure and navigation of your published documentation. Each map is an ordered, nestable collection of topics.

Create a map

  1. Go to Maps in the sidebar.

  2. Click New map.

  3. Enter a title (for example, "User Guide" or "API Reference").

  4. Optionally add a description.

Add topics to the map

Add topics from the Topic Pool left panel:

  1. In the map editor, open the Topic Pool left panel (click its panel icon, or when the map is empty use the "Open the left panel to add some" prompt).

  2. Search or filter the list of all project topics.

  3. Click a topic to add it to the map. Topics appear in the order you add them.

Reorder topics

Drag the grip handle on any item to move it up or down in the list.

Use drag-and-drop for quick reordering, and keyboard shortcuts for precise structural changes. Tab indents an item (nests it under the item above), Shift+Tab outdents it. Combining drag-and-drop with keyboard shortcuts is the fastest way to restructure a large map.

Create nested sections

  1. Select a topic in the map.

  2. Click the indent button (or press Tab) to nest it under the item above.

  3. Click outdent (or press Shift+Tab) to move it back up a level.

Nesting creates parent-child relationships. On the published site, parent items appear as expandable sections in the sidebar.

Right-click any map item to open a context menu with the common structural actions: open the topic, zoom in, indent, outdent, move up, move down, add a section heading, and remove the item. Most show their keyboard shortcut.

Add section headers

Section headers are map items without an associated topic. They serve as group labels in the navigation.

To create a section header, add a map item and leave it without a linked topic. Give it a descriptive title like "Getting Started" or "Advanced Configuration."

Section headers appear in the published site's navigation sidebar but do not have their own page. Clicking a section header in the sidebar expands or collapses its children. If you want a section to have its own landing page, link it to a topic instead.

Override topic titles

By default, a map item displays the topic's title. To show a different title in this map's navigation:

  1. Click the title text of any map item.

  2. Edit it inline.

  3. The override applies only to this map. The topic's original title is unchanged.

AI-powered organization

Use the AI organize action to have Claude analyze your topics' content, cross-references, and community clusters, then suggest a hierarchical tree structure for your map. This is especially useful when starting a new map from a large pool of unorganized topics or when restructuring an existing map after significant content changes.

  1. Open the map editor.

  2. Click AI organize in the toolbar.

  3. Review the suggested structure. You can accept it as-is, adjust individual items, or discard it entirely.

Manage versions

Maps support versioning for maintaining different editions:

  1. In the map editor, click the version label in the header.

  2. Create a new version with a label (for example, "v2.0").

  3. Each version can use different condition profiles and variable sets when published.

See also

Was this page helpful?