Images, Covers and Captions
- 1 min read
- Category: Guides
- Tag: #images
- Tag: #hugo

Images, Covers and CaptionsSEP 2, 2026
A post with image: cover.jpg in its front matter gets a cover under the title, a thumbnail on its note in the home page, and uses the image as its link preview instead of the generated card.
Images in the text
Images that live next to the post (a page bundle) get their width and height, so the page does not jump while they load, and a srcset so phones download a smaller file:

Figures with a caption
A standalone image with a title becomes a figure when Hugo renders block images (markup.goldmark.parser.wrapStandAloneImageWithinParagraph = false). Otherwise the title is kept as a tooltip.

Remote images
Images from another site (an absolute URL) are left as they are, lazy-loaded. Hugo cannot measure them, so give them room in your layout.