# Progress timeline
_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. |

### 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

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

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**.

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

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.