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:

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

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:

---
title: My Article
params:
  pageFeatureImage: img/07.jpg
  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)