Top Navigation Bar

The top navigation bar can be customised in multiple ways:

• Logo

• Bar colour (brand colour) and navigation links colour

• Links

• Stickiness

• Navigation Structure

Navigation Structure

By default, the top navigation hosts a list of tabs. Starting with the Home tab which goes to the landing page, and then a tab for every documentation section and API reference.

The navigation structure can be further customised to feature navigation groups; a way for multiple documentation sections and API references to be grouped together under a dropdown.

To use navigation groups, first they need to be created. Then, documentation sections and API references can be assigned to navigation groups.

To create a navigation group:

1. Open Project Settings → Content → Navigation Groups.

2. Click Create navigation group.

3. Give it a title and click Create.

You can reorder the navigation groups as needed here.

Now to assign a documentation section or an API reference to the navigation group:

1. Open Manage Sections (section menu → settings cog).

2. Select the documentation or API reference.

3. Next to Navigation Group, assign a navigation group.

Adding Links / Home Button

The logo, and four top navigation links can be setup for external linking to another website, or internal linking inside the documentation. To setup the navigation links:

1. Open Project Settings → Customisation.

2. In the Top navigation links card, type the title and link for each of the four slots.

3. Use the Open links in new tab toggle to choose whether links open in a new tab.

4. Click Save changes in the top menu.

The last two links only show in documentations that have wide layout.

Sticky Top Navigation Bar

To set the top navigation bar to stick to the top when page is scrolled:

1. Open Project Settings → Customisation.

2. Check Is top navigation bar sticky?.

3. Click Save changes in the top menu.