# Progress timeline ![image](https://docs-assets.foxecom.app/pebble-theme/Fox-BG%20Light%20\(25\)_Q8RLRiyi.jpg) Walk customers through steps, milestones, or results over time, such as "Week 1", "Week 2", and "Week 3" of using a product. Each step sits on a progress bar next to overlapping images that stay in view while customers scroll. ## How to customize the Progress timeline section 1. Open the page where you want to display the section in the theme editor by clicking **Edit theme**. 2. Click **Add section**. 3. Select **Progress timeline**. 4. Click the **Header** block to edit the heading content. 5. Click the **Media** block and click **Select** next to **Image** under **Image #1** and **Image #2** to add the images. 6. Click a **Timeline** block and enter the step label in **Text** under **Badge**, such as "Week 1". 7. Edit the **Heading** and **Text** blocks inside the **Timeline** block. 8. To add another step, click **Add block** under the section and select **Timeline**. 9. Click **Save**. ## Section settings ### Layout | Setting | Description | Options | | ------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | | **Container** | Controls the width of the section content. | **Full:** Uses the available page width.

**Fixed:** Keeps the content within the theme's fixed container width. |
### Progress bar | Setting | Description | Options | | --------- | -------------------------------------------- | --------------------------------- | | **Color** | Sets the color of the vertical progress bar. | Pick a color or enter a hex code. |
![image](https://docs-assets.foxecom.app/pebble-theme/image_RDrcnPDD.png) ### Appearance | Setting | Description | Options | | ---------------- | ----------------------------------------------------------------------------------------------------------------- | :-------------------------------- | | **Color scheme** | Applies a theme color scheme to the section. Learn more in [Colors](https://docs.foxecom.com/pebble-theme/theme-settings/colors). | Select an available color scheme. |
### Padding Controls the top and bottom spacing separately for desktop and mobile. | Setting | Description | Options | | ----------- | ------------------------------------------------------------- | :------------------------- | | **Devices** | Selects which device-specific padding values you are editing. | **Desktop** or **Mobile**. | | **Top** | Controls the space above the section content. | **0–100px**. | | **Bottom** | Controls the space below the section content. | **0–100px**. |
## Blocks By default, the section includes a **Header** block, a **Media** block, three **Timeline** blocks, and a **Button** block. ### Header ![image](https://docs-assets.foxecom.app/pebble-theme/image_iMcuRZdk.png) The **Header** block holds the heading content above the timeline. | Setting | Description | Options | | ------------- | ------------------------------------------------------------- | ------------------------------- | | **Alignment** | Sets the alignment of the header content. | **Left, Center,** or **Right**. | | **Devices** | Selects which device-specific padding values you are editing. | **Desktop** or **Mobile**. | | **Bottom** | Controls the space below the header. | **0–100px**. |
The default **Header** includes **Subheading** and **Heading** blocks. To add more, click **Add block** inside the **Header** and select one of these blocks: * [**Heading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays the main title of the section. * [**Subheading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays a short line above or below the heading. * [**Text**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays additional descriptions or details. * [**Image**](https://docs.foxecom.com/pebble-theme/theme-blocks/image): Displays an image or icon. * [**Button**](https://docs.foxecom.com/pebble-theme/theme-blocks/button): Displays a call-to-action button. ### Media ![image](https://docs-assets.foxecom.app/pebble-theme/image_4vHwoP4Z.png) The **Media** block shows two overlapping images next to the timeline. When the timeline is long, the images stay in view while customers scroll. | Setting | Description | Options | | ----------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | **Image** | Sets the image. | Select or upload an image, or click **Explore free images**. | | **Aspect ratio** | Controls the image proportions. | **Auto, Square (1/1), Portrait (4/5), Portrait (3/4), Landscape (16/9), Landscape (4/3),** or **Landscape (21/9)**. | | **Width** | Sets the image width as a share of the block. | **50–100**%. | | **Corner radius** | Controls how rounded the image corners are. | **0–32px**. |
*These settings are the same for **Image #1** and **Image #2**.* To make **Image #2** overlap **Image #1**, set a smaller **Width** for **Image #2**, such as 70–80% for **Image #1** and 40–50% for **Image #2**. ![image](https://docs-assets.foxecom.app/pebble-theme/image_doBf1vg7.png) Use a portrait ratio such as 4:5 for **Image #1** and a square ratio for **Image #2** so the overlap looks balanced. #### Spinning icon badge The default **Media** block includes a [**Spinning icon badge**](https://docs.foxecom.com/pebble-theme/theme-blocks/spinning-icon-badge), which shows rotating text around an icon on top of the images. Its settings cover the icon, text, font, colors, and border. [*See the **Spinning icon badge documentation** for all available settings*](https://docs.foxecom.com/pebble-theme/theme-blocks/spinning-icon-badge). ### Timeline ![image](https://docs-assets.foxecom.app/pebble-theme/image_DUxVSLO0.png) Each **Timeline** block adds one step to the timeline, with a badge that labels the step. | Setting | Description | Options | | ---------------------------- | -------------------------------------------------- | ------------------------------------ | | **Content row gap** | Sets the space between the blocks inside the step. | **0–100px**. | | **Text** (Badge) | Sets the badge label. | Enter your text, such as **Week 1**. | | **Color** (Badge) | Sets the color of the badge text. | Pick a color or enter a hex code. | | **Background color** (Badge) | Sets the background color of the badge. | Pick a color or enter a hex code. |
The default **Timeline** includes **Heading** and **Text** blocks. To add more, click **Add block** inside the **Timeline** and select one of these blocks: * [**Heading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays the title of the step. * [**Subheading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays a short line above or below the heading. * [**Text**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays the details of the step. To remove a step, open its **Timeline** block and click **Remove block**. ### Button The [**Button**](https://docs.foxecom.com/pebble-theme/theme-blocks/button) block adds a call-to-action below the timeline. Set its text in **Label** and its destination in **Link**. ## Tips and best practices * Keep each step short, with one clear heading and a sentence or two of detail. * Avoid placing **Image #2** over important details in **Image #1**, such as faces or product labels.