Brand Story
Editorial story builder
Section handle:
editorial-story-builder
Settings
Appearance
| Setting | Type | Default | Description |
|---|---|---|---|
| Section padding | Dropdown | standard | Compact reduces the space below the section. Standard keeps the space below equal to Block spacing. · Options: compact – Compact, standard – Standard |
| Block spacing | Dropdown | comfortable | Space between blocks: Tight 48px, Comfortable 72px, Relaxed 96px. It also sets the space below the section. · Options: tight – Tight, comfortable – Comfortable, relaxed – Relaxed |
| Use the first heading as the page title | Toggle (on/off) | Off | The first Plate or Story intro heading becomes the page's H1. Turn off the page title in the page section so there is only one. |
| Number the spreads | Toggle (on/off) | On | Shows a large number (01, 02, 03…) on each Spread block, counted in order through the section. |
Blocks
Maximum blocks: 20
Plate
Block type:
plate
| Setting | Type | Default | Description |
|---|---|---|---|
| Image | Image | — | Shown full width behind the heading, and as the film's poster. Alt text comes from the image's own description, so set it on the image. |
| Film | Video | — | A hosted video. A button plays it over the plate, with controls; it never plays on its own. |
| Film button label | Text | — | Blank uses "Play film". |
| Eyebrow | Text | — | A short line shown above the heading. |
| Heading | Text | — | Becomes the page's main heading (H1) when it is the section's first heading and Use the first heading as the page title is on. |
| Text | Multi-line text | — | — |
| Link label | Text | — | The button shows only when both Link label and Link are filled in. |
| Link | URL / Link | — | Where the button on the plate goes. Leave blank to hide the button. |
| Button style | Dropdown | secondary | Style of the link beside the heading. Links on points are always text links. · Options: primary – Primary, secondary – Secondary, link – Text link |
| Height | Dropdown | tall | Tall fills most of the screen height; Standard is about two-thirds of it. · Options: standard – Standard, tall – Tall |
Spread
Block type:
spread
| Setting | Type | Default | Description |
|---|---|---|---|
| Image | Image | — | Shown beside the text on larger screens and above it on phones, cropped to fill. Also the video's poster when a video is chosen. |
| Video | Video | — | Replaces the image. Shoppers start it with the play control; the image is its poster. |
| Image description | Text | — | Blank uses the image's own description. |
| Image side | Dropdown | start | Start is the left side in left-to-right languages. On phones the image always sits above the text. · Options: start – Start, end – End |
| Eyebrow | Text | — | A short line shown above the heading. |
| Heading | Text | — | — |
| Text | Rich text | — | — |
| Product shown | Product | — | Adds a line linking to the product, with its price. |
| Link label | Text | — | The link shows only when both Link label and Link are filled in. |
| Link | URL / Link | — | Where the spread's link goes. Leave blank to hide the link. |
| Button style | Dropdown | link | Style of the link beside the heading. Links on points are always text links. · Options: primary – Primary, secondary – Secondary, link – Text link |
Story intro
Block type:
story_intro
| Setting | Type | Default | Description |
|---|---|---|---|
| Eyebrow | Text | — | A short line shown above the heading. |
| Heading | Text | — | Becomes the page's main heading (H1) when it is the section's first heading and Use the first heading as the page title is on. |
| Lead text | Multi-line text | — | — |
Rich text
Block type:
rich_text
| Setting | Type | Default | Description |
|---|---|---|---|
| Heading | Text | — | — |
| Rich text body | Rich text | — | — |
Image
Block type:
image
| Setting | Type | Default | Description |
|---|---|---|---|
| Image | Image | — | — |
| Alternative text | Text | — | Describes the image for screen readers. Blank uses the image's own description. |
| Caption | Rich text | — | — |
| Image ratio | Dropdown | natural | Natural keeps the image's own shape. Landscape (3:2), Portrait (4:5) and Square crop it to that shape. · Options: natural – Natural, landscape – Landscape, portrait – Portrait, square – Square |
| Width emphasis | Dropdown | standard | Wide runs the image edge to edge across the screen. Standard keeps it within the page margins. · Options: standard – Standard, wide – Wide |
Image pair
Block type:
image_pair
| Setting | Type | Default | Description |
|---|---|---|---|
| First image | Image | — | — |
| First image alternative text | Text | — | Describes the image for screen readers. Blank uses the image's own description. |
| First image caption | Rich text | — | — |
| Second image | Image | — | — |
| Second image alternative text | Text | — | Describes the image for screen readers. Blank uses the image's own description. |
| Second image caption | Rich text | — | — |
| Pair ratio | Dropdown | natural | Natural keeps each image's own shape. Landscape (3:2), Portrait (4:5) and Square crop both images to that shape. · Options: natural – Natural, landscape – Landscape, portrait – Portrait, square – Square |
| Emphasis | Dropdown | balanced | Makes the chosen image wider than the other on larger screens. On phones the images stack at full width. · Options: balanced – Balanced, first – First image, second – Second image |
Pull quote
Block type:
pull_quote
| Setting | Type | Default | Description |
|---|---|---|---|
| Quote | Multi-line text | — | — |
| Attribution | Text | — | — |
| Context or role | Text | — | — |
Highlight
Block type:
highlight
| Setting | Type | Default | Description |
|---|---|---|---|
| Value | Text | — | The large figure, for example 48. Highlight blocks placed next to each other line up in one row, up to four across on larger screens. |
| Suffix | Text | — | Shown smaller after the value, for example % or hrs. |
| Label | Text | — | A short description shown under the value. |
| Supporting text | Multi-line text | — | — |
Products
Block type:
products
| Setting | Type | Default | Description |
|---|---|---|---|
| Heading | Text | — | — |
| Products from | Dropdown | products | Chosen products uses the Products list; A collection uses Collection and Products to show. The other settings are ignored. · Options: products – Chosen products, collection – A collection |
| Products | Product list | — | Used when Products from is Chosen products. Up to 8, shown as product cards. |
| Collection | Collection | — | Used when Products from is A collection. |
| Products to show | Slider | 4 | How many products to show from the collection, 2 to 8. Only used when Products from is A collection. · Min: 2 · Max: 8 |
| Show a link to the collection | Toggle (on/off) | On | Adds a View all link next to the heading. Only shown when Products from is A collection. |
Call to action
Block type:
cta
| Setting | Type | Default | Description |
|---|---|---|---|
| Heading | Text | — | — |
| Supporting text | Multi-line text | — | — |
| Link label | Text | — | The whole block shows only when both Link label and Link are filled in. |
| Link | URL / Link | — | Where the button goes. The whole block stays hidden until both a label and a link are set. |
| Button style | Dropdown | primary | Style of the link beside the heading. Links on points are always text links. · Options: primary – Primary, secondary – Secondary, link – Text link |
Video
Block type:
video
| Setting | Type | Default | Description |
|---|---|---|---|
| Video type | Dropdown | hosted | Shopify-hosted uses Shopify-hosted video; External uses External URL. The other setting is ignored. · Options: hosted – Shopify-hosted, external – External |
| Shopify-hosted video | Video | — | Used when Video type is Shopify-hosted. It plays only when the shopper presses play. |
| External URL | URL / Link | — | Used when Video type is External. Paste a YouTube or Vimeo link; other sites are not supported. |
| Poster image | Image | — | Shown before the video plays. Only used for Shopify-hosted videos. |
| Poster alternative text | Text | — | Describes the poster image. Only used for Shopify-hosted videos; blank uses the image's own description. |
| Caption | Rich text | — | — |
| Aspect ratio | Dropdown | 16-9 | Options: 16-9 – 16:9, 4-5 – 4:5, square – Square |
Narrative break
Block type:
narrative_break
No configurable settings for this block type.
Default Configuration
When you add this section from the Theme Editor, it comes pre-configured with:
- Story — 1× Story intro, 1× Rich text
- Image banner — 1× Plate
- Image with text — 1× Spread
- Rich text — 1× Rich text
- Video — 1× Video
- Quote — 1× Pull quote
- Gallery — 1× Image pair