> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livehub.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Image

> A single image, with an optional caption and link

The Image block places one image on your page. It's the simplest way to
show artwork, a poster, a photo, or a promo graphic.

<Frame caption="An image with a caption overlaid at the bottom; the corner badge shows it's linked.">
  <img className="block dark:hidden" src="https://mintcdn.com/livehub/K5-wIuGvUb-0AHlh/images/pages/blocks/block-image.svg?fit=max&auto=format&n=K5-wIuGvUb-0AHlh&q=85&s=52f1cb6fc5a189fdffdd991350375476" alt="Image block: a photo with a caption bar and a link badge" width="600" height="266" data-path="images/pages/blocks/block-image.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/livehub/K5-wIuGvUb-0AHlh/images/pages/blocks/block-image-dark.svg?fit=max&auto=format&n=K5-wIuGvUb-0AHlh&q=85&s=c519833539d22257df9c9ce6c5eeb0db" alt="Image block: a photo with a caption bar and a link badge" width="600" height="266" data-path="images/pages/blocks/block-image-dark.svg" />
</Frame>

## Settings

* **Image** — the picture to show. It fills the block at a wide aspect
  ratio, cropped to fit.
* **Caption** *(optional)* — a short line laid over the bottom of the
  image.
* **Link** *(optional)* — a URL to open when the image is tapped. With a
  link set, the image opens in a new tab and shows a small link badge.

## Tips

* Add as many Image blocks as you like — set each to half-width to place
  two side by side.
* For a swipeable row of several images, use the
  [Carousel](/pages/blocks/carousel) block instead.

<Card title="All blocks" icon="shapes" href="/pages/blocks">
  Back to the block reference.
</Card>