_meta.js Reference

Every folder can have a _meta.js file to control how its pages appear in the sidebar.

Basic usage

export default {
  "index": "Overview",
  "getting-started": "Getting Started",
  "configuration": "Configuration"
}

• Keys are the filenames (without .mdx)
• Values are the display names in the sidebar
• Order in the object determines sidebar order

Important rules

Pages not listed are hidden

If a page exists as an .mdx file but isn’t in _meta.js, it won’t appear in the sidebar (but is still accessible by URL).

External links

You can add external links to the sidebar:

export default {
  "index": "Overview",
  "github": {
    "title": "GitHub",
    "href": "https://github.com/your-repo",
    "newWindow": true
  }
}

Separators

Add visual separators between groups of pages:

export default {
  "index": "Overview",
  "-- User Management": {
    "type": "separator",
    "title": "User Management"
  },
  "create-users": "Create Users",
  "delete-users": "Delete Users"
}

Hidden pages

To keep a page accessible by URL but hidden from the sidebar, simply don’t include it in _meta.js.

Folder display names

To set a display name for a folder, add it to the parent folder’s _meta.js:

export default {
  "microsoft-365": "Microsoft 365",
  "bash-and-linux": "Bash & Linux"
}

The folder microsoft-365/ will display as “Microsoft 365” in the sidebar.