Media and decoration

Image

The Image block shows one picture, with an optional caption under it. It can open the picture full screen or link it to another page. You find it in the block picker under Common, or under Media when blocks you use more often fill Common. It goes in a Section or a Post Content section, or inside a Group, a Gallery, a Collection, a No Results or a Paywall.

Wide illustration with rounded corners of people drawing around a table, in an About section with the heading Built for Creators below it

To show each post's own picture, use the Featured Image block instead, described in Data blocks. For several pictures in a grid, use a Gallery.

General

Setting What it does
Image The picture. The Add image button opens a menu: Open media library, Upload, Search Unsplash or Insert from URL. Add images and photos covers each source, alt text and the size limits.
Click behavior What happens when a visitor clicks the picture. None (the default) does nothing. Open lightbox opens it full screen over the page, even when Lightbox is off in Project settings › Features. Custom URL makes it a link. Inside a Gallery, the default is Use gallery setting, which follows the Gallery's own Click behavior.
Link URL Shows when Click behavior is Custom URL. The page the picture opens, such as https://example.com/about or /about/. A link that starts with http, even one to your own site, opens in a new tab. Use /about/ to stay in the same tab. The caption is not part of the link.
Caption A line of text under the picture, with bold, italic and links. A photo from Unsplash puts its credit here.

Layout

Setting What it does
Aspect Ratio Crops the picture to a shape around its center: Auto (the default, the picture's own shape), 1:1, 4:3, 3:2, 16:9, 3:4, 9:16, or Custom with two numbers for the width and the height, such as 5 and 4. Inside a Gallery, the Gallery sets the shape instead.
Height Gives the picture a height of its own and crops it to fill it. Layout settings describes the values.

The Layout group's + menu also adds Width.

An Image with no picture

An Image block with no picture shows a gray box, 16:9 unless you set another ratio. It shows on your Ghost site too, so remove the block or add a picture before you publish.

Shared settings

The Image also has Padding and Margin in the Spacing group, Border and Corners in the Colors and appearance settings, the Display settings and the Advanced settings. Corners round the picture itself.

Was this article helpful?