# \#configuration

**URL:** https://discourse.gohugo.io/tag/configuration/15.md

[Latest](https://discourse.gohugo.io/latest.md) · [Categories](https://discourse.gohugo.io/categories.md) · [Tags](https://discourse.gohugo.io/tags.md)

---

## [Flag Icons in navbar (All browser)](https://discourse.gohugo.io/t/flag-icons-in-navbar-all-browser/57575)

<div class="topic-metadata">

**Author:** [@malde11](https://discourse.gohugo.io/u/malde11)\
**Replies:** 8\
**Last updated:** [September 23, 2026, 6:22pm UTC](https://discourse.gohugo.io/t/flag-icons-in-navbar-all-browser/57575 "2026-09-23T18:22:08Z")

</div>

Hi, I am looking for flags in my navigation to switch between english and german. The switch is working, but my flags are shown only on Windows 11 in firefox(156) and on mobile browser(Android 16/firefox and chrome). On…

---

## [Does asciidoctor needs a themes folder](https://discourse.gohugo.io/t/does-asciidoctor-needs-a-themes-folder/57464)

<div class="topic-metadata">

**Author:** [@kocheese](https://discourse.gohugo.io/u/kocheese)\
**Replies:** 3\
**Last updated:** [August 12, 2026, 6:26pm UTC](https://discourse.gohugo.io/t/does-asciidoctor-needs-a-themes-folder/57464 "2026-08-12T18:26:17Z")

</div>

Hello, To go from tutorials to my project I need to understand difference between template and themes. Since I used asciidoctor for two years I read many articles and somewhere grabbed the idea to launch hugo new projec…

---

## [Help GitHub/Git submodule keeps linking to a commit that does not exist?](https://discourse.gohugo.io/t/help-github-git-submodule-keeps-linking-to-a-commit-that-does-not-exist/56218)

<div class="topic-metadata">

**Author:** [@penne-not-pasta](https://discourse.gohugo.io/u/penne-not-pasta)\
**Replies:** 2\
**Last updated:** [November 6, 2025, 4:53pm UTC](https://discourse.gohugo.io/t/help-github-git-submodule-keeps-linking-to-a-commit-that-does-not-exist/56218 "2025-11-06T16:53:52Z")

</div>

im using this theme =\> GitHub - michaelneuper/hugo-texify3: A LaTeX-style hugo theme with the gruvbox color scheme for personal blogging for my blog =\> GitHub - penne-not-pasta/blog and it keeps linking a commit that do…

---

## [Split config: module.toml doesn't work, but module.yaml does](https://discourse.gohugo.io/t/split-config-module-toml-doesnt-work-but-module-yaml-does/55948)

<div class="topic-metadata">

**Author:** [@repsejnworb](https://discourse.gohugo.io/u/repsejnworb)\
**Replies:** 2\
**Last updated:** [September 22, 2025, 12:29pm UTC](https://discourse.gohugo.io/t/split-config-module-toml-doesnt-work-but-module-yaml-does/55948 "2025-09-22T12:29:14Z")

</div>

Ok so initially I was going to make a case stating that modules don’t seem to work with split config. Then for lols I tried making a module.yaml and was surprised to see it worked. I’ve made a simple example repo of my…

---

## [Path warnings for multilingual content fallbacks after v0.146.0](https://discourse.gohugo.io/t/path-warnings-for-multilingual-content-fallbacks-after-v0-146-0/55931)

<div class="topic-metadata">

**Author:** [@sarahg](https://discourse.gohugo.io/u/sarahg)\
**Replies:** 4\
**Last updated:** [September 18, 2025, 6:29pm UTC](https://discourse.gohugo.io/t/path-warnings-for-multilingual-content-fallbacks-after-v0-146-0/55931 "2025-09-18T18:29:12Z")

</div>

Hi. I’m looking for help clarifying a Hugo behavior change that was introduced in v0.146.0. We have a multilingual site that mounts content from directories outside our project. When we run builds, we have it fail in th…

---

## [Hugo theme stack - single page as homepage](https://discourse.gohugo.io/t/hugo-theme-stack-single-page-as-homepage/55913)

<div class="topic-metadata">

**Author:** [@edgarej](https://discourse.gohugo.io/u/edgarej)\
**Replies:** 2\
**Last updated:** [September 14, 2025, 9:38pm UTC](https://discourse.gohugo.io/t/hugo-theme-stack-single-page-as-homepage/55913 "2025-09-14T21:38:49Z")

</div>

Good morning. I’m trying to set a single page as my homepage in my website. Simplest answer to this issue would be to write an index html that pulls content from the single page.md. But of course this would break the th…

---

## [When did hugo.yml become supported?](https://discourse.gohugo.io/t/when-did-hugo-yml-become-supported/55879)

<div class="topic-metadata">

**Author:** [@uh-zz](https://discourse.gohugo.io/u/uh-zz)\
**Replies:** 2\
**Last updated:** [September 7, 2025, 9:51am UTC](https://discourse.gohugo.io/t/when-did-hugo-yml-become-supported/55879 "2025-09-07T09:51:03Z")

</div>

I learned from the following page that, in addition to config.yml, Hugo now supports hugo.ymlas a configuration file: Since when has this file name(hugo.yml) been supported? Also, will config.yml become unsupported i…

---

## [How to manage common config in Hugo using modules](https://discourse.gohugo.io/t/how-to-manage-common-config-in-hugo-using-modules/54485)

<div class="topic-metadata">

**Author:** [@sumahcaa](https://discourse.gohugo.io/u/sumahcaa)\
**Replies:** 3\
**Last updated:** [April 24, 2025, 11:18am UTC](https://discourse.gohugo.io/t/how-to-manage-common-config-in-hugo-using-modules/54485 "2025-04-24T11:18:43Z")

</div>

We have multiple Hugo sites that all use a shared theme, which we’ve created as a module. Our goal is to centralize and manage all common configuration values within this theme module, so that individual sites don’t need…

---

## [Add md files for LLM Friendly Consumption of Site](https://discourse.gohugo.io/t/add-md-files-for-llm-friendly-consumption-of-site/54129)

<div class="topic-metadata">

**Author:** [@Adam\_Fermier](https://discourse.gohugo.io/u/Adam_Fermier)\
**Replies:** 6\
**Last updated:** [April 1, 2025, 7:51am UTC](https://discourse.gohugo.io/t/add-md-files-for-llm-friendly-consumption-of-site/54129 "2025-04-01T07:51:46Z")

</div>

We’re seeing sites that are placing .md file next to the html/xml outputs - which the .md files provide the content that can feed the LLMs. I asked ChatGPT which told me the following manner - which makes sense - but wa…

---

## [How to do A/B landing page tests with hugo](https://discourse.gohugo.io/t/how-to-do-a-b-landing-page-tests-with-hugo/53717)

<div class="topic-metadata">

**Author:** [@madanyang](https://discourse.gohugo.io/u/madanyang)\
**Replies:** 3\
**Last updated:** [March 2, 2025, 1:19am UTC](https://discourse.gohugo.io/t/how-to-do-a-b-landing-page-tests-with-hugo/53717 "2025-03-02T01:19:24Z")

</div>

A/B testing is a powerful technique for optimizing web experiences by comparing two versions of a webpage to determine which performs better. This is a simple proof of concept for Hugo A/B testing. The A/B Testing with …

---

## [Use an image from the assets directory into hugo.toml](https://discourse.gohugo.io/t/use-an-image-from-the-assets-directory-into-hugo-toml/53176)

<div class="topic-metadata">

**Author:** [@Deewens](https://discourse.gohugo.io/u/Deewens)\
**Replies:** 2\
**Last updated:** [January 18, 2025, 7:09pm UTC](https://discourse.gohugo.io/t/use-an-image-from-the-assets-directory-into-hugo-toml/53176 "2025-01-18T19:09:37Z")

</div>

Hello, First time Hugo user, I downloaded a theme (GitHub - luizdepra/hugo-coder: A minimalist blog theme for hugo.). I was trying to use my own image as avatar. So I put my avatar into the assets/images directory, but …

---

## [PaperMod: Hugo.yaml or config.yml and home page image problems](https://discourse.gohugo.io/t/papermod-hugo-yaml-or-config-yml-and-home-page-image-problems/53011)

<div class="topic-metadata">

**Author:** [@Quijote\_Libre](https://discourse.gohugo.io/u/Quijote_Libre)\
**Replies:** 2\
**Last updated:** [January 5, 2025, 6:29pm UTC](https://discourse.gohugo.io/t/papermod-hugo-yaml-or-config-yml-and-home-page-image-problems/53011 "2025-01-05T18:29:51Z")

</div>

Despite being very new to this, I’m working to launch a site with the PaperMod theme and I have a problem with the image of the home page that does not appear to me. In the installation instructions it gives three home…

---

## [Pageref link doesn't render in the template](https://discourse.gohugo.io/t/pageref-link-doesnt-render-in-the-template/52809)

<div class="topic-metadata">

**Author:** [@themilar](https://discourse.gohugo.io/u/themilar)\
**Replies:** 6\
**Last updated:** [December 19, 2024, 9:08pm UTC](https://discourse.gohugo.io/t/pageref-link-doesnt-render-in-the-template/52809 "2024-12-19T21:08:02Z")

</div>

I’m having a hard time wrapping my around the explanation given for using this snippet \<ul\> {{ range .Site.Menus.main }} \<li\>\<a href="{{ or .URL .PageRef }}"\>{{ .Name }}\</a\>\</li\> {{ end }} \</ul\> why does the …

---

## [Using OutputFormats to generate config.yml in a certain section?](https://discourse.gohugo.io/t/using-outputformats-to-generate-config-yml-in-a-certain-section/52308)

<div class="topic-metadata">

**Author:** [@njbair](https://discourse.gohugo.io/u/njbair)\
**Replies:** 3\
**Last updated:** [November 6, 2024, 5:39pm UTC](https://discourse.gohugo.io/t/using-outputformats-to-generate-config-yml-in-a-certain-section/52308 "2024-11-06T17:39:43Z")

</div>

I’m looking to achieve the following output in my build: public/ ├── admin/ │ ├── index.html │ └── config.yml ... …where config.yml is dynamically generated via a custom output format. So far, I’ve tried to achiev…

---

## [0.122 allowed permalinks to point to host root baseurl/XXX now broken?](https://discourse.gohugo.io/t/0-122-allowed-permalinks-to-point-to-host-root-baseurl-xxx-now-broken/52277)

<div class="topic-metadata">

**Author:** [@jfj1997](https://discourse.gohugo.io/u/jfj1997)\
**Replies:** 4\
**Last updated:** [November 6, 2024, 2:24pm UTC](https://discourse.gohugo.io/t/0-122-allowed-permalinks-to-point-to-host-root-baseurl-xxx-now-broken/52277 "2024-11-06T14:24:12Z")

</div>

I am fairly sure I found a bug, but since it’s possibly an intentional change that doesn’t seem to appear in release notes I felt that I should post here for support first before submitting as a bug. Essentially in 0.122…

---

## [Hugo not generating/populating index.json correctly](https://discourse.gohugo.io/t/hugo-not-generating-populating-index-json-correctly/52021)

<div class="topic-metadata">

**Author:** [@matkv](https://discourse.gohugo.io/u/matkv)\
**Replies:** 6\
**Last updated:** [October 18, 2024, 9:12pm UTC](https://discourse.gohugo.io/t/hugo-not-generating-populating-index-json-correctly/52021 "2024-10-18T21:12:21Z")

</div>

Hi, I’m trying to implement a search functionality for my site but I’m having issues generating an index.json file. I’ve looked through multiple tutorials and tried out different templates for the index.json file, but I …

---

## [Split between site.Config and site.Params](https://discourse.gohugo.io/t/split-between-site-config-and-site-params/51693)

<div class="topic-metadata">

**Author:** [@egrep](https://discourse.gohugo.io/u/egrep)\
**Replies:** 6\
**Last updated:** [September 28, 2024, 12:10am UTC](https://discourse.gohugo.io/t/split-between-site-config-and-site-params/51693 "2024-09-28T00:10:25Z")

</div>

Hello everyone, I’m currently encountering an issue with the following Hugo error: execute of template failed: template: partials/head/analytics.html:6:64: executing “partials/head/analytics.html” at : can’t evaluate …

---

## [Multilingual / Multihost site with a single content folder?](https://discourse.gohugo.io/t/multilingual-multihost-site-with-a-single-content-folder/51516)

<div class="topic-metadata">

**Author:** [@bublick](https://discourse.gohugo.io/u/bublick)\
**Replies:** 7\
**Last updated:** [September 13, 2024, 4:13pm UTC](https://discourse.gohugo.io/t/multilingual-multihost-site-with-a-single-content-folder/51516 "2024-09-13T16:13:30Z")

</div>

Is there an option to create multihost and multilingual site from a single content/ folder? So, all content is created in English, but in other languages, we’ll have small changes and we’ve decided to add a few .Params …

---

## [baseURL with subfolder: why is it not working?](https://discourse.gohugo.io/t/baseurl-with-subfolder-why-is-it-not-working/50786)

<div class="topic-metadata">

**Author:** [@jchwenger](https://discourse.gohugo.io/u/jchwenger)\
**Replies:** 4\
**Last updated:** [July 22, 2024, 2:08pm UTC](https://discourse.gohugo.io/t/baseurl-with-subfolder-why-is-it-not-working/50786 "2024-07-22T14:08:17Z")

</div>

Here’s my simple set-up, using the Typo theme: baseURL = "https://website.com/subfolder" Sadly, when I then refer to either static resources or to the root folder, in the build it appears as “https://website.com/”, ins…

---

## [FixIt Theme - How to place Table of Contents to the Left Side?](https://discourse.gohugo.io/t/fixit-theme-how-to-place-table-of-contents-to-the-left-side/50618)

<div class="topic-metadata">

**Author:** [@pnwlover](https://discourse.gohugo.io/u/pnwlover)\
**Replies:** 3\
**Last updated:** [July 8, 2024, 10:09pm UTC](https://discourse.gohugo.io/t/fixit-theme-how-to-place-table-of-contents-to-the-left-side/50618 "2024-07-08T22:09:12Z")

</div>

Am new to Hugo and am trying to place the Table of Contents from the right hand side to the left hand side… Using: hugo v0.128.2 and the FixIt theme. mysite | ---layouts (copied this from the /themes/Fixit/layouts fold…

---

## [Unexpected and undesired output folder being generated, would like to prevent this](https://discourse.gohugo.io/t/unexpected-and-undesired-output-folder-being-generated-would-like-to-prevent-this/49113)

<div class="topic-metadata">

**Author:** [@ddg](https://discourse.gohugo.io/u/ddg)\
**Replies:** 3\
**Last updated:** [March 30, 2024, 5:16pm UTC](https://discourse.gohugo.io/t/unexpected-and-undesired-output-folder-being-generated-would-like-to-prevent-this/49113 "2024-03-30T17:16:48Z")

</div>

I am not sure what is wrong with my configuration that it is causing this mystery faves/page/1 folder to get generated in the output (“public”) directory after running a hugo -e production build. This “page” output folde…

---

## [Looking for a little clarity around what may/may not be a config file, or directory](https://discourse.gohugo.io/t/looking-for-a-little-clarity-around-what-may-may-not-be-a-config-file-or-directory/49095)

<div class="topic-metadata">

**Author:** [@Wolfspyre](https://discourse.gohugo.io/u/Wolfspyre)\
**Replies:** 0\
**Last updated:** [March 29, 2024, 12:22am UTC](https://discourse.gohugo.io/t/looking-for-a-little-clarity-around-what-may-may-not-be-a-config-file-or-directory/49095 "2024-03-29T00:22:10Z")

</div>

The Hugo Docs state: Instead of a single site configuration file, split your configuration by environment, root configuration key, and language. For example: my-project/ └── config/ ├── \_default/ │ ├── hugo…

---

## [Documentation of new \[params.author\] parameter](https://discourse.gohugo.io/t/documentation-of-new-params-author-parameter/48921)

<div class="topic-metadata">

**Author:** [@krischik](https://discourse.gohugo.io/u/krischik)\
**Replies:** 1\
**Last updated:** [March 19, 2024, 12:50pm UTC](https://discourse.gohugo.io/t/documentation-of-new-params-author-parameter/48921 "2024-03-19T12:50:50Z")

</div>

It there a documentation for the new \[params.author\] or \[params.authors\] configuration parameter? Best would be a documentation with a full example. Currently I don’t even know the correct spelling as both \[params.author…

---

## [Would like a way to ask hugo to emit more runtime-relevant data alongside template metrics](https://discourse.gohugo.io/t/would-like-a-way-to-ask-hugo-to-emit-more-runtime-relevant-data-alongside-template-metrics/47426)

<div class="topic-metadata">

**Author:** [@Wolfspyre](https://discourse.gohugo.io/u/Wolfspyre)\
**Replies:** 2\
**Last updated:** [December 17, 2023, 8:28am UTC](https://discourse.gohugo.io/t/would-like-a-way-to-ask-hugo-to-emit-more-runtime-relevant-data-alongside-template-metrics/47426 "2023-12-17T08:28:12Z")

</div>

as I’m working on a site, at various points I’ll capture the template metrics output from a clean start of hugo. Some things that I think would be generally helpful to include, and is already available: the date/time …

---

## [New Warning: The author key in site configuration is deprecated. Use params.author.name instead](https://discourse.gohugo.io/t/new-warning-the-author-key-in-site-configuration-is-deprecated-use-params-author-name-instead/47034)

<div class="topic-metadata">

**Author:** [@krischik](https://discourse.gohugo.io/u/krischik)\
**Replies:** 5\
**Last updated:** [November 18, 2023, 2:57pm UTC](https://discourse.gohugo.io/t/new-warning-the-author-key-in-site-configuration-is-deprecated-use-params-author-name-instead/47034 "2023-11-18T14:57:30Z")

</div>

I just noted a new warning: The author key in site configuration is deprecated. Use params.author.name instead. Of course I tried to move my author configuration. \[params.author\] name = 'Martin Krischik' …

---

## [baseURL for img tags in template files](https://discourse.gohugo.io/t/baseurl-for-img-tags-in-template-files/46337)

<div class="topic-metadata">

**Author:** [@Remy](https://discourse.gohugo.io/u/Remy)\
**Replies:** 5\
**Last updated:** [September 22, 2023, 5:40pm UTC](https://discourse.gohugo.io/t/baseurl-for-img-tags-in-template-files/46337 "2023-09-22T17:40:29Z")

</div>

Hi everyone ! For my website, I use some img tags in partials, refering to some images I store in /static. In local, I have no issue. But, when I deploy my website as Github Pages, I see that all my img tags refer to m…

---

## [\[proposal\] \`hugo convert\` for configurations](https://discourse.gohugo.io/t/proposal-hugo-convert-for-configurations/45885)

<div class="topic-metadata">

**Author:** [@razon](https://discourse.gohugo.io/u/razon)\
**Replies:** 2\
**Last updated:** [August 25, 2023, 3:46pm UTC](https://discourse.gohugo.io/t/proposal-hugo-convert-for-configurations/45885 "2023-08-25T15:46:40Z")

</div>

I would like to see there is an feature like hugo convert, which convert the front matter to specified format, but for configurations (single configuration file and configuration directories). It’s useful for clients to…

---

## [Config folder](https://discourse.gohugo.io/t/config-folder/45540)

<div class="topic-metadata">

**Author:** [@French\_Mike](https://discourse.gohugo.io/u/French_Mike)\
**Replies:** 8\
**Last updated:** [August 1, 2023, 1:49am UTC](https://discourse.gohugo.io/t/config-folder/45540 "2023-08-01T01:49:32Z")

</div>

Hello, Per the hugo documenation I set up a config folder the following way: config └── \_default ├── hugo.yaml └── params.yaml but that only applied the config for my hugo.yaml, but my params.yaml which contai…

---

## [Fingerprint 生成的 integrity 会带分号 “;”，请问如何去掉这个分号？](https://discourse.gohugo.io/t/fingerprint-integrity/45374)

<div class="topic-metadata">

**Author:** [@kakayikaka](https://discourse.gohugo.io/u/kakayikaka)\
**Replies:** 23\
**Last updated:** [July 22, 2023, 1:21pm UTC](https://discourse.gohugo.io/t/fingerprint-integrity/45374 "2023-07-22T13:21:19Z")

</div>

我的主题中会使用 {{- $resource = $resource | fingerprint . -}} {{- $integrity = $resource.Data.Integrity -}} 生成 integrity 属性，例如：integrity="sha256-MvGBfFwfZs5Zwaqmkg5B6ovA3H1sJAtPJUqRcXQ&#43;nNA=" 显然这个 sha256 中会携带分号 “;”，当我…

---

## [Executing "partials/functions/warnings.html" at \<.Site.Params.showAppearanceSwitcher\>: can't evaluate field Site in type \*page.siteWrapper](https://discourse.gohugo.io/t/executing-partials-functions-warnings-html-at-site-params-showappearanceswitcher-cant-evaluate-field-site-in-type-page-sitewrapper/45386)

<div class="topic-metadata">

**Author:** [@stong1994](https://discourse.gohugo.io/u/stong1994)\
**Replies:** 1\
**Last updated:** [July 21, 2023, 7:42am UTC](https://discourse.gohugo.io/t/executing-partials-functions-warnings-html-at-site-params-showappearanceswitcher-cant-evaluate-field-site-in-type-page-sitewrapper/45386 "2023-07-21T07:42:47Z")

</div>

ERROR render of "page" failed: "\*\*\*\*/modules/filecache/modules/pkg/mod/github.com/jpanther/congo/v2@v2.5.4/layouts/\_default/baseof.html:1:4": execute of template failed: template: \_default/single.html:1:4: executing "\_d…

[Next page](https://discourse.gohugo.io/tag/configuration/15.md?match_all_tags=true&page=1&tags%5B%5D=configuration)