Documentation

Timeline section: your story or your steps

Tell your brand's key dates or explain how something works in steps, on a vertical, alternating or horizontal line.

The Timeline section connects steps with a line: your brand's key dates on an "Our story" page, or the steps of an order in a "How it works". The line can fill as the customer scrolls, which guides the eye from one step to the next.

The Timeline section on the Ma Petite Ruche demo: a gold vertical line, dates from 1978 to 2021 and photos alternating left and right
The Timeline section on the Ma Petite Ruche demo: a gold vertical line, dates from 1978 to 2021 and photos alternating left and right

The variants (presets)

The two variants are in the Text category of the picker.

Our story

A heading, then four steps alternating on either side of a vertical line: the date on one side, the title and text on the other. Add an image to each step to get the Ma Petite Ruche look above.

The Our story variant: four dates (2014, 2017, 2021, 2025) alternating on either side of a dotted vertical line
The Our story variant: four dates (2014, 2017, 2021, 2025) alternating on either side of a dotted vertical line

How it works

A heading, three horizontal steps marked by numbers in circles, and a button. To explain in three stages how to order, use a product or enjoy a service.

The How it works variant: three numbered circles connected by a line, each with a title and a text, and a Shop now button
The How it works variant: three numbered circles connected by a line, each with a title and a text, and a Shop now button

On mobile, the horizontal timeline becomes a swipeable row: the next step peeks in at the right edge.

The How it works variant on mobile, the second step cut off at the right edge
The How it works variant on mobile, the second step cut off at the right edge

Example on the Maison Mocha demo

Maison Mocha tells its story with a horizontal dotted timeline, without images, on the beige palette of its "Our story" page:

Maison Mocha's horizontal timeline: four dots connected by a line, from "2019" to "Today", each with a title and a text
Maison Mocha's horizontal timeline: four dots connected by a line, from "2019" to "Today", each with a title and a text

On phones, the same timeline is swiped with a finger:

Maison Mocha's timeline on mobile, the first two steps visible and the rest to swipe
Maison Mocha's timeline on mobile, the first two steps visible and the rest to swipe

Add the section

  1. In your Shopify admin, open Online Store > Themes and click Edit theme.
  2. Pick the template in the top menu (for example the page that uses the story template).
  3. Click Add section, open the Text category and choose Our story or How it works.
  4. Click each Step to fill in the date, title, text and image.
  5. Click Save.
Screenshot to take — Shopify theme editor > Our story page > Timeline section: sidebar with Heading, Timeline > Step ×4, Timeline block settings panel open (Layout, Marker, Line)

The section's blocks

BlockWhat it's for
HeadingThe heading above the timeline.
TimelineThe line and its layout: arrangement, markers, colors.
StepOne step of the timeline (inside the Timeline block).
ButtonA link below the timeline (How it works variant).

The Timeline block

The Timeline block up close, Horizontal layout: three numbered markers connected by a line, each with a title and a text
The Timeline block up close, Horizontal layout: three numbered markers connected by a line, each with a title and a text
  • Layout: Vertical (default), Alternating or Horizontal.
  • Mobile layout (horizontal timeline): Swipe sideways (default) or Stacked.
  • Alignment (horizontal timeline): Left or Center.
  • Media position (Top or Bottom) and Image ratio (Adapt to image, Portrait, Square, Landscape).
  • Card style: None or Card (each step on a background).
  • Step Title size (22 px by default).
  • Marker group: Style (Dot, Numbers, Icon, Image) and Size.
  • Line group: Line style (Solid, Dashed, Dotted), Thickness and Fill the line while scrolling (checked by default).
  • Colors group: Line color, Progress color, marker Text color. Left empty, they follow the theme.

The Step block

  • Subheading: the date or label ("2024", "Step 1").
  • Title and Text.
  • Image: a photo for the step.
  • Icon: used when the marker is in Icon style, with an optional Custom icon.

A step also accepts other theme blocks (a button, a checklist) with Add block.

The section settings

The section only has the frame shared by almost every section: Layout, Color palette, Separators and Animations. Ma Petite Ruche picks a dark palette to make its golden photos stand out. The frame is explained in Understand the theme editor.

Tips and pitfalls

  • Three to six steps are enough. A timeline with ten dates doesn't get read: keep the moments that explain why your brand exists.
  • In Horizontal layout, keep texts short: each step only has the width of one column.
  • Images with the same aspect ratio make a regular timeline: choose a fixed Image ratio (Landscape or Square) rather than Adapt to image.
  • Fill the line while scrolling animates the line. Like every animation in the theme, it respects the visitor's device "reduce motion" setting.
  • For steps without a line or markers, as cards, the Numbered steps variant of the Multicolumn section is simpler.

Go further