# \#theme-building

**URL:** https://discourse.gohugo.io/tag/theme-building/70.md

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

---

## [Starless - for seldom updated blogs](https://discourse.gohugo.io/t/starless-for-seldom-updated-blogs/57443)

<div class="topic-metadata">

**Author:** [@ruinivist](https://discourse.gohugo.io/u/ruinivist)\
**Replies:** 2\
**Last updated:** [August 10, 2026, 8:28pm UTC](https://discourse.gohugo.io/t/starless-for-seldom-updated-blogs/57443 "2026-08-10T20:28:34Z")

</div>

I’ve been meaning to migrate to hugo for quite a while now. This theme is a rework of my current heavily modified quartz setup. Overall I guess this turned out nice enough.

---

## [New audio and podcast oriented theme and shortcode in development - Feedback Appreciated](https://discourse.gohugo.io/t/new-audio-and-podcast-oriented-theme-and-shortcode-in-development-feedback-appreciated/57280)

<div class="topic-metadata">

**Author:** [@adurrr](https://discourse.gohugo.io/u/adurrr)\
**Replies:** 0\
**Last updated:** [June 17, 2026, 9:14pm UTC](https://discourse.gohugo.io/t/new-audio-and-podcast-oriented-theme-and-shortcode-in-development-feedback-appreciated/57280 "2026-06-17T21:14:23Z")

</div>

I built Wavecast, a Hugo theme and module that adds a persistent podcast/radio audio player to any Hugo site. Drop a shortcode into a page and the audio follows you across every page via a sticky footer bar for pause, se…

---

## [Setting up multiple themes in Hugo](https://discourse.gohugo.io/t/setting-up-multiple-themes-in-hugo/56832)

<div class="topic-metadata">

**Author:** [@Paras-Tyagi](https://discourse.gohugo.io/u/Paras-Tyagi)\
**Replies:** 1\
**Last updated:** [March 9, 2026, 5:56pm UTC](https://discourse.gohugo.io/t/setting-up-multiple-themes-in-hugo/56832 "2026-03-09T17:56:49Z")

</div>

Hello, I am trying to setup two different Hugo themes for different pages of a Hugo site. What could be the best possible way to do that ? Here are the two themes which I want to use on different pages of the site - …

---

## [Best way to adapt to new template system when using Page.Type](https://discourse.gohugo.io/t/best-way-to-adapt-to-new-template-system-when-using-page-type/56719)

<div class="topic-metadata">

**Author:** [@dhch](https://discourse.gohugo.io/u/dhch)\
**Replies:** 10\
**Last updated:** [February 24, 2026, 9:13pm UTC](https://discourse.gohugo.io/t/best-way-to-adapt-to-new-template-system-when-using-page-type/56719 "2026-02-24T21:13:55Z")

</div>

Prior to hugo 0.146, we were extensively using type front-matter on our section pages to drive various pieces of navigation rendering. after migrating to the new template system, i see that type is used to determine the …

---

## [Prism - a modern and vibrant Hugo theme](https://discourse.gohugo.io/t/prism-a-modern-and-vibrant-hugo-theme/56515)

<div class="topic-metadata">

**Author:** [@jimmy](https://discourse.gohugo.io/u/jimmy)\
**Replies:** 2\
**Last updated:** [January 8, 2026, 6:24pm UTC](https://discourse.gohugo.io/t/prism-a-modern-and-vibrant-hugo-theme/56515 "2026-01-08T18:24:55Z")

</div>

I recently took the theme I’d been using for my own Hugo blog, polished it up, and finally released it on GitHub. If you’re looking for a clean, distraction-free space for your thoughts, I’d love for you to try it out! I…

---

## [Syntax highlighting in Safari doesn't work?](https://discourse.gohugo.io/t/syntax-highlighting-in-safari-doesnt-work/56479)

<div class="topic-metadata">

**Author:** [@geerlingguy](https://discourse.gohugo.io/u/geerlingguy)\
**Replies:** 3\
**Last updated:** [January 2, 2026, 4:49am UTC](https://discourse.gohugo.io/t/syntax-highlighting-in-safari-doesnt-work/56479 "2026-01-02T04:49:40Z")

</div>

I’m trying to use syntax highlighting in code blocks, and it looks great in Firefox, but in Safari, after a brief moment during initial page load when I can see the colors for maybe like 1/60th of a second, the \<pre\> cod…

---

## [How to extend a theme with image gallery functionality](https://discourse.gohugo.io/t/how-to-extend-a-theme-with-image-gallery-functionality/56082)

<div class="topic-metadata">

**Author:** [@TvE](https://discourse.gohugo.io/u/TvE)\
**Replies:** 6\
**Last updated:** [November 1, 2025, 12:09pm UTC](https://discourse.gohugo.io/t/how-to-extend-a-theme-with-image-gallery-functionality/56082 "2025-11-01T12:09:49Z")

</div>

Hi Hugo community (first post…) I spent most of the weekend - finally - making a site in Hugo, it’s - as always - WIP, but for now I am happy and have declared it version 1.0 :slight\_smile: and I have learned a lot abo…

---

## [Storing markup override settings in the theme settings](https://discourse.gohugo.io/t/storing-markup-override-settings-in-the-theme-settings/56032)

<div class="topic-metadata">

**Author:** [@trevdev](https://discourse.gohugo.io/u/trevdev)\
**Replies:** 4\
**Last updated:** [October 4, 2025, 7:00pm UTC](https://discourse.gohugo.io/t/storing-markup-override-settings-in-the-theme-settings/56032 "2025-10-04T19:00:38Z")

</div>

I’m trying to compartmentalise all the settings that I mean to use to change the look and feel of my website within the theme folder. However, when I use these settings in my theme’s hugo.toml file, they do not work: \[m…

---

## [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…

---

## [Hugo Theme Stack - Background Image](https://discourse.gohugo.io/t/hugo-theme-stack-background-image/55898)

<div class="topic-metadata">

**Author:** [@edgarej](https://discourse.gohugo.io/u/edgarej)\
**Replies:** 1\
**Last updated:** [September 12, 2025, 8:41am UTC](https://discourse.gohugo.io/t/hugo-theme-stack-background-image/55898 "2025-09-12T08:41:26Z")

</div>

I’m trying to add light/dark background images to the theme Stack (GitHub - CaiJimmy/hugo-theme-stack: Card-style Hugo theme designed for bloggers), but I couldn’t get my code to work right. Here is my code; :root { …

---

## [Facing error while setting up LoveIt theme](https://discourse.gohugo.io/t/facing-error-while-setting-up-loveit-theme/55105)

<div class="topic-metadata">

**Author:** [@thegenetic](https://discourse.gohugo.io/u/thegenetic)\
**Replies:** 2\
**Last updated:** [June 20, 2025, 3:34pm UTC](https://discourse.gohugo.io/t/facing-error-while-setting-up-loveit-theme/55105 "2025-06-20T15:34:04Z")

</div>

Hello, I was trying to setup LoveIt theme. I followed the Hugo documentation as it is, but i am facing some errors when i am try to host the site. $ hugo server Error: html/template:\_markup/render-codeblock-goat.html:6…

---

## [Why is my theme module not working? Should I vendor it?](https://discourse.gohugo.io/t/why-is-my-theme-module-not-working-should-i-vendor-it/54984)

<div class="topic-metadata">

**Author:** [@Stradichenko](https://discourse.gohugo.io/u/Stradichenko)\
**Replies:** 5\
**Last updated:** [June 4, 2025, 3:23pm UTC](https://discourse.gohugo.io/t/why-is-my-theme-module-not-working-should-i-vendor-it/54984 "2025-06-04T15:23:47Z")

</div>

I want to use my own theme on my personal blog (a different repo). But when trying to import theme as a module, the site renders but only with boilerplate elements, not with custom theme… I have the following doubts: W…

---

## [Hugo-modus: a theme for personal blog](https://discourse.gohugo.io/t/hugo-modus-a-theme-for-personal-blog/54292)

<div class="topic-metadata">

**Author:** [@goofansu](https://discourse.gohugo.io/u/goofansu)\
**Replies:** 1\
**Last updated:** [May 20, 2025, 6:46am UTC](https://discourse.gohugo.io/t/hugo-modus-a-theme-for-personal-blog/54292 "2025-05-20T06:46:19Z")

</div>

I use the Modus themes in Emacs and enjoy it greatly, so I’ve built my blog using its colors and created the hugo-modus theme. It supports both light and dark modes and automatically switches according to your system’s s…

---

## [\[New Hugo Theme\] My Notes – Minimalist & Multi-Language Theme for Blog and Documentation](https://discourse.gohugo.io/t/new-hugo-theme-my-notes-minimalist-multi-language-theme-for-blog-and-documentation/54225)

<div class="topic-metadata">

**Author:** [@masputrawae](https://discourse.gohugo.io/u/masputrawae)\
**Replies:** 2\
**Last updated:** [April 3, 2025, 7:57pm UTC](https://discourse.gohugo.io/t/new-hugo-theme-my-notes-minimalist-multi-language-theme-for-blog-and-documentation/54225 "2025-04-03T19:57:25Z")

</div>

Hello everyone! :waving\_hand: I’ve just started learning Hugo, and My Notes is my first theme. I’m still new to Hugo, so there’s not much I know yet, but this theme is the result of my learning process. Since this is my…

---

## [Deployed Hugo on Github pages, theme & images are missing](https://discourse.gohugo.io/t/deployed-hugo-on-github-pages-theme-images-are-missing/53986)

<div class="topic-metadata">

**Author:** [@VRod795](https://discourse.gohugo.io/u/VRod795)\
**Replies:** 11\
**Last updated:** [March 18, 2025, 6:39pm UTC](https://discourse.gohugo.io/t/deployed-hugo-on-github-pages-theme-images-are-missing/53986 "2025-03-18T18:39:37Z")

</div>

Hi. I’ve been really frustrated over the past few days trying to get this thing deployed. Finally got it today but the theme, images, are missing :frowning: This is my repo. GitHub - Sudo-Victor-Victory/github-portfoli…

---

## [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 …

---

## [My personal website](https://discourse.gohugo.io/t/my-personal-website/51922)

<div class="topic-metadata">

**Author:** [@fabio](https://discourse.gohugo.io/u/fabio)\
**Replies:** 7\
**Last updated:** [January 10, 2025, 9:35pm UTC](https://discourse.gohugo.io/t/my-personal-website/51922 "2025-01-10T21:35:55Z")

</div>

Hello everyone, I am a new user of Hugo. A few years ago I made my personal website/portfolio using KirbyCMS, which I used mainly without interface but of which I didn’t appreciate all the PHP server part. Consideri…

---

## [Request for Feedback on Unmerged Theme PR](https://discourse.gohugo.io/t/request-for-feedback-on-unmerged-theme-pr/52269)

<div class="topic-metadata">

**Author:** [@sunwei](https://discourse.gohugo.io/u/sunwei)\
**Replies:** 1\
**Last updated:** [November 8, 2024, 12:44pm UTC](https://discourse.gohugo.io/t/request-for-feedback-on-unmerged-theme-pr/52269 "2024-11-08T12:44:58Z")

</div>

Hello Hugo Community, I recently submitted a theme pull request to the Hugo Themes Site Builder repository, but I noticed it hasn’t been merged. Interestingly, I observed that other PRs before and after mine have been m…

---

## [Home page does not display everything ](https://discourse.gohugo.io/t/home-page-does-not-display-everything/51948)

<div class="topic-metadata">

**Author:** [@S\_F](https://discourse.gohugo.io/u/S_F)\
**Replies:** 9\
**Last updated:** [October 14, 2024, 6:59pm UTC](https://discourse.gohugo.io/t/home-page-does-not-display-everything/51948 "2024-10-14T18:59:54Z")

</div>

Hello everyone, I am in the process of creating a website with the theme Hugo Initio. So far everything is working, but I can’t see the Services Services , RecentWorks and Downloads on the homepage. But I have entered…

---

## [Why is my new content not being found - error 404 online but works in dev](https://discourse.gohugo.io/t/why-is-my-new-content-not-being-found-error-404-online-but-works-in-dev/51402)

<div class="topic-metadata">

**Author:** [@Clickadelic](https://discourse.gohugo.io/u/Clickadelic)\
**Replies:** 4\
**Last updated:** [September 3, 2024, 11:58pm UTC](https://discourse.gohugo.io/t/why-is-my-new-content-not-being-found-error-404-online-but-works-in-dev/51402 "2024-09-03T23:58:49Z")

</div>

Hello, I’m trying to publish some new content under a certain path. I’ve got it working locally but after publishing it to my domain, I’m getting a 404 error. My path is content/de/about/stack I’ve added \_index.md in…

---

## [How to get all RelPermalink of a resource.Resources?](https://discourse.gohugo.io/t/how-to-get-all-relpermalink-of-a-resource-resources/51375)

<div class="topic-metadata">

**Author:** [@Europrimus](https://discourse.gohugo.io/u/Europrimus)\
**Replies:** 4\
**Last updated:** [September 2, 2024, 8:21pm UTC](https://discourse.gohugo.io/t/how-to-get-all-relpermalink-of-a-resource-resources/51375 "2024-09-02T20:21:52Z")

</div>

Hello, I try to use multiple background image and switch then dynamically by javaScript. Currently I use a scratch and range over my resources to get all RelPermalink, it works, but I found it’s not very clean. I wond…

---

## [Display the description of a tag in single.html](https://discourse.gohugo.io/t/display-the-description-of-a-tag-in-single-html/50890)

<div class="topic-metadata">

**Author:** [@Cassie](https://discourse.gohugo.io/u/Cassie)\
**Replies:** 1\
**Last updated:** [July 27, 2024, 4:08am UTC](https://discourse.gohugo.io/t/display-the-description-of-a-tag-in-single-html/50890 "2024-07-27T04:08:56Z")

</div>

Using this post as a reference, I’ve added a description for a custom taxonomy. It works as expected. I’m referencing the custom taxonomy (called ‘nys’) on single.html, like so: \<ul id="nys"\> {{ range .Params.nys }…

---

## [Support - TailwindCSS - HTML Template change not triggering CSS/PostCSS rebuild](https://discourse.gohugo.io/t/support-tailwindcss-html-template-change-not-triggering-css-postcss-rebuild/49618)

<div class="topic-metadata">

**Author:** [@AncientDF](https://discourse.gohugo.io/u/AncientDF)\
**Replies:** 17\
**Last updated:** [June 13, 2024, 10:15am UTC](https://discourse.gohugo.io/t/support-tailwindcss-html-template-change-not-triggering-css-postcss-rebuild/49618 "2024-06-13T10:15:44Z")

</div>

I’m creating a theme using TailwindCSS, PostCSS and PrelineUI. Currently, I’m noticing some unexpected behavior when making changes to my baseof.html template. After applying changes, hugo correctly updates hugo\_stats.…

---

## [Translatable content in themes?](https://discourse.gohugo.io/t/translatable-content-in-themes/50192)

<div class="topic-metadata">

**Author:** [@cmahnke](https://discourse.gohugo.io/u/cmahnke)\
**Replies:** 3\
**Last updated:** [June 7, 2024, 5:04pm UTC](https://discourse.gohugo.io/t/translatable-content-in-themes/50192 "2024-06-07T17:04:37Z")

</div>

For a custom (as in in-house) theme I would like to provide a privacy statement from a theme. This statement should be provided in different languages (German and English). It’s sure possible to provide it in the approp…

---

## [Index.html is not being rendered](https://discourse.gohugo.io/t/index-html-is-not-being-rendered/49705)

<div class="topic-metadata">

**Author:** [@Sapp94](https://discourse.gohugo.io/u/Sapp94)\
**Replies:** 3\
**Last updated:** [May 8, 2024, 5:30pm UTC](https://discourse.gohugo.io/t/index-html-is-not-being-rendered/49705 "2024-05-08T17:30:06Z")

</div>

Hello, my project is divided in three parts: main project (overall configuration, importing other modules via .work file) theme: the actual theme, respective module imports content: the content The overall setup work…

---

## [Unable to Properly Link Local Typeface on Github Pages](https://discourse.gohugo.io/t/unable-to-properly-link-local-typeface-on-github-pages/48588)

<div class="topic-metadata">

**Author:** [@maaaaaaaaaatt](https://discourse.gohugo.io/u/maaaaaaaaaatt)\
**Replies:** 8\
**Last updated:** [March 1, 2024, 2:14pm UTC](https://discourse.gohugo.io/t/unable-to-properly-link-local-typeface-on-github-pages/48588 "2024-03-01T14:14:58Z")

</div>

Hey folks, Pretty new to Hugo, and having a lot of fun, but finding it a little impossible to properly link some typeface files within my build. I have the files in static/fonts, and linked as such in my css file: @fon…

---

## [Specifying sub-theme location](https://discourse.gohugo.io/t/specifying-sub-theme-location/48389)

<div class="topic-metadata">

**Author:** [@stefanv](https://discourse.gohugo.io/u/stefanv)\
**Replies:** 0\
**Last updated:** [February 21, 2024, 1:51am UTC](https://discourse.gohugo.io/t/specifying-sub-theme-location/48389 "2024-02-21T01:51:07Z")

</div>

The Hugo docs state that: a project can configure a theme as a composite of as many theme components you need \[…\] You can even nest this, and have the theme component itself include theme components in its own hugo.t…

---

## [Overriding theme imported as a module?](https://discourse.gohugo.io/t/overriding-theme-imported-as-a-module/48248)

<div class="topic-metadata">

**Author:** [@mahadevan](https://discourse.gohugo.io/u/mahadevan)\
**Replies:** 3\
**Last updated:** [February 12, 2024, 6:21pm UTC](https://discourse.gohugo.io/t/overriding-theme-imported-as-a-module/48248 "2024-02-12T18:21:04Z")

</div>

I have cloned a hugo theme template directly from the source into my github repo. It is acquiring the template files as a module \[\[imports\]\] path = "github.com/CaiJimmy/hugo-theme-stack/v3" I need to edit theme a bit. …

---

## [Are hugo themes full hugo projects in itself?](https://discourse.gohugo.io/t/are-hugo-themes-full-hugo-projects-in-itself/46911)

<div class="topic-metadata">

**Author:** [@andrebuse](https://discourse.gohugo.io/u/andrebuse)\
**Replies:** 2\
**Last updated:** [November 1, 2023, 12:20pm UTC](https://discourse.gohugo.io/t/are-hugo-themes-full-hugo-projects-in-itself/46911 "2023-11-01T12:20:26Z")

</div>

\[This is more out of curiosity, everything works fine so I didn’t put it in the support category\] I am creating my own theme. I noticed that the skeleton created by hugo new theme contains a hugo.toml and also some plac…

---

## [Migrate hugo theme](https://discourse.gohugo.io/t/migrate-hugo-theme/46140)

<div class="topic-metadata">

**Author:** [@sudojarvis](https://discourse.gohugo.io/u/sudojarvis)\
**Replies:** 4\
**Last updated:** [September 19, 2023, 12:03pm UTC](https://discourse.gohugo.io/t/migrate-hugo-theme/46140 "2023-09-19T12:03:33Z")

</div>

I want to migrating my existing website from hugo-coder theme to papermod theme how can I get started and achieve this migration

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