Skip to content
Faith
⌘K
Skip to content

Image card

Overview

The Image card block shows an image that fills the card, with your content placed on top of it. You can add a color overlay so text stays readable, show a short label in the top-left corner, and add blocks such as a heading, text and button over the image. Use it for promo tiles, category highlights or editorial cards.

You can add these blocks inside an Image card: Heading, Text, Button, Icon, Icon box, Rating, Divider, Spacer, Group and Custom Liquid.

How to use

  1. In the theme editor, open the section or Group where you want the card.
  2. Click Add block and select Image card.
  3. Click Select image to upload or choose an image, then pick an Aspect ratio.
  4. Inside the card, click Add block to add a heading, text, button or other content.
  5. Set Alignment and Position to place the content on the image.
  6. Adjust the overlay, label, border and padding as needed.
  7. Click Save.

Settings

SettingsDescription
ImageThe background image of the card. A placeholder image shows until you select one.
Aspect ratioThe shape of the card: Portrait (4:5), Portrait (3:4), Square (1:1), Landscape (3:2) or Landscape (16:9). Default: Portrait (4:5).
LayoutControls where the content sits on the image.
AlignmentHorizontal alignment of the content: Left, Center or Right. Default: Left.
PositionVertical position of the content: Top, Center or Bottom. Default: Bottom.
Row gapSpace between the blocks inside the card on desktop (0–100 px). Default: 12 px.
Row gap mobileSpace between the blocks inside the card on mobile (0–100 px). Default: 8 px.
SizeControls the width and height of the card.
WidthCard width on desktop. Fit matches the content, Fill takes the available space, and Custom lets you set a percentage. Default: Fill.
Custom widthCard width on desktop as a percentage (5–100%). Default: 100%. Appears when Width is Custom.
Width mobileCard width on mobile: Fit, Fill or Custom. Default: Fill.
Custom widthCard width on mobile as a percentage (5–100%). Default: 100%. Appears when Width mobile is Custom.
Use full heightStretches the card to the height of the row it sits in. Useful when cards sit side by side and you want them all the same height. Off by default.
AppearanceControls the colors and border of the card.
Inherit color schemeUses the color scheme of the parent section. On by default.
Color schemeSets a different color scheme for this card only. It affects the text and button colors on the card. Appears when Inherit color scheme is off.
BorderAdds a border around the card: None or Solid. Default: None.
Border thicknessBorder width (0–10 px). Default: 1 px. Appears when Border is Solid.
Border opacityHow visible the border is (0–100%). Default: 100%. Appears when Border is Solid.
Corner radiusRounds the card’s corners (0–100 px). Default: 0 px.
OverlayA color layer between the image and the content.
Media overlayAdds a color layer over the image to improve text readability. On by default.
Overlay colorThe color of the overlay. Default: black (#000000). Appears when Media overlay is on.
Overlay opacityHow strong the overlay is (0–100%, in steps of 5). Default: 40%. Appears when Media overlay is on.
Overlay styleSolid covers the whole image evenly. Gradient fades from the overlay color to transparent. Default: Solid. Appears when Media overlay is on.
Gradient directionWhich way the gradient fades. Up is darkest at the bottom, Down darkest at the top, Left darkest on the left edge, and Right darkest on the right edge. Default: Up. Appears when Overlay style is Gradient.
LabelA small uppercase tag in the top-left corner of the card.
TextThe label text, for example “New” or “Limited”. Leave empty to hide the label.
ColorThe label text color. Default: white (#FFFFFF).
AnimationControls how the card appears when shoppers scroll to it.
Scroll animationNone, Fade in or Rise up. Default: Rise up.
Animation delayWaits before the animation starts (0–800 ms, in steps of 50). Use different delays on cards in a row for a staggered effect. Default: 0 ms. Appears when Scroll animation is not None.
PaddingSpace between the card edge and its content. The label follows the top and left padding.
DevicesChoose Desktop or Mobile to edit that device’s padding. The settings below change to match the device you choose.
TopSpace above the content. Desktop default: 32 px; mobile default: 24 px (0–100 px).
BottomSpace below the content. Desktop default: 32 px; mobile default: 24 px (0–100 px).
LeftSpace on the left. Desktop default: 32 px; mobile default: 24 px (0–100 px).
RightSpace on the right. Desktop default: 32 px; mobile default: 24 px (0–100 px).

Tip: With content at the bottom, use Overlay style: Gradient with Gradient direction: Up. The image stays bright at the top and the text area stays readable.

Tip: Text on images must meet contrast guidelines. If your text is hard to read, raise Overlay opacity or choose a color scheme with a lighter text color.

Note: If you use a Label, keep the top content clear of the top-left corner (for example, set Position to Bottom) so the label and the content don’t overlap.

Was this helpful?
Previous Image Block Next Section Heading Block