Basic Configuration

In the root folder you will find a file called config.toml open this file in any text editor or IDE.

If your theme is not launched in your localhost, then check the theme name is correct in configure.toml file. Then run hugo server command again.

Default configuration

In this project folder, you will find a file called config.toml. Open this file in any text editor or IDE.

  1. baseURL field for your website URL / domain. Add your site URL here. Remember, you need to add a trailing slash at the end of the URL.
  2. languageCode defines your global site language. For more information, see Official Hugo Docs.
  3. title is for the main title of your website.
  4. theme sets up the used theme. If your theme is located in my-project/themes/theme-name folder, then the value for this parameter is theme-name.
  5. summaryLength decides how many words are in excerpts of your posts when they are displayed as a preview. The default summaryLength is 70 words.
  6. paginate set the number of posts shown on blog overview pages. If you have more than this amount of posts, pagination will be visible to navigate the next set of posts.
  7. disqusShortname add your Disqus shortname to enable comments on the blog section. To install Disqus please follow this tutorial.
  8. googleAnalytics add your Google Analytics ID to enable analytics on all pages. # example: UA-123-45. For more info, read the article. If you want another third-party analytics, you can contact us for custom service.

Default Parameters

In this project folder, you will find a file called config.toml. Open this file in any text editor or IDE.

  1. favicon is for your website favicon. Place your favicon in the assets/images folder and put the path here.
  2. logo is for your website logo. Place your logo in the assets/images folder and put the path here.
  3. logo_width defines the width of the logo in pixels. It doesn’t work with .svg file.
  4. logo_text will only appear if the logo parameter is missing.
  5. description is for your default meta description. It shows on your homepage and other pages that have no meta description on this page front-matter.
  6. author is for the website author name. It is used in the meta author tag.
  7. image is used as the fallback for open graph and twitter card if a page has no image of its own.
  8. contact_form_action is for activate your contact form. As Hugo generates a static site, so you need to activate this form by a third-party service. You can use any of them Airform, formspree, or Formsubmit. Go to any of the sites that you preferred, and get your form action from there. Then, paste it here. If you use Airform, your form action will be like this: https://airform.io/your@email.com.
  9. mainSections defines the section names that you want to show on your website. It’s an array, so you can add more sections to show. For more information, see Official docs.
  10. contact_info has some filed (like phone, email, and address) to show your contact information in the footer and contact page.
  11. preloader is for your website preloader, which means it will show up until your website loads properly in the background. You can enable or disable preloader by setting the value of enable as true or false. If you want to put any image, logo, or animation as your preloader, give the file location in the preloader = , ex: preloader = images/preloader.gif. If you don’t want any logo or image, leave the preloader field empty. So it will show just a white screen when every component is loading.
  12. social is a loop item for your website’s social icons. You can add a loop item by following the existing loop. We are using Line Awesome icon pack for this theme. You can choose more icons from here

Sitewide configuration

  1. baseURL field for your website URL / domain. Add your site URL here. Remember, you need to add a trailing slash at the end of the URL.
  2. languageCode defines your global site language. For more information, see Official Hugo Docs.
  3. title is for the main title of your website.
  4. theme sets up the used theme. If your theme is located in my-project/themes/theme-name folder, then the value for this parameter is theme-name.

Plugins

You can add third party plugins from here. We created a loop for plugins. You will see two plugins loop already implemented. The first one is for css and second one is for js. Copy a loop item that you need and paste it in the bottom of the loop. After you added a plugin, you need to restart the hugo server to render properly.

Default Parameters

  1. Logo field is for your site logo, you can set a default logo for your site, give here the logo directory.
  2. Home is for home in your navigation.
  3. 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.
  4. author is for site author name.
  5. gmapAPI field is for google map API key, replace your won gmap API key with it.
  6. mapLatitude and mapLongitude field is for your google map location. you can find this here http://maps.google.com
  7. mapMarker is for your map pointer, you can set your won map pointer that you want to shaow, maintain the png image size with ( 62*85) px.
  8. googleAnalitycsID is for turn on google analytics on your site, give your won analytics ID here.
  9. preloader is for site preloader, it’s default value is true, but if you don’t want it, you can false it.
  10. FormAction is for contact form action url. contact form works with formspree
Improve this page on Github  — Last updated:  Thu, Sep 9, 2021