Option to hide icons in sidebar while keeping icon field in frontmatter

[F0rgenet]

What problem will this feature address?

I'm using the icon field in MDX frontmatter for internal metadata and custom components, but I don't want icons to appear in the left sidebar navigation. Currently there's no straightforward way to keep icon data in frontmatter while disabling its rendering in the sidebar.

Describe the solution you'd like

Add a configuration option in DocsLayout sidebar settings to disable icon rendering, for example:

sidebar: {
  hideIcons: true
}

Or a way to filter/transform sidebar items without affecting the underlying page tree metadata.

Describe alternatives you've considered

• Manually overriding sidebar rendering
• Not using icon field in frontmatter (but need it for other purposes)

Additional context

No response

[fuma-nama]

would be better to use another name for your icons, like name your property customIcon, otherwise it will conflict with default frontmatter schemas.

[F0rgenet]

Overlooked this, thanks :D

I think it should be an option tho

[fuma-nama]

it's always possible with a loader plugin, while the icon property is part of the types and may cause breaking changes if we want to change it, would prefer user-land customisations for now.

[F0rgenet]

I am trying to access a custom frontmatter field (e.g., iconLocal) when iterating over siblings using findSiblings or traversing the pageTree

Currently, the node object in the page tree only contains standard fields, and my custom frontmatter values are undefined on the tree nodes

---
title: My Page Title
description: Some description
iconLocal: FileCog
---

import { findSiblings } from "fumadocs-core/page-tree";
import { source } from "@/lib/source";

// ... inside component
const siblings = findSiblings(source.getPageTree(), targetUrl);

siblings.map((peer) => {
   // peer.iconLocal is undefined here
   console.log(peer.iconLocal); 
});

[fuma-nama]

You can make a loader plugin to extend page tree https://www.fumadocs.dev/docs/headless/source-api/plugins#page-tree