Side Navigation FAQ and Troubleshooting
Direct answers for Zenpo Side Navigation. Shared list-load errors live on Common Error Messages. The error frame on this part is titled Couldn't load links. The retry button label is Try again.
Can Zenpo Side Navigation use a SharePoint list I already have?
Yes. It reads one SharePoint list and maps roles to your columns. Only Title is required. The web part never writes to that list. The only exception is the optional starter list you can ask it to create.
How do I control the order of the navigation links?
The bound View sets the order. There is no sort setting anywhere in this web part, by design: The view sets the order the links appear in — there is no separate sort setting.
Can I create parent and child links?
Yes. Map the Parent / Group role, then set Sub-items to Expand in place. Child links are displayed when nesting is enabled. Nesting is one level.
If you used the starter list and only 6 of 8 rows appear, set Sub-items to Expand in place. The two child rows stay hidden until nesting is on.
How does current-page highlighting work?
The row matching the page the reader is on gets an accent rail and is marked as the current page for assistive technology. Matching ignores differences in query strings, anchors, trailing slashes, and letter case. Turn it off with Highlight current page.
Can several pages share one navigation list?
Yes. That is the intended pattern. Add the web part to each page and point it at the same list. Edit the list once and every page showing it stays current.
Can a row be a heading rather than a link?
Yes. A row with no link, or an unusable one, renders as a non-interactive header row.
What happens on a phone?
At 640 pixels of viewport width and below, the rail collapses to a single 48-pixel header row that expands into a text-first list. There are no tiles or descriptions. The current page's parent opens automatically. There are no mobile-specific settings to configure. If Heading is empty, the collapsed row shows Side Navigation.
How do I hide a link without deleting it?
Map the Active role and leave Show only active items on. Toggling it never reloads the list.
Why are there no links yet?
Editors see No links yet and Connect a list in the web part properties, or create a starter list with sample links to begin.
Readers see The connected list has no links to show yet.
If Title is unmapped: Choose which column holds the link label. Edit the web part and set Title under Field mapping.
A source over 500 items is refused: This source contains more than 500 items. Use a filtered view so readers get a rail they can actually scan.
If the list cannot be loaded, the frame reads Couldn't load links. Use Try again. Typical causes (access lost, renamed list, throttling, view threshold) are on Common Error Messages.