Featured

The Featured block puts a hand-picked set of items (events, posts, people, and more) into a single carousel, with one slide for each item. Use it when you want to spotlight a small, curated line-up rather than an auto-generated list, such as a "Don't miss" strip of upcoming shows, a rotating set of featured artists, or a few highlighted posts on the homepage.

Each slide shows the title, image, and description of the item you choose, so the carousel stays current as that item changes. You can override any of those details slide by slide when you want different wording or artwork.

Building the slides

On the Slides tab, add a slide for each item you want to feature, then set how that slide looks. Every slide starts from the item you pick and shows its own details unless you override them.

• Document: the picker for the item this slide features. Select an event, post, page, person, season, series, work, venue, or organization.
• Change Title: turn on to replace the item's own title with your own. With it on, type the replacement into Title Override. Off by default, so the slide uses the item's title.
• Show Prefix: turn on to print a short line above the title (for example, "Now booking"). Type it into Prefix. Off by default.
• Show Suffix: turn on to print a short line after the title. Type it into Suffix. Off by default.
• Show Description: turn on to include a description on the slide. Off by default. With it on:
  • Use Document Description: keep this on (the default) to use the item's own description, or turn it off to write your own in Description.
• Show Date: turn on to show the item's date, where it has one. Off by default.
• Change Media: turn on to use your own image for this slide instead of the item's. With it on, pick the image in Media. Off by default, so the slide uses the item's image.
• Show Button: show a button linking to the item. On by default. Set its label in Button Text (defaults to Learn More).

Carousel behavior

The Carousel tab controls how slides advance and which navigation a reader sees.

• Show Arrows: show previous and next arrows. On by default.
• Show Indicators: show the row of dots marking each slide. On by default. With it on:
  • Indicator Width: Small (default), Medium, Large, or Full.
  • Indicator Style: None, Filled (default), or Outlined.
• Navigation Style: the look of the navigation controls: None (default), Filled, or Outlined.
• Orientation: Horizontal (default) or Vertical.
• Transition: how one slide changes to the next: None, Slide (default), or Fade.
• Autoplay: advance the slides automatically. On by default.
• Show Progress: show a progress indicator as slides advance. On by default.

Layout

The Layout tab arranges each slide.

• Width: Full Width, Page (default), or Narrow.
• Height: Small, Medium, Large, Full (default), or Custom, which reveals a Custom Height slider from 200 to 1000 px.
• Layout: how the media and text sit together: Half Background (Vertical), Half Background (Horizontal) (default), or Full Background. The half-background options add Media Placement, a media size (Media Width or Media Height), and a Full Bleed Media toggle.
• Direction, Alignment, Position, and Section Gap (Small / Medium / Large) place the content within the slide.

With Full Background, a Content Background group can sit a colored panel behind the text: turn on Enable, then set its Width, Height, Background Color, Background Opacity, and Text Color.

Collapsible Description and Buttons groups fine-tune the alignment and width of those parts.

Appearance

The Appearance tab sets the look.

• Color scheme: Select a color scheme from your theme. Turn on Custom Colors to override with your own Background Color and Text Color.
• A Media group sets Media Position (Cover or Fit) and Media Overlay, which can layer a Color and an Effect over the slide media. The color overlay can be Solid or a Gradient (with a direction), plus a Blur. The effect can be Grayscale or Sepia.
• Style groups for Tags (Size / Transform / Border), Title (font Size, a Title Style of Bold and/or Italic, a Prefix / Suffix Size, and a Gap), and Description (Size) set the type for each part.
• A Button group styles the slide buttons. Pick a Button Pattern from your theme (left empty, it uses your theme's first button pattern). Optionally add an Icon with an Icon Position of Before Text (default) or After Text.

Shared controls

Beyond the options above, the Featured block uses the standard block controls. They work the same here as elsewhere.

• Layout controls: the standard container behavior behind the Layout tab.
• Background and overlay: the overlay model used by the Appearance tab's Media group.
• Buttons and links: button patterns and icons for the slide button.
• Colour scheme in blocks: apply a theme color scheme.
• Spacing and padding: adjust the margin and padding around the block.

Example

To build a homepage "Don't miss" carousel of three upcoming shows, add a Featured block and, on the Slides tab, add a slide and pick each event in the Document picker. Turn on Show Prefix and set the Prefix to "Now booking" on each. Leave Show Button on with Button Text as Learn More, and let the title, image, and description come from each event. On the Carousel tab, keep Autoplay and Show Indicators on so the strip rotates on its own. On the Layout tab, set the Layout to Full Background so each event's image fills the slide. On the Appearance tab, add a dark Media Overlay so the titles stay legible over bright artwork. Each event's details stay in sync as you update the event, while the prefix and button wording stay exactly as you set them.

Where to go next