Markdown versions of all docs pages are available by appending .md to any docs URL.
Logo placement
The navbar, sidebar and footer logo slots, and the mobile drawer.
Three optional logo slots, each set independently in a consumer’s config. The theme renders whatever each points at — the placements below are convention, not enforced by the theme.
| Param | Slot | Rendered by |
|---|---|---|
params.navbar.logo | Top navbar (path, dark, width, height, link) | navbar-title.html |
params.sidebar.logo | Desktop sidebar header, and the mobile slide-out drawer | sidebar.html |
params.footer.logo | Footer (path, dark) | footer.html |
Common arrangements
- Product mark in the navbar (OSS shape): set
navbar.logoto the product lockup and leavesidebar.logounset. The navbar mark then shows at every breakpoint. - Product in navbar, corporate mark in footer (enterprise target): set
navbar.logoto the product lockup andfooter.logoto the corporate (Solo) mark, with nosidebar.logo. - Product in sidebar, corporate mark in navbar (older enterprise): set
navbar.logoto the corporate mark andsidebar.logoto the product lockup.
The mobile slide-out drawer logo
Below the sidebar breakpoint (xl, 1280px) the persistent sidebar becomes the
slide-out drawer, and the theme pins a logo to the top of it — where the navbar
logo would sit, since the open drawer covers the navbar’s left region. It uses
sidebar.logo if set, otherwise falls back to navbar.logo, so a site that only
configures a navbar logo still gets a drawer mark.
Details worth knowing:
- The drawer logo is centered and sized by an explicit
height(28px), notmax-height— the logo SVGs carry only aviewBox(no intrinsic width/height), which would otherwise collapse amax-heightimage to 0×0. - The desktop sidebar header logo (
.sidebar-product-logo) is hidden belowxl(the drawer logo replaces it), so on a site withsidebar.logoset you never see both at once. It sizes the navbar logo from thewidth/heightparams directly, so adjust those to resize it. - When
sidebar.logois set, the navbar logo is desktop-only (the sidebar/drawer logo covers mobile); when it is not, the navbar logo shows at all breakpoints.
Nothing here is tied to docTabs — logos and tabs are independent features.