Docs

Image Box

An image with a title, text and an optional link, for cards and teasers.

On this page

The Image Box puts an image, a title, a short description and an optional link together in one card. Use it for service cards, project teasers, team members or articles. The whole card can be one link, and the image can zoom on hover.

Three image boxes: Residential interiors, Renovation planning and Workspace design, each with a room illustration, a description and a Learn more link
Three image boxes with a 4:3 image and a Learn more link.

Add an image box

  1. Insert it

    Open Insert in the left panel, find Image Box under Basic (or type image box in Search widgets) and click it or drag it onto the canvas.

  2. Choose the image

    Click Choose image in Content → Image box. Check the Alt text, or leave it empty when the image only decorates the card.

  3. Write the text

    Type the Title and Description, or double-click them on the canvas.

  4. Fill in Link, choose the Clickable area and add a Link text such as “Learn more”.

Settings

Settings marked Per device can differ on desktop, tablet and mobile (see Responsive editing). Fields that support dynamic tags can show data such as a post title or featured image (see Dynamic tags).

Content tab

Image box
SettingWhat it does
ImageThe image. Choose one from the media library, or use a URL. Supports dynamic tags.
Alt textDescribes the image for screen readers. Overrides the media library alt text; leave it empty when the image is decorative. Supports dynamic tags.
ResolutionThe image size WordPress serves. Smaller files load faster; pick one at least as wide as the image is shown. Default: Medium large.
TitleThe title of the card. Supports dynamic tags.
DescriptionA short description under the title. Supports dynamic tags.
Title HTML tagThe HTML tag of the title. It sets the heading level for search engines and screen readers, not the size. Default: H3.
LinkMakes the card a link. Supports dynamic tags.
Clickable areaWhich part is clickable: the whole box, the image and title, or only the link text. Options: Whole box, Image and title, Link text only. Default: Whole box. Shown when Link has a URL.
Link textAn optional call to action under the description, such as “Learn more”. Supports dynamic tags.
Link iconIcon after the link text. Shown when Link text is set.
Image positionPuts the image above, left or right of the text. Options: Top, Left, Right. Default: Top. Per device.
Vertical alignmentVertical alignment of the image when it sits left or right of the text. Options: Top, Middle, Bottom. Per device.
AlignmentAligns the text. Options: Left, Center, Right, Justify. Per device.

Design tab

Box
SettingWhat it does
PaddingSpace inside the box. Per device.
Border radiusRounds the corners of the box. Per device.
Normal › BackgroundBackground of the box.
Normal › BorderBorder of the box.
Normal › ShadowShadow of the box.
Hover › BackgroundBackground of the box on hover.
Hover › Border colorBorder color of the box on hover.
Hover › ShadowShadow of the box on hover.
Hover effectMoves or shadows the box on hover. Options: None, Lift, Shadow, Lift + shadow.
Lift distanceHow far the box moves up on hover. Shown when Hover effect is Lift or Lift + shadow.
Transition (ms)Duration of the hover change, in milliseconds.
Image
SettingWhat it does
WidthWidth of the image. Per device.
Aspect ratioCrops the image to a fixed shape. Per device.
Focal pointWhich part of the image stays visible when it is cropped. Shown when Aspect ratio is set.
Border radiusRounds the corners of the image. Per device.
BorderBorder of the image.
ShadowShadow of the image.
SpacingSpace between the image and the text. Per device.
Normal › CSS filtersBlur, brightness, contrast, saturation and hue of the image.
Hover › CSS filtersFilters of the image when the box is hovered.
Hover › Hover animationAn animation of the image when the box is hovered. Options: None, Zoom in, Zoom out, Grayscale to color, Dim. Default: Zoom in.
Hover › Zoom scaleHow much the image zooms, for example 1.08. Shown when Hover animation is Zoom in or Zoom out.
Content
SettingWhat it does
Content paddingSpace around the title and text. Per device.
Title › TypographyText style or font, size, weight and spacing of the title.
Title › ColorColor of the title.
Title › Hover colorColor of the title when the box is hovered.
Title › SpacingSpace between the title and the description. Per device.
Description › TypographyText style or font, size, weight and spacing of the description.
Description › ColorColor of the description.
Description › Hover colorColor of the description when the box is hovered.
Link text › TypographyText style or font, size, weight and spacing of the link text. Shown when Link text is set.
Link text › ColorColor of the link text. Shown when Link text is set.
Link text › Hover colorColor of the link text on hover. Shown when Link text is set.
Link text › SpacingSpace above the link text. Shown when Link text is set. Per device.
Shared Design sections

Every element also has these sections at the end of the Design tab.

SectionWhat it does
Spacing & positionMargin, padding, width, alignment in its container, order, position (relative, absolute, fixed), offsets, z-index and global classes. See Spacing, size & position.
Background & borderBackground, border, border radius, box shadow, overflow and opacity of the whole element. See Colors & backgrounds and Borders & shadows.
MaskCrops the element to a shape (circle, arch, blob, star…) or your own SVG or PNG. See Shape dividers & masks.

Behaviour tab

Behaviour sections

The Behaviour tab is the same for every element.

SectionWhat it does
Anchor & classesAn Anchor ID for #links and your own CSS classes.
AnimationsEntrance, scroll, hover and loop animations from presets or your own timeline. See Motion & effects.
Motion & effectsA simple entrance animation, transforms (also on hover), CSS and backdrop filters, and sticky positioning.
Scroll & mouse effectsMovement, rotation, scale, fade and blur while the page scrolls, and pointer effects (follow the pointer, 3D tilt).
VisibilityHide the element on desktop, tablet or mobile, or in dark or light mode. See Visibility.
ConditionsShow the element only when rules match, such as logged-in visitors, a date range or a URL parameter. See Display conditions.
InteractionsShow, hide or change other elements when this one is clicked, hovered or scrolled into view. See Interactions.
AttributesCustom HTML attributes for this element. See Anchor, classes & attributes.

Tips

  • Same-shaped images. Set Design → Image → Aspect ratio (for example 4:3) so every card in a row lines up, whatever the original file.
  • Side-by-side on tablet. Set Image position to Left on tablet for a compact list, and back to Top on mobile.
  • One link per card. Clickable area → Whole box makes the card one big tap target; don't add more links inside it.
  • Cards from posts. To show a card for each blog post, use a Loop Grid with a loop item instead of many image boxes.