Configuration

In your sites root folder you will find a file called config.toml. Open this file with your text editor or IDE.

Sitewide configuration

  • At the very top you will see a baseURL field for your site URL. Add your sites URL here.
  • languageCode - define your global site language. This setting is independent from the i18n-setup you might add later on.
  • The summaryLength decides how many words are in excerpts of your posts when they are displayed as preview. The default summaryLength is 70 words.
  • theme sets up the used theme. If your theme is located in /themes/themename then the value for this parameter is themename.

    If you use theme components you can change this parameter to the following format:

    themes = ["theme1", "theme2", "themename"]
    

    Make sure, that your theme is the last item in this list. Hugo will load these themes and module from the left and files with identical names will be overwritten subsequently.

  • title is for your site’s title.

Plugin Configuration

You can add third party plugins from here very easily, We create a loop for plugins, you will see two plugins loop here, first one is for css and last one is for js. just copy a loop item that you need and paste it in the bottom of the loop. and link correctly, after added a plugins, you maybe need to close the hugo server and run it again for rendered correctly.

  • [[menu.main]] is the main loop, you can add your navigation item by copy and paste this line.
  • name attribute is for navigation item name.
  • URL is for the page url, just give the page name here, it will automatically add the base URL from your site. like if you want to give the about page url here, just type about .
  • weight is for your navigation sorting, the smaller number weight will show first.

Parameter Configuration

Most parameters in config.toml are commented. You can change the basic setup of the theme and add information or enable/disable features.

  • description field is for your default meta description, it will show on your homepage and other page that have not any meta description on this page front-matter.
  • author is for site author name.
  • contact_form_action is your contact form action. it works with https://formspree.io
  • copyright is your site copyright.
Improve this page on Github  — Last updated:  Mon, Jan 25, 2021