Trouble getting my Hugo site to Render my Custom Homepage

support
1

I am working on a Hugo website using v 0.148. I would like for my homepage to use a custom layout, with the template files located in layouts/home as shown in my file tree, but my homepage is being rendered with the usual index.html and baseof.html files, not the ones specified for the homepage. Also, the contents of my _index.md file are not being rendered. Does anybody have any suggestions? Github code is here:

hugo v0.148.2+extended+withdeploy darwin/arm64 BuildDate=2025-07-27T12:43:24Z VendorInfo=brew
GOOS="darwin"
GOARCH="arm64"
GOVERSION="go1.24.5"
github.com/sass/libsass="3.6.6"
github.com/webmproject/libwebp="v1.3.2"
eliross@Elis-MacBook-Air eli-hugo %

Github repository: GitHub - eross200/eli-hugo

Here is my file tree:


eli-hugo/
├─ archetypes/
│  └─ default.md
├─ assets/
├─ content/
│  ├─ posts/
│  │  ├─ my-first-post.md
│  │  ├─ my-second-post.md
│  │  └─ my-third-post.md
│  ├─ _index.html
│  ├─ history.md
│  ├─ photos.md
│  ├─ take-home.md
│  └─ testimonials.md
├─ data/
├─ i18n/
├─ layouts/
│  ├─ _partials/
│  │  ├─ head/
│  │  │  ├─ css.html
│  │  │  └─ js.html
│  │  ├─ footer.html
│  │  ├─ head.html
│  │  ├─ header.html
│  │  ├─ masthead.html
│  │  ├─ nav-desktop.html
│  │  ├─ nav-mobile.html
│  │  ├─ portfolio-eden.html
│  │  ├─ portfolio-freelance.html
│  │  └─ terms.html
│  ├─ _shortcodes/
│  ├─ home/
│  │  ├─ baseof.home.html
│  │  └─ home.html
│  ├─ baseof.html
│  ├─ index.html
│  ├─ list.html
│  └─ single.html
├─ static/
│  ├─ css/
│  │  ├─ _partials/
│  │  │  ├─ _color.css
│  │  │  ├─ _footer.css
│  │  │  ├─ _header.css
│  │  │  ├─ _nav.css
│  │  │  ├─ _stuff.css
│  │  │  ├─ _test.css
│  │  │  └─ _type.css
│  │  └─ custom.css
│  ├─ img/
│  │  └─ theme-img/
│  │     ├─ btn-list.svg
│  │     ├─ bw.jpg
│  │     ├─ divider-long.svg
│  │     ├─ divider-mid.svg
│  │     ├─ logo-elih3-long.svg
│  │     └─ logo-elih3-stacked.svg
│  ├─ js/
│  │  └─ main.js
│  └─ favicon.ico
├─ themes/
├─ .hugo_build.lock
└─ hugo.toml
2

Welcome, congrats - you nearly made it

from here: New template system in Hugo v0.146.0

Description Action required
Any folder in layouts that does not start with _ represents the root of a Page path… you have no content/home folder
For base templates (e.g., baseof.html), in previous Hugo versions, you could prepend one identifier (layout, type, or kind) with a hyphen in front of the baseof keyword. Move that identifier after the first “dot,” e.g., renamelist-baseof.html to baseof.list.html. Move all files in layouts/_default up to the layouts/ root.
The above means that there’s no such thing as an index.html template for the home page anymore. Rename index.html to home.html.
  • move layouts/home/home.html → layouts/home.html
  • move layouts/home/baseof.home.html → layouts/layouts/baseof.home.html
3

That got it! thank you so much!

4

This topic was automatically closed 2 days after the last reply. New replies are no longer allowed.