Skip to main content
On this page

Site Parameters

These parameters are defined in the [params] section of hugo.toml and control the overall behavior and appearance of the website.

[params]
  sidebarCollapsed = false
  sidebarCachedRender = false
  [params.sidebars]
    [params.sidebars.tutorial]
      section = "tutorial"

    [params.sidebars.how-to]
      section = "how-to"
OptionSub-optionDescription
sidebarCollapsedControls whether the sidebar is collapsed by default
sidebarCachedRenderEnables cached sidebar rendering for improved build performance on large sites
sidebarskeyDefines multiple sidebar configurations, where the key is a dictionary label
sectionSpecifies the root section of the sidebar (Logical path)

Cached Sidebar Rendering

For large documentation sites, enabling sidebarCachedRender can significantly improve build performance:

  • Uses Hugo’s partialCached functionality
  • Removes dynamic active states from HTML
  • JavaScript handles all interactive logic
  • Single cached version per section
  • Recommended for sites with 100+ pages

Header Configuration 

[params.header.logo]
  light = "images/logo.png"
  dark = "images/logo-dark.png"
  alt = "Logo alt text"
  text = "Text Logo"

[[params.header.social]]
  name = "GitHub"
  url = "https://github.com"
  icon = '<svg>...</svg>'
OptionSub-optionDescription
header.logolightPath to logo image for light mode
darkPath to logo image for dark mode
altAlt text for SEO
textWebsite title text
urlLink when clicking the logo
header.socialnameSocial platform name
urlSocial profile link
iconSVG icon for the platform
[[menus.main]]
  name = 'Search'
  weight = 60
  [menus.main.params]
    type = "search"
OptionSub-optionDescription
menus.mainnameMenu name
weightMenu sorting weight
params.typeMarks the item as a search button
[params.footer.logo]
  text = "Website Name"
  image = "/images/logo.svg"
  alt = "Logo alt text"

[params.footer]
  description = "Website description"
  copyright = "© 2024 My Website"

[[params.footer.columns]]
  title = "Column Title"
  [[params.footer.columns.items]]
    name = "Link Name"
    pageRef = "/path"
    url = "https://..."
    external = true

[[params.footer.social]]
  name = "GitHub"
  url = "https://github.com"
  icon = '<svg>...</svg>'
OptionSub-optionDescription
footer.logotextLogo text
imageLogo image
altAlt text for SEO
footer.descriptionFooter description text
footer.copyrightCopyright statement
footer.columnstitleColumn title
itemsList of links within the column
footer.socialnameSocial platform name
urlSocial profile link
iconSocial platform icon

SEO Configuration 

[params]
  author = "Hugo Theme Deca Team"

[params.seo]
  default_og_image = "/images/og-default.png"
  default_twitter_image = "/images/twitter-default.png"
  google_site_verification = "your-verification-code"
  bing_site_verification = "your-verification-code"
  yandex_verification = "your-verification-code"
OptionSub-optionDescription
authorWebsite author information
seo.default_og_imageDefault Open Graph image
seo.default_twitter_imageDefault Twitter Card image
seo.google_site_verificationGoogle site verification code
seo.bing_site_verificationBing site verification code
seo.yandex_verificationYandex site verification code

Analytics Configuration 

[params.analytics]
  google = "G-XXXXXXXXXX"
OptionSub-optionDescription
analyticsgoogleGoogle Analytics 4 Measurement ID

Error Page Configuration 

[params.error404]
  title = "Page Not Found"
  description = "The page you are looking for does not exist"
OptionSub-optionDescription
error404title404 page title
description404 page message