# Timeline

> Create a timeline for visualizing chronological events, milestones, history, evolution, or sequential stages.

Source: https://mockflow.com/developers/reference/item-types/timeline

Send `"type": "timeline"`.

Create a timeline for visualizing chronological events, milestones, history, evolution, or sequential stages. Use this for simple chronological visualization of events or milestones WITHOUT task management. For project plans with tasks, durations, progress, and assignees, use render_gantt instead.

Also available as the MCP tool `render_timeline`. The same payload works through either surface.

### Fields

- `events` (object[], required): Array of timeline events
    - `id` (string, required): Unique event ID (e.g., "evt_1")
  - `title` (string, required): Event title
  - `description` (string, required): Detailed event description
  - `date` (string, required): ISO date string (real date for date mode, placeholder for label mode)
  - `labelValue` (string, required): Empty string for date mode, meaningful label for label mode (e.g., "Stage 1", "3300 BCE")
  - `coverType` (string): null, or "image" when this render includes images
  - `coverFileID` (string): null, or when this render includes images: "mfimg::" followed by a description of this event's picture (no text, letters or numbers in it)
- `settings` (object, required): Timeline settings
    - `boardTitle` (string): Title of the timeline
  - `theme` (string): Defaults to `transparent`.
  - `layout` (enum<string>): One of `horizontal` or `vertical`. Defaults to `horizontal`.
  - `labelType` (enum<string>): "date" for chronological events with real dates, "label" for stages/phases/abstract sequences. One of `date` or `label`.

## Example

```json
{
  "type": "timeline",
  "data": {
    "events": [
      {
        "id": "string",
        "title": "Q4 Launch Planning",
        "description": "string",
        "date": "string",
        "labelValue": "string",
        "coverType": "string",
        "coverFileID": "string"
      }
    ],
    "settings": {
      "boardTitle": "Q4 Launch Planning",
      "theme": "transparent",
      "layout": "horizontal",
      "labelType": "date"
    }
  }
}
```