Troubleshooting

A Page Does Not Appear in Navigation

Check:

1. The page is below the configured navigation start page
2. The maximum navigation depth includes the page level
3. The current visitor has permission to view the page
4. Exclude from Nav is disabled
5. Exclude Subpages from Nav is disabled on the parent page
6. Top Navigation Bar PLUS – Hide Child Pages is disabled on the parent page
7. The Concrete CMS cache has been cleared

A Page Appears but Its Children Do Not

The most common causes are:

• Maximum navigation depth is too low
• Exclude Subpages from Nav is enabled on the parent
• Top Navigation Bar PLUS – Hide Child Pages is enabled
• Child pages use Exclude from Nav
• The current visitor lacks page permissions

A Mega Menu Is Cut Off

Automatic and custom-width menus are normally constrained to the visible browser area.

Check:

• The browser has been reloaded after clearing the cache
• Site-specific CSS does not apply overflow: hidden to the navigation area
• The theme does not transform or clip the navbar container
• The configured custom width is reasonable
• The browser zoom level is not unusually high

Content Container Width Is Incorrect

Check the configured content-container CSS selector.

The default is:

.container

Use a selector that identifies a visible content wrapper in the active theme.

Examples:

main .container

.site-content > .container

Dropdown Styling Looks Different

Standard dropdown styling comes from the active frontend theme.

Mega menus also inherit the theme's fundamental dropdown styles.

Differences may occur when the theme targets only very specific standard-dropdown markup.

Review site-specific theme CSS before overriding package styles.

Active Navigation Is Not Visible

The block adds active classes to the current page and its parent path.

The final visual appearance depends on the frontend theme.

Ensure the theme defines a visible state for:

.nav-link.active
.dropdown-item.active

Parent pages additionally receive:

.nav-path-selected

Community Store Cart Does Not Appear

Check:

1. Community Store 2.7.0 or newer is installed
2. Cart integration is enabled in the block
3. A valid cart page is configured
4. Community Store frontend assets are loading
5. The browser console does not contain JavaScript errors

Cart Values Do Not Update

Check:

• Community Store frontend events are available
• Popup-cart assets are loaded when popup behavior is enabled
• No JavaScript error prevents the update listener from running
• The block output is not being cached by another optimization layer

Language Switching Is Missing

Check:

• Multilingual site sections are configured
• The current page belongs to a multilingual section
• The visitor can access translated pages
• Language switching is enabled in the block
• Concrete CMS cache has been cleared

Account Links Are Missing

For automatic account navigation, check:

• The /account page exists
• Child account pages are accessible
• Exclude from Nav is disabled
• The user has permission to view those pages

For manual navigation, check:

• A valid internal page or external URL is configured
• The URL uses an allowed scheme
• The link is enabled

Stack Content Does Not Appear

Check:

• A stack is selected
• The visitor can view the stack
• The visitor can view the contained blocks
• The stack contains published blocks
• A localized stack exists when a translated variant is expected
• The current device is desktop, because stack content is hidden on mobile

Changes Are Not Visible

Clear:

• Concrete CMS cache
• Browser cache

Then reload the page using a full refresh.

The Navigation Breaks on Mobile

Check:

• The theme is Bootstrap 5-compatible
• Required frontend navigation JavaScript is loaded
• No theme script replaces Bootstrap dropdown behavior
• No custom CSS forces desktop mega-menu layout below the desktop breakpoint

Transparent Navigation Has Poor Contrast

Use:

• An alternative transparent logo
• Theme-specific transparent navigation colors
• A darker or lighter hero background
• Site-specific CSS for links and actions

Transparent presentation depends on the active theme and background content.