Basic Configuration

In this 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 config.toml file. Then run hugo server command again.

Sitewide configuration

  • At the very top you will see a baseURL field for your site URL. Add your sites URL here.
  • 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.
  • The summaryLength decides how many words are in excerpts of your posts when they are displayed as preview. The default summaryLength is 70 words.
  • DefaultContentLanguage - This field is for your site default language, which will load first with your site load.
  • disableLanguages field is for disable languages, if you don’t want to show one or more then one you can add the language name here, it will disabled those languages from your site. example disableLanguages = ["fr"] it will desabled french language from your site.
  • disqusShortname - add your disqus shortname to enable comments on the blog section.
  • googleAnalytics - add your Google Analytics ID to enable analytics on all pages


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.

Default Parameters

  1. Logo field is for your site logo, you can set a default logo for your site, just give here the logo directory.
  2. logo_width: define your logo width for perfect fit.
  3. menu_align: You can set it left, right, or center.
  4. 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.
  5. author is for site author name.
  6. Contact info has some filed to show your contact information in footer and contact page.
  7. contact_form_action is for contact form. it work’s with formspree.
  8. search can be disabled, if it has false value.
  9. featured_post: At the homepage, you can see a section at top, which is contain 3 types of post, This is the featured post section. If you don’t need it, you can set the value to false.
  10. sidebar has 3 different values, choose your favorite on from left, right or false. if you choose false, it will no longer visible.
  11. main_taxonomy: You can choose the main taxonomy which is showing at the banner and post card also. Your optional value is tag and category.
  12. post_layout: You have three different value to choose for your post layout.
  13. preloader is for site preloader, you can enable or disable preloader by enable = true or false, then if you want any image, logo, or animation in preloader then give the location in preloader = , like preloader = images/preloader.gif or if you don’t want any logo or image then leave the preloader field empty, then it will show just a white screen when every component is loading. that’s simple.
  14. social is for social icons. you can choose more icons from here
  15. Language is for multilingual content. we used two languages here. you can add more language following this example content.
  16. instafeed: You can set the value to false if you don’t want to show it. We provide some static image with the theme, but whenever you give the access token it will automatically show up the original image from your instagram.
  17. [params.subscription] is for user subscription database. We used mailchimp service for our theme development. Replace your own subscription form action URL in mailchimp_form_action field, and your form name in mailchimp_form_name field. You can get your action URL and form a name from here (after login or signup).
  18. widgets: All sidebar widgets are customizable. Here is the available widgets that we provided with the theme search,about-me,authors,categories,tags,recent-post,social,promotion,subscription
  19. promotion is a sidebar widget, you can change the content and link from here.
  20. about_me is also a sidebar widget. It’s for single author user. You can change the content from here. [this section is under the language, because it could be multilingual]
Improve this page on Github  — Last updated:  Mon, Jan 25, 2021