🐞 Bug: Favicon is not loading in Hugo site with Toha v4

[youssef-abbih]

Hugo version: 0.146.0
Toha version: v4
OS: Ubuntu 24.04

📄 Description

I’m trying to set a favicon for my Toha-based Hugo site, but it doesn’t load in the browser. The favicon path seems correct, but I keep getting a 404 in the network tab.

I have the favicon placed in static/images/favicon.png, and my configuration points to it.

📂 Project structure

project-root/
├── static/
│   ├── images/
│   │   ├── favicon.png
│   │   └── logo.png
├── layouts/
│   └── partials/
│       └── header.html
├── hugo.yaml
└── ...

🛠 Configuration

hugo.yaml

params:
  logo:
    main: "/images/logo.png"
    favicon: "/images/favicon.png"

layouts/partials/header.html

<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta http-equiv="X-UA-Compatible" content="ie=edge" />

{{ partial "helpers/style-bundle.html" . }}

<!--================= favicon =========================-->
{{ if site.Params.logo.favicon }}
  <link rel="icon" type="image/png" href="{{ with .Site.Params.logo.favicon }}{{ . | relURL }}{{ else }}/favicon.png{{ end }}">
{{ else }}
  <link rel="icon" href="/assets/images/favicon.ico" type="image/x-icon"/>
{{ end }}

{{ with .OutputFormats.Get "rss" -}}
  {{ printf `<link rel=%q type=%q href=%q title=%q>` .Rel .MediaType.Type .Permalink site.Title | safeHTML }}
{{ end }}

🔍 What I tried

1. Moved favicon.png to:

   • static/favicon.png
   • static/images/favicon.png

2. Cleared Hugo’s cache:

   hugo mod clean && hugo server --disableFastRender

3. Checked browser DevTools:

   • <link rel="icon" ...> is present
   • Network tab shows favicon.png 404 error

4. Hard-refreshed browser (Ctrl+Shift+R).

5. Used absolute and relative paths for the favicon.

🧑‍💻 Expected behavior

The favicon should load in the browser tab from /images/favicon.png or /favicon.png.

❓ Question

• Is there a known issue in Toha v4 with favicons?
• Should favicon.png go in static/ or is it expected in assets/?
• Is the header.html code above compatible with the Toha theme’s resource handling?

✅ Steps to reproduce

1. Create a Hugo site with Toha v4
2. Add favicon.png to static/images/
3. Set logo.favicon in hugo.yaml
4. Run hugo server
5. Open browser -> favicon doesn’t load

[hossainemruz]

Should favicon.png go in static/ or is it expected in assets/?

Please, put it in the assets dir.