Docs

Image section

The Image section of Borders shows one image, with a separate mobile image, a media shape and an optional link.

Applies to: Borders 3.1.0 and later. Added in: Borders 1.0.0. Last checked: 2026-10-13 against Borders 3.1.0.

The Image section shows one image across the width of the page, at the image's own proportions, with an optional separate image for mobile and an optional link.

Where to find it: select Add section in the theme editor, then choose Image.

Content

  • Image is the picture. Borders shows it at its own aspect ratio: nothing is cropped, so a tall image makes a tall section.
  • Mobile image (optional) replaces the image on screens narrower than 768 px, for example a portrait crop for phones.
  • Media shape rounds two or all corners of the image into a half circle: Top rounded, Right rounded, Bottom rounded, Left rounded or Fully rounded. None keeps the grid's corner radius.
  • Link makes the whole image a link, with the hover effect set in Theme settings → Animations → Image mouse over animations.
  • Open link in a new window opens the link in a new browser tab. It shows only when Link is set.

Inner content design

  • Remove border radius gives the image square corners.
  • Remove inner padding & border radius removes the grid padding as well, so the image runs edge to edge.
  • Hide section if dynamic content is not present hides the whole section when Image is empty, for example when it is connected to a product or collection metafield that a page does not have.

The Section heading and Section design settings are the shared ones: see General section styling.

Why is my image cropped differently on mobile?

It is not cropped; you probably set a Mobile image (optional). Below 768 px wide Borders shows the mobile image instead, at its own proportions. Remove it to show the main image on every screen.

Can I add text or a button over the image?

No. The Image section shows the image only. For text over an image, use the Rich text section with Overlap content on desktop, or a Rich blocks section block with an image.

All Image settings

Every setting on this page, with its type and default.

On this page