Photo Feature

Let your photography shine with a print-style layout.

View demo

Usage

The Photo Feature block puts a big photo front and center with a magazine-style layout: a full-width background image with a headline, body copy, and an optional button on top. Content is kept to a headline, paragraphs or lists, and one button so the photo stays the focus.

For a simpler photo-beside-text layout, use the Photo & Text starter in Columns. Use Call To Action when you need column sizing and container styling.

Layout

  • Background Image β€” full-width photo behind all content (sidebar Background Image + BG Focal Point)
  • Content Origin β€” places the text panel on the Left or Right half of the image. Unlike some blocks, this also applies on mobile.
  • Content Width β€” Full runs the text panel to the edge of the block; Wide keeps it within your site's wide content width

The headline is always an H3 in the page outline. Headline Style only changes how it looks (h1–h6 or paragraph styles from your Customizer).

Style

Two presentation modes affect how text sits over the photo:

  • Seamless (default) β€” text sits on a soft gradient that fades into the photo. Darkening controls how strong the gradient is (0–100%). With light text the gradient is black; with dark text, white.
  • Boxed β€” no gradient; content sits on a solid panel with rounded corners (from your site's corner radius setting). Light text gets a dark panel, dark text a light panel. Darkening controls how solid the panel is.

Content

  • Headline β€” edit inline in the editor or in the sidebar
  • Body copy β€” paragraph and list blocks only; keep to a few sentences
  • Button Link β€” set a URL in the sidebar or toolbar to reveal the button; edit button text inline (defaults to "Learn More")
  • Link Style β€” Button or Understated

Appearance

  • Text Color (reverse print) β€” light or dark text, also on the toolbar as White Text. Defaults to light text for readability over photos.
  • Headline Style β€” how the headline looks
  • Darkening β€” gradient strength (Seamless) or panel opacity (Boxed), 0–100%

Block width

Photo Feature supports Wide and Full alignment from the block toolbar and defaults to Full width so the photo runs edge to edge.

Tips

  • Set BG Focal Point so the subject stays visible when the image crops at different sizes.
  • Start with Seamless + moderate Darkening for editorial photo bands; switch to Boxed when you want a distinct card over the image.
  • Use Content Origin to balance composition β€” place text on the side with more negative space in the photo.
  • Add the button URL before expecting a visible CTA; without a link, no button renders on the front end.

Screenshots

Front-end

  • Boxed style on a dark gallery interior β€” light overlay panel with headline, body copy, and an understated link on the left.
  • Two features on one page β€” Boxed panels alternate left and right over gallery and workshop photos.

Editor

  • Seamless mode β€” Settings panel with Text Color, Headline, Darkening, Background Image, and BG Focal Point.
  • Boxed style selected β€” white overlay panel on a gallery photo with Style, Link Style, and Darkening at 85.

Settings

Settings

Content Width setting in the block editor sidebar
Content Width

**Full** lets the text panel run to the edge of the block; **Wide** keeps it within your site's wide content width.

  • Full
  • Widedefault
Content Origin setting in the block editor sidebar
Content Origin

Places the text panel on the left or right half of the photo, on mobile as well as desktop.

  • Leftdefault
  • Right
Style setting in the block editor sidebar
Style

Seamless integrates text with a directional gradient over the photo. Boxed places content on a solid rounded overlay panel instead.

  • Seamlessdefault
  • Boxed
Text Color setting in the block editor sidebar
Text Color

Light or dark text. Also sets the backdrop behind it: light text gets a dark gradient or box, dark text a light one. Also on the toolbar as **White Text**.

  • Dark
  • Light
Headline setting in the block editor sidebar
Headline

You can also type the headline directly on the photo.

Headline Style setting in the block editor sidebar
Headline Style

Changes how the headline looks. It stays an H3 in the page outline whichever style you pick.

  • h1
  • h2
  • h3default
  • h4
  • h5
  • h6
  • p
Button Link setting in the block editor sidebar
Button Link
Link Style setting in the block editor sidebar
Link Style

Button or Understated style for the optional link below the body copy.

  • Buttondefault
  • Understated
Darkening setting in the block editor sidebar
Darkening

In Seamless mode, controls gradient opacity behind content (black gradient with reverse print, white without). In Boxed mode, controls solid overlay opacity.

BG Focal Point setting in the block editor sidebar
BG Focal Point

Keeps the key subject of the background photo in frame when it's cropped.