All docs

Brand Story

Editorial story builder

Section handle: editorial-story-builder

Settings

Appearance

SettingTypeDefaultDescription
Section paddingDropdownstandardCompact reduces the space below the section. Standard keeps the space below equal to Block spacing. · Options: compact – Compact, standard – Standard
Block spacingDropdowncomfortableSpace 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 titleToggle (on/off)OffThe 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 spreadsToggle (on/off)OnShows a large number (01, 02, 03…) on each Spread block, counted in order through the section.

Blocks

Maximum blocks: 20

Plate

Block type: plate

SettingTypeDefaultDescription
ImageImage—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.
FilmVideo—A hosted video. A button plays it over the plate, with controls; it never plays on its own.
Film button labelText—Blank uses "Play film".
EyebrowText—A short line shown above the heading.
HeadingText—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.
TextMulti-line text——
Link labelText—The button shows only when both Link label and Link are filled in.
LinkURL / Link—Where the button on the plate goes. Leave blank to hide the button.
Button styleDropdownsecondaryStyle of the link beside the heading. Links on points are always text links. · Options: primary – Primary, secondary – Secondary, link – Text link
HeightDropdowntallTall fills most of the screen height; Standard is about two-thirds of it. · Options: standard – Standard, tall – Tall

Spread

Block type: spread

SettingTypeDefaultDescription
ImageImage—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.
VideoVideo—Replaces the image. Shoppers start it with the play control; the image is its poster.
Image descriptionText—Blank uses the image's own description.
Image sideDropdownstartStart is the left side in left-to-right languages. On phones the image always sits above the text. · Options: start – Start, end – End
EyebrowText—A short line shown above the heading.
HeadingText——
TextRich text——
Product shownProduct—Adds a line linking to the product, with its price.
Link labelText—The link shows only when both Link label and Link are filled in.
LinkURL / Link—Where the spread's link goes. Leave blank to hide the link.
Button styleDropdownlinkStyle 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

SettingTypeDefaultDescription
EyebrowText—A short line shown above the heading.
HeadingText—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 textMulti-line text——

Rich text

Block type: rich_text

SettingTypeDefaultDescription
HeadingText——
Rich text bodyRich text——

Image

Block type: image

SettingTypeDefaultDescription
ImageImage——
Alternative textText—Describes the image for screen readers. Blank uses the image's own description.
CaptionRich text——
Image ratioDropdownnaturalNatural 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 emphasisDropdownstandardWide 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

SettingTypeDefaultDescription
First imageImage——
First image alternative textText—Describes the image for screen readers. Blank uses the image's own description.
First image captionRich text——
Second imageImage——
Second image alternative textText—Describes the image for screen readers. Blank uses the image's own description.
Second image captionRich text——
Pair ratioDropdownnaturalNatural 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
EmphasisDropdownbalancedMakes 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

SettingTypeDefaultDescription
QuoteMulti-line text——
AttributionText——
Context or roleText——

Highlight

Block type: highlight

SettingTypeDefaultDescription
ValueText—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.
SuffixText—Shown smaller after the value, for example % or hrs.
LabelText—A short description shown under the value.
Supporting textMulti-line text——

Products

Block type: products

SettingTypeDefaultDescription
HeadingText——
Products fromDropdownproductsChosen 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
ProductsProduct list—Used when Products from is Chosen products. Up to 8, shown as product cards.
CollectionCollection—Used when Products from is A collection.
Products to showSlider4How 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 collectionToggle (on/off)OnAdds a View all link next to the heading. Only shown when Products from is A collection.

Call to action

Block type: cta

SettingTypeDefaultDescription
HeadingText——
Supporting textMulti-line text——
Link labelText—The whole block shows only when both Link label and Link are filled in.
LinkURL / Link—Where the button goes. The whole block stays hidden until both a label and a link are set.
Button styleDropdownprimaryStyle 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

SettingTypeDefaultDescription
Video typeDropdownhostedShopify-hosted uses Shopify-hosted video; External uses External URL. The other setting is ignored. · Options: hosted – Shopify-hosted, external – External
Shopify-hosted videoVideo—Used when Video type is Shopify-hosted. It plays only when the shopper presses play.
External URLURL / Link—Used when Video type is External. Paste a YouTube or Vimeo link; other sites are not supported.
Poster imageImage—Shown before the video plays. Only used for Shopify-hosted videos.
Poster alternative textText—Describes the poster image. Only used for Shopify-hosted videos; blank uses the image's own description.
CaptionRich text——
Aspect ratioDropdown16-9Options: 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