Front Matter
Per-page overrides for everything that matters.
These parameters are set in the front matter of any page.
They take precedence over the equivalent site-level parameters defined in config.toml.
Metadata
| Parameter | Type | Description |
|---|---|---|
| author | string | Name of the blog post author. |
| description | string | Built-in Hugo parameter. Used as the <meta name="description"> value in the page <head>. Takes priority over the Summary parameter. |
string | Email address of the blog post author. Falls back to the site-level author email, then to no+reply@eclipse-foundation.org if neither is set. | |
| image | url | Fallback image URL for the page. Used as the social sharing thumbnail when share_img is not set. |
| keywords | string[] | Keywords used in the <meta name="keywords"> tag in the page <head>. |
| seo_title | string | The SEO-optimized title used in the <title> tag and social metadata. The site-level seo_title_suffix is appended when set. |
| share_img | url | Image URL used as the thumbnail when the page is shared on social media (Open Graph / Twitter Card). |
| summary | string | Built-in Hugo parameter. Used as the <meta name="description"> value when Description is not set. |
Layout
| Parameter | Type | Description |
|---|---|---|
| body_class | string | One or more CSS classes to add to the <body> element of the page. |
| breadcrumb_title | string | Custom label to display in the breadcrumb for this page. If not set, the page title is used. Values longer than 32 characters are truncated. |
| container | string | Overrides the default container CSS class applied to the main content wrapper. |
| header_wrapper_class | string | CSS class appended to the header-wrapper element. Overrides the site-level value of the same parameter. |
| hide_breadcrumb | boolean | Hides the breadcrumb navigation on this page. |
| hide_call_for_action | boolean | Hides the call-to-action (CTA) button in the navbar on this page. |
| hide_page_title | boolean | Hides the rendered <h1> page title. |
| hide_sidebar | boolean | Hides the main content sidebar on this page. |
| show_featured_footer | boolean | Shows the featured footer section at the bottom of the page. |
Jumbotron
| Parameter | Type | Description |
|---|---|---|
| custom_jumbotron | string | Custom HTML content injected after the tagline inside the jumbotron. Using this together with tagline is not recommended. |
| custom_jumbotron_class | string | CSS class applied to the custom_jumbotron wrapper element. |
| headline | string | Renders a jumbotron in the header with this text as the headline. Also used as the page <title> when seo_title is not set. |
| links | {href: string, text: string, class?: string, id?: string}[] | Buttons rendered below the tagline in the jumbotron. Each entry defines the button label and its target URL. |
| tagline | string | Optional text displayed below the jumbotron subtitle. Using this together with custom_jumbotron is not recommended. |
Navigation
| Parameter | Type | Description |
|---|---|---|
| main_menu | string | Replaces the default main navigation menu with a menu defined under the given identifier in config.toml or menus.toml. |
| redirect_url | url | Sets a client-side redirect target. Used in the canonical URL and an instant-refresh <meta> tag. Pages with this parameter set are also marked noindex to prevent search engine indexing. |
| show_collapsible_menu | boolean | Shows the collapsible sidebar navigation menu on mobile viewports for this page. |
| sidebar | string[] | One or more menu identifiers used to populate the sidebar on this page, overriding the default sidebar for the section. Each identifier must correspond to a menu.sidebar entry in the site configuration. |
Resources
| Parameter | Type | Description |
|---|---|---|
| disable_css | boolean | Disables all theme CSS on the page when set to true. |
| page_css_file Deprecated | url | URL to an additional stylesheet to load on this page. |
| scripts | {url: string, type?: string, defer?: boolean, cache?: boolean, integrity?: string}[] | Page-level JavaScript files to load after the site-level scripts. Each entry is an object that describes the script tag to render. |
| styles | {url: string, cache?: boolean}[] | Page-level stylesheets to load after the site-level styles. Each entry is an object that describes the <link> tag to render. |