---
title: Timeline Step
description: Timeline Step is one step of a vertical timeline for trials, order tracking and onboarding, Done, Current or Upcoming. Appetite UI Figma component.
group: Components
source: https://www.appetiteui.com/docs/timeline-step
dateModified: 2026-11-18
---

# Timeline Step

Updated: November 18, 2026.

Timeline Step is one step of a vertical timeline. Stack steps with no gap and the connector reads as one line.

## Preview

Three states in two sizes. Position=Last drops the connector at the end of the timeline.

![Timeline Step in three columns, Done, Current and Upcoming, each with a round node, Step title and Detail. Done has a blue node with a white check and a blue connector below, Current a blue node with a soft blue halo and a grey connector, Upcoming a grey node with a grey check. Rows show the medium and the small size, with and without the connector.](https://www.appetiteui.com/images/docs/timeline-step-board.webp)

Source: Timeline Step on the Progress Steps page of the Appetite UI Figma file, read on November 18, 2026.

## When do you use Timeline Step instead of Progress Steps?

Timeline Step for a vertical story with a title and a detail at each step: a trial, an order, an onboarding. Progress Steps for a short sequence with a known count, as a row of numbers.

Stack steps with a 0 gap so the connectors join into one line, and set the final step to Position=Last. The Paywall Trial screen tells the trial as three steps: Today, Day 5 and Day 7.

![Paywall Trial screen: How your free trial works as a three step timeline for Today, Day 5 and Day 7, a Pro yearly summary with the first payment date, a Start free trial button and a See all plans link](https://www.appetiteui.com/images/au_paywall_trial_light.webp)

Paywall, Trial

For a row of numbered steps, see [Progress Steps](https://www.appetiteui.com/docs/progress-steps).

## Properties

Three variant axes, two texts and the icon in the node.

| Property | Type | Default |
| --- | --- | --- |
| `State` | Done \| Current \| Upcoming | Done |
| `Size` | md \| sm | md |
| `Position` | Default \| Last | Default |
| `Title` | Text | Step title |
| `Detail` | Text | Detail |
| `Show Detail` | Boolean | true |
| `Icon` | Instance swap | check |

| Set | Variants | Size |
| --- | --- | --- |
| `Timeline Step` | 12, State crossed with Size and Position | md 345 x 80, Last 345 x 56; sm 345 x 58, Last 345 x 42 |

## Dimensions

The node and its icon by size.

| Size | Node | Icon |
| --- | --- | --- |
| `md` | 40 | 20 |
| `sm` | 24 | 16 |

## Is there a native timeline on iOS or Android?

No. Neither platform ships a vertical timeline, so Timeline Step is a custom view.

| Platform | Counterpart | What to build |
| --- | --- | --- |
| iOS | None. | A stack of rows, each with a node and a connector drawn to the next row. |
| Android | None in Material 3. | A column of rows, each with a node and a connector drawn to the next row. |

Say the state in text as well, for example Done or Next, because the node color alone does not reach VoiceOver or TalkBack. The kit has no prototype interaction on Timeline Step.
