Feature Images

Feature images in Yore serve multiple purposes: they appear as hero banners, thumbnails, and social sharing metadata. This functionality relies on Hugo page bundles.

Automatic Detection

When using index.md inside a directory (creating a leaf bundle), Yore automatically detects images with the feature* prefix and uses them as the page's feature image.

For example, this structure:

content/
└── posts/
    └── my-article/
        ├── index.md
        └── feature.webp

will automatically use feature.webp as the hero image, thumbnail, and social sharing image.

Manual Configuration

You can explicitly specify a feature image using the pageFeatureImage parameter in front matter:

index.md
---
title: My Article
params:
  # Specifies the image in `assets/img/07.webp`
  pageFeatureImage: img/07.webp
---

Info

The params field contains theme-specific configuration, not Hugo core settings.

Hero Image Styles

The pageHeroStyle parameter controls how the hero image is displayed. This can be set globally in site configuration or overridden per page:

index.md
---
title: My Article
params:
  pageFeatureImage: img/07.webp
  pageHeroStyle: background
---

Available styles are:

big: Large hero image at full content width
background: Full-width background image with text overlay
disable: No hero image display (image still used for metadata)