Navigation and Active States

Navigation Depth

The maximum navigation depth determines how many sitemap levels are loaded.

Example:

  • Level 1: About
  • Level 2: Blog
  • Level 3: Blog Article

A depth of 2 displays About and Blog but does not display the individual blog article. A depth of 3 displays all three levels.

Standard Concrete CMS Attributes

The block respects the standard page attributes.

Exclude from Nav

The page itself is omitted from navigation.

Exclude Subpages from Nav

The page remains visible, but its child pages are not loaded into navigation.

This attribute is a common reason why a page appears in a mega menu without its child pages.

Package-Specific Child Navigation Setting

Top Navigation Bar PLUS also provides a package-specific setting for hiding child pages.

When Hide Child Pages is enabled for a page, the page itself remains visible, but its descendants are not rendered by the block.

Active Navigation Path

Top Navigation Bar PLUS highlights the complete navigation path.

When the current page is:

About
└── Blog
    └── Article

the navigation can mark:

  • About as an active parent
  • Blog as an active parent
  • Article as the current page

The current page receives:

class="active"
aria-current="page"

Accessible parent pages receive:

class="active nav-path-selected"

Parent pages do not receive aria-current, because they are not the currently displayed page.

Active-path behavior applies to:

  • Top-level navigation
  • Standard dropdowns
  • Mega menus
  • Mobile navigation

The visual appearance of active links is primarily controlled by the active frontend theme.

Permissions

The navigation respects Concrete CMS page permissions.

A page is omitted when the current visitor is not allowed to view it, unless the block is explicitly configured to ignore page permissions.

Troubleshooting Missing Pages

When a page does not appear, check:

  1. The configured navigation start page
  2. The maximum navigation depth
  3. Page permissions
  4. Exclude from Nav
  5. Exclude Subpages from Nav
  6. Top Navigation Bar PLUS – Hide Child Pages
  7. Concrete CMS cache