Card
Control how each item looks inside a Collection or Featured block.
A Card is a single item inside a listing — the title, image, and supporting details that a Collection or Featured block shows for each entry. You don't add a Card to the page on its own; you edit the card to set what each item displays and how it is laid out.
The card's Type decides which details it can hold. An event card carries a date and venue; a person card carries a role and pronouns. Set the type to match the content the listing is showing, then fill in the fields it reveals.
Type
Type is set at the top of the card and defaults to Basic. Choosing a type changes which fields appear below.
| Type | Best for |
|---|---|
| Basic | A general-purpose card with a subheading and description. |
| Event | A production or performance, with date, venue, season, series, and times. |
| Post | An article, with an excerpt, author, and publish date. |
| Blog | A blog entry, with an excerpt, author, and publish date. |
| Person | A team member or artist, with a role and pronouns. |
| Season | A programming entry with a description. |
| Series | A programming entry with a description. |
| Work | A programming entry with a description. |
| Venue | A location, with an address. |
| Organization | A general entry with a description. |
| Page | A general entry with a description. |
| News | A news item, with an excerpt, author, publish date, and category. Unlike Post and Blog, it opens through a labelled button rather than a single link. |
Details
Every card has a Title (required) and a Media image. The remaining fields depend on the type:
- Subheading — a short line under the title. Basic and Event.
- Description — a longer summary. Basic, Event, Organization, Page, Season, Series, and Work.
- Excerpt — a short preview of an article. Post, Blog, and News.
- Author and Publish Date — the writer and date of an article. Post, Blog, and News.
- Date, Event Type, Venue, Season — text details for a performance. Event.
- Series — one or more series names, each added as its own entry. Event.
- Times — one or more showtimes (for example,
4:15pm), each added as its own entry. Event. - Role and Pronouns — a person's title and pronouns. Person.
- Address — a location's address. Venue.
- Category — a label for a news item. News.
Where the card links
Most card types have a single Link field — the page the card opens when clicked.
A News card is the exception: instead of a single link it uses Button Text and Button Link to show a labelled button.
Every card also has a Button Text field. Leave it empty to use the default button text set on the surrounding Collection or Featured block, or fall back to your global settings; fill it in to override the wording for this one card.
Layout
By default a card follows the layout preset from your theme. Use preset layout is on, so its look stays consistent with every other card in the listing. Turn it off to set the layout for this card by hand. The fields below then appear:
- Layout — where the image sits relative to the text: Media Header (Vertical) (default, image above the text), Media Background (text over a full-bleed image), or No Media (text only).
- Height — Fill (default, matches the tallest card in the row) or Auto (sizes to its own content).
- Aspect Ratio — the image shape: Portrait, Square (default), Landscape, or Wide.
When the card shows an image, a Media group fine-tunes it: Media Position (Cover or Fit), Adhere to Card Padding (keep the image inside the card's padding instead of edge-to-edge), and Media Overlay to lay a Color and an Effect over the image — each can be turned on, and both can be combined. The colour overlay adds Overlay Style (Solid or Gradient, with a Gradient Direction of up, down, left, or right) and Blur; the Effect option applies a grayscale or sepia treatment.
A Structure group controls how the text is arranged: Alignment (Top, Center, Bottom, or Space Between), Position (Left, Center, Right), Horizontal Padding and Vertical Padding, and the Section Gap between the title, body, and footer.
Further groups below set the type styling for the card's text, so you can refine each part independently when the preset layout is off:
- Title — heading Size (P, H6, H5, H4, H3) and a bold or italic Title Style.
- Body — Size, an uppercase Transform, and Width (Fit or Fill) with a Max Width (Narrow, Normal, or None).
- Footer — Size, an uppercase Transform, and Alignment (Row or Stacked).
A Tags group styles the small labels shown on a card: Size (Small, Medium, Large), Style (None, Filled, Outline, or Soft), Rounding (None, Rounded, or Pill), where they sit, whether they sit on or below the image, whether they Adhere to Card Padding, and their Alignment (Row or Stacked).
A Details group arranges the card's detail attributes: Alignment (Row or Stacked) and a Show Detail Label toggle that shows each attribute's label next to its value.
Decoration
The Decoration group sets the card's colours and border:
- Background Color Scheme — the colour scheme applied behind the card.
- Custom Colors — turn on to set a specific Background Color and Text Color instead of the scheme.
- Border — No Border (default) or Border.
Shared controls
Cards reuse the standard block controls for the rest of their styling.
- Buttons and links — how the card's link or button is styled.
- Colour scheme in blocks — how colour schemes work, for the card's Background Color Scheme.
- Spacing and padding — the card's margin and padding.
Example
To list upcoming productions, add a Collection and set each card's Type to Event. Give the card a Title (the production name), a Media image, a Date, and a Venue, then add each showtime under Times. Leave Use preset layout on so every event in the listing matches your theme, and set Link to the event page so the whole card is clickable.