Pebble Theme
Pebble Theme
Theme Sections

Progress timeline

3 min read
image

Showcase a step-by-step progress timeline to highlight key milestones, benefits, or results over time in a clear and engaging layout.

How to add a Progress timeline section to your Shopify store

  1. In the theme editor (Customize), click Add section.
  2. Select Progress timeline section.
  3. Make necessary changes.
  4. Save.

How to customize a Progress timeline section

Section settings

SettingDescription
ContainerChoose the section width: full width or fixed within the page layout.
Progress bar colorSet the color of the vertical timeline/progress indicator.
image
Check out other section settings: Common settings available in most sections

Block settings

The Progress timeline section consists of three main blocks: Header, Media, and Timeline.

image

Use the Header block to create and customize the section’s heading and introductory content.

SettingDescription
AlignmentSet the header alignment: left, center, or right.
DevicesSwitch between desktop and mobile padding settings.
BottomAdjust the spacing below the header.

πŸ“¦ Nested dynamic blocks

  • Heading – Add a main title
  • Subheading – Provide supporting text above or below the heading
  • Text – Include additional descriptions or details
  • Image – Display an image or icon
  • Button – Add a call-to-action
πŸ“ Learn more: Basic
image

Add and customize images within the section, with controls for size, aspect ratio, and corner styling to fit your design.

SettingDescription
ImageUpload or select images to display in the section.
Aspect ratioControl how the image is scaled.
WidthAdjust the image width relative to its container.
Corner radiusSet the roundness of the image corners.

How to create the overlapping image layout

  1. Upload 2 images in the Media block
  2. Adjust the width settings for each image so that Image #2 overlaps Image #1
image

The Media block (images) becomes sticky while scrolling when the timeline content is long, keeping the visuals visible as users read through the timeline.

πŸ’‘ Best practices

  • Keep Image #2 smaller than Image #1 β†’ avoids visual clutter.
  • Use simple backgrounds for the overlay image.
  • Add corner radius (15–25px) for a softer, modern feel.
  • Make sure the overlap does not cover important parts (faces, product labels).
  • Recommended image ratio:
    • Image #1 (main/background image): Use a 4:5 or 3:4 portrait ratio to create a strong visual anchor and fill the space effectively.
    • Image #2 (overlay image): Use a 1:1 or slightly portrait (4:5) ratio to keep it compact and clean when overlapping.
  • Recommended width settings:
    • Set Image #1 to 70–80% width and Image #2 to 40–50% width to create a clean, balanced overlap.

The Media block can also be combined with the Spinning Icon Badge block to create a more dynamic and eye-catching visual layout, helping highlight key products, promotions, or brand messages.

πŸ“ Learn more: Basic
image

Displays a timeline item with customizable spacing and a badge to highlight key milestones or steps.

SettingDescription
Content row gapAdjust the spacing between timeline content elements.
Badge textSet the label displayed inside the timeline badge.
Badge colorChoose the text color of the badge.
Badge background colorSet the background color of the badge.

πŸ“¦ Nested dynamic blocks

  • Heading – Add a main title
  • Subheading – Provide supporting text above or below the heading
  • Text – Include additional descriptions or details
πŸ“ Learn more: Basic
Last updated