Brentwood has its own set of image and video blocks — photo cards, galleries, video-and-text panels and hero banners — that you drop into any page or post. They sit in the block inserter alongside the standard WordPress blocks, and every one of them starts with the word Brentwood, so they are easy to find. Each block has a Settings panel on the right where you choose its layout and options.
Every Brentwood block is added the same way:
Note
Not sure of the exact name? Just type Brentwood in the inserter search and every Brentwood block appears in the list.
The Brentwood Images block is a single picture card — an image with an optional number badge, a label and a caption. To build a row or grid of them, add several cards inside a Row or Columns block. Add a card, click the image area to upload or choose a picture, then set these:
| Card layout | What you get |
|---|---|
| Image + Label | The picture with a number badge and a big label, plus an optional chevron arrow and dash line over it. |
| Image + Caption | The picture with a caption bar along the bottom — the bar can fit the text or span the full width. |
| Slider | A slideshow of several images with navigation dots (and optional arrows and autoplay). Add each slide's image in the block. |
| Lightbox | Just the picture, with a magnifying-glass icon; clicking it opens the image full-screen. |
Under Behavior, choose what a click does: Go to a link (enter a Link URL, with an Open in new tab option) or Open a popup (modal) — a pop-up you fill with your own blocks (text, images, a Row layout), with a Popup width of Small, Medium, Large or Full. Other options let you show the whole image inside a coloured frame, round the corners, and turn the label, chevron or dash on and off.
The Brentwood Image Gallery arranges several photos into one tidy, pre-designed layout. Add the block and it shows a set of empty boxes — click each box to upload or choose an image, and give it Alt text and an optional Caption. Use Move left / Move right to reorder, or Clear image to empty a box. Clicking any photo on the live page opens a full-screen lightbox with previous / next arrows.
Pick the arrangement under Layout:
| Layout | What it looks like |
|---|---|
| Brick | Alternating columns of stacked and tall images. Good for a mixed set of photos. |
| Mosaic | A featured pattern with captions. |
| Feature | One tall image with two wide images beside it and a wide/small bottom row. |
| Single | A uniform grid of framed images, each shown whole. |
Depending on the layout you can adjust Columns, Gap and Row height. The Single layout adds an Image ratio (Square, Landscape, Portrait, or Match each image) and a Full bleed option to crop each photo to fill its frame. You can also round the bottom corners and switch on a small magnifier icon that hints each photo enlarges.
The Brentwood Video Text block shows a video beside a panel of text — a heading, a paragraph and an optional button. Add the block, then set the Source under Video:
The Layout options (1 to 7) arrange the video and text differently — side by side in various orders, with Reverse columns to flip the sides. Layout 6 is a full-width video on its own with no text column, and Layout 7 puts the media on the left with a number badge. Fill in the Heading and Body Text, and optionally:
The Brentwood Hero Card is the white text card that sits over a page's hero image or video. Add it as the first block on a page whose hero is switched on in Page Settings — it lines up over the hero media automatically. You can only add one per page.
The big H1 heading comes from the page title (or the Title Override in Page Settings), so you don't type it into the block. Everything else in the card is yours: add paragraphs, buttons or any block below the heading. A closing dash is added for you. In the Settings panel you can set the Title, Content and Dash alignment, and switch on a red Call to Action button (for example "Apply Now") with its own text and link.
Note
The hero media (the photo, gallery or video behind the card) is chosen in Page Settings, not in this block. The Page settings guide covers the hero types and how to set them.
Most pages don't need this. Heroes are normally built for you from Page Settings (see the Page settings guide) — that is the way to add a hero to a page. The Brentwood Hero (Manual) block exists only for the rare case where you want to place a video or image hero somewhere the page template doesn't cover.
If you do use it, it has two media modes: a full-bleed video (an autoplaying video with a poster image), or a carousel — a crossfading slideshow of images with navigation dots. As with the Hero Card, you add the white text card's content as blocks underneath, and can set the content alignment, the closing dash, and whether the hero spans the full width or the content width.
Important
Reach for Page Settings first. Only use the manual hero block if a page genuinely can't get its hero the normal way — otherwise you can end up with two heroes on the same page.
There is also a Brentwood Youtube List block for showing scheduled and archived livestreams. Because it works hand-in-hand with the Livestreams entries, it is covered in the Managing livestreams guide rather than here.