Navigation Menu Bar Troubleshooting

Navigation Menu Bar Troubleshooting

Problem: Menu item not appearing on website

Solution:

• Verify the item is marked as Active (green status badge)
• Check that parent item (if any) is also active
• Clear browser cache (Ctrl+F5 or Cmd+Shift+R)
• Clear server cache: php artisan cache:clear
• Verify the item's sort order is within visible range
• Check that your theme properly renders navigation items
• Ensure navigation cache is cleared (happens automatically on save)

Problem: Cannot create 3rd level menu item

Solution:

• Verify the parent item is at level 1 (child of top-level item)
• The system enforces a 3-level maximum depth
• Check that you're selecting the correct parent
• If parent dropdown doesn't show the item, it's already at level 2
• Consider restructuring your menu to stay within 3 levels

Problem: Drag-and-drop reordering not working

Solution:

• Ensure JavaScript is enabled in your browser
• Check browser console for JavaScript errors
• Refresh the page and try again
• Verify you're clicking the drag handle icon (not the item itself)
• Try using manual sort order editing as alternative
• Check that SortableJS library is loaded
• Clear browser cache and reload

Problem: Link goes to wrong page or shows "#"

Solution:

• Verify URL is correctly formatted (include "/" for internal links)
• For external links, include full URL with "https://"
• Check that route name exists in your routes file
• Verify route parameters are valid JSON format
• Test the URL directly in browser address bar
• Check for typos in URL or route name
• Ensure the destination page/route exists

Problem: Cannot set item as child of another item

Solution:

• Check that target parent is at level 0 or 1 (not level 2)
• Verify you're not trying to create circular reference (item as its own parent)
• Ensure you're not setting a parent as child of its own descendant
• Refresh the page to reload parent options
• Check that parent item exists and is not deleted

Problem: Icon not displaying

Solution:

• Verify icon identifier is correct
• Check that IconHelper class can resolve the icon
• For custom SVG, ensure SVG code is valid
• Clear browser cache
• Check browser console for errors
• Verify icon field was saved (check database)
• Ensure theme properly renders icons

Problem: Changes not saving

Solution:

• Check for validation errors (red text under fields)
• Ensure required fields (Title, Target) are filled
• Verify URL doesn't contain dangerous protocols (javascript:, data:, file:)
• Check for path traversal attempts (../) in URL
• Look for error messages at top of page
• Check browser console for AJAX errors
• Verify CSRF token is valid (refresh if session expired)
• Check server error logs for PHP errors

Problem: Deleted item still appears in navigation

Solution:

• Clear browser cache completely
• Clear server cache: php artisan cache:clear
• Check that deletion was successful (item removed from list)
• Verify navigation cache was cleared
• Check if item is cached by CDN (clear CDN cache)
• Refresh the page in incognito/private mode

Problem: Search bar or theme toggle not appearing

Solution:

• Verify the feature is enabled in Navigation Settings
• Click "Save Settings" after enabling
• Clear browser cache
• Check that your theme supports these features
• Verify settings were saved to database
• Check browser console for JavaScript errors
• Ensure theme template includes these components

Problem: Circular reference error when editing

Solution:

• You're trying to set an item as parent of its own ancestor
• Choose a different parent that's not a descendant
• Set parent to "No Parent (Top Level)" to break the cycle
• Review your menu structure to understand relationships
• Cannot set item as its own parent (direct or indirect)

Problem: Menu order changes not persisting

Solution:

• Ensure drag-and-drop completed successfully (look for success message)
• Check browser console for AJAX errors
• Verify CSRF token is valid
• Try manual sort order editing instead
• Refresh page to see if changes were actually saved
• Check network tab for failed API requests
• Verify database connection is working