> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/flow/flow-components/timeline.md).

# Timeline

The Avonni Timeline component transforms lists of events into interactive visual timelines for easier understanding of chronological data.

## Overview

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-8499689430ca5da9170e1067000f0a571b654473%2Fimage%20(36).avif?alt=media" alt="" width="375"><figcaption></figcaption></figure>

The Timeline displays a chronological list of activities and events in a visual, scrollable format. Use it to show task history, project milestones, account activity, or any time-ordered data directly in a flow screen.

***

## Tutorials

Step-by-step guides that follow one account's activity history. The [Timeline tutorials](https://docs.avonnicomponents.com/flow/tutorials/components/timeline.md) page groups them by goal.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Display Tasks</strong></td><td>Show an account's Tasks on an Avonni Timeline in a screen flow, grouped by month, so a service manager sees every call and follow-up before a meeting.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FNcgVrrxOmyb8nhVwj2pv%2Ftimeline-cover-display-tasks.png?alt=media">timeline-cover-display-tasks.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/timeline/display-tasks.md">Display Tasks</a></td></tr><tr><td><strong>Show a record history with a query</strong></td><td>Let the Avonni Timeline query an account's Cases itself, with no Get Records, so support sees the latest case activity as soon as the screen opens.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FFBQ4NhZHDdzoOKASo7Af%2Ftimeline-cover-show-a-record-history-with-a-query.png?alt=media">timeline-cover-show-a-record-history-with-a-query.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/timeline/show-a-record-history-with-a-query.md">Show a record history with a query</a></td></tr><tr><td><strong>Assigning multiple source collections to the Timeline</strong></td><td>Combine an account's Tasks, Events and Cases in one Avonni Timeline with the SObject Collection to Activity Timeline Items action, each with its own icon.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fc18lLQT3jKWFJUfJaFX2%2Ftimeline-cover-assigning-multiple-source-collection-to-the-timeline.png?alt=media">timeline-cover-assigning-multiple-source-collection-to-the-timeline.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/timeline/assigning-multiple-source-collection-to-the-timeline.md">Assigning multiple source collections to the Timeline</a></td></tr><tr><td><strong>Group a timeline by month</strong></td><td>Group a vertical Timeline by day, week, month or year, with sections that open on click and a separate group for upcoming activities.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2F08IPq4kz1x8uJHKvKIwJ%2Ftimeline-cover-group-a-timeline-by-month.png?alt=media">timeline-cover-group-a-timeline-by-month.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/timeline/group-a-timeline-by-month.md">Group a timeline by month</a></td></tr><tr><td><strong>Create a horizontal activity timeline</strong></td><td>Turn the Timeline sideways to see a customer's activities across a period at a glance, and choose how many days the visible window covers.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FHR2V1vckZMDsPjtjs1jJ%2Ftimeline-cover-create-a-horizontal-activity-timeline.png?alt=media">timeline-cover-create-a-horizontal-activity-timeline.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/timeline/create-a-horizontal-activity-timeline.md">Create a horizontal activity timeline</a></td></tr><tr><td><strong>Format dates on a Timeline</strong></td><td>Choose how each Timeline item shows its date, from "Yesterday 4:15 PM" to "2 days ago" or your own pattern, with the Format setting.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FmwmLQQwm85sPuzuUySZd%2Ftimeline-cover-customizing-date-format-in-the-timeline-component-using-luxon.png?alt=media">timeline-cover-customizing-date-format-in-the-timeline-component-using-luxon.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/timeline/customizing-date-format-in-the-timeline-component-using-luxon.md">Format dates on a Timeline</a></td></tr><tr><td><strong>Perform actions on selected tasks</strong></td><td>Let a user tick open tasks on a Timeline and close them all in one click, with the Selected Item Names output, Get Records and Update Records.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FhnUv65UrSuZhDZLIk9hr%2Ftimeline-cover-perform-actions-on-selected-tasks.png?alt=media">timeline-cover-perform-actions-on-selected-tasks.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/timeline/perform-actions-on-selected-tasks.md">Perform actions on selected tasks</a></td></tr><tr><td><strong>Act on a timeline item</strong></td><td>Let users log a call outcome, plan a follow-up or delete a task straight from a Timeline item, with item actions and click interactions.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FUrXXIkea9Y7Sc1xflBUd%2Ftimeline-cover-act-on-a-timeline-item.png?alt=media">timeline-cover-act-on-a-timeline-item.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/timeline/act-on-a-timeline-item.md">Act on a timeline item</a></td></tr><tr><td><strong>Search and filter a timeline</strong></td><td>Add a search bar and Status and Priority filters to a Timeline, so users find one activity among dozens, and set what an empty search shows.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FumuXVFnYTmHGtJmH8yYZ%2Ftimeline-cover-search-and-filter-a-timeline.png?alt=media">timeline-cover-search-and-filter-a-timeline.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/timeline/search-and-filter-a-timeline.md">Search and filter a timeline</a></td></tr></tbody></table>

***

## Configuration

To configure it, click the component on the Flow screen. The **Edit Avonni Activity Timeline Component** panel opens on the right with three tabs: Properties, Interactions, and Style. The sections below mirror the Properties tab.

### Data Source

The **Data Source** setting determines where timeline items come from. Pick it first. Everything else builds on this choice.

| Data Source                                                                                       | Best For                              | When to Use                                                |
| ------------------------------------------------------------------------------------------------- | ------------------------------------- | ---------------------------------------------------------- |
| [**Manual**](https://docs.avonnicomponents.com/flow/component-builder/data-sources/manual.md)     | Fixed, pre-defined events             | Static timelines with a predetermined set of activities    |
| [**Variable**](https://docs.avonnicomponents.com/flow/component-builder/data-sources/variable.md) | Items from a Flow collection variable | Dynamic timelines reflecting real-time Salesforce data     |
| [**Query**](https://docs.avonnicomponents.com/flow/component-builder/data-sources/query.md)       | Live Salesforce records               | Complex data retrieval without a separate Get Records step |

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-810e1c8b460f01908254cd20e62fafcf2ebc5f31%2F2023-11-27_22-24-16.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
When using the Query Data Source:

* **Initial Display:** By default, only 20 items will load at first. This helps keep the Timeline fast and responsive.
* **See All Data:** The "Show More" button lets users easily load the rest of the timeline items.
* **Customization (Optional):** You can adjust the number of initially displayed items by setting a value for **Max Visible Items** in the Pagination section.

<img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-0242488276e3d119076a102840d989ffef540c7b%2F2024-04-23_10-23-07.png?alt=media" alt="" data-size="original">
{% endhint %}

### Data Mapping

When using Variable or Query, you need to tell the Timeline which Salesforce fields map to which parts of each item, for example by mapping `ActivityDate` to the Start Date so the timeline can group and sort correctly.

{% hint style="info" %}
[Check out our article](https://docs.avonnicomponents.com/flow/tutorials/components/timeline/assigning-multiple-source-collection-to-the-timeline.md) on assigning various source collections from multiple objects to the Activity Timeline.

<img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-b74c3e67eaab4fa7578f3b43b26aef38a789589d%2Fspaces_1FUd4apB9YHgCEMUFbVb_uploads_A9TKt1RmVAThps4MQh34_2023-03-31_13-03-00.webp?alt=media" alt="" data-size="original">
{% endhint %}

### Properties

**Orientation** controls how the timeline is laid out.

<table><thead><tr><th width="178">Orientation</th><th width="267">Description</th><th>Image</th></tr></thead><tbody><tr><td><strong>Vertical</strong> <em>(default)</em></td><td>Activities displayed in a top-down chronological list.</td><td><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-d174bde2e2c7a6d23baa6a33517dbab02202119a%2F2023-06-30_09-19-00.png?alt=media" alt=""></td></tr><tr><td><strong>Horizontal</strong></td><td>Activities displayed in a left-to-right linear format.</td><td><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-39a9bf75cf361931c1cd4adc4231f53a34b14956%2F2023-06-30_09-18-11%20(1).png?alt=media" alt=""></td></tr></tbody></table>

**Sorted Direction** controls the order of items. Ascending shows earliest first; Descending shows latest first. Only applies to **Vertical** orientation.

**Group By** organizes items into collapsible sections by time period (Day, Week, Month, or Year). Only applies to **Vertical** orientation.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-9212ead23a91caec07fd860d7ea6ee481f318e1c%2FAvonni%20Components%204.4%20Mar%2012.webp?alt=media" alt=""><figcaption></figcaption></figure>

**Collapsible** makes each group section collapsible and shows the collapse control. Requires **Group By** to be set.

**Closed** sets all group sections to be closed by default when the timeline loads. Requires **Collapsible** to be on.

**Disable Upcoming Group** prevents future-dated items from being placed in a separate upcoming section. Requires **Group By** to be set.

**Date Intervals** specifies the number of days to display across the timeline. Only applies to **Horizontal** orientation.

**Hide Vertical Bar** hides the vertical connecting bar between timeline items. Only applies to **Vertical** orientation.

**Items Clickable** makes each timeline item clickable. Wire the click to an interaction to navigate, open a modal, or trigger flow logic.

**Highlight On Click** highlights the last clicked item. If an interaction that opens a panel is configured, the item is highlighted automatically regardless of this setting. Only applies to **Vertical** orientation.

**Item Icon Size** sets the size of the icon shown for each item. Options: XX-Small, X-Small, Small *(default)*, Medium, Large. Only applies to **Vertical** orientation.

### Header

The Header section controls the title and action buttons displayed above the timeline.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-50d700c117fc36c059b1c97e71a3a53e3d621aaa%2F2023-07-03_20-40-26.png?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="163">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Title</strong></td><td>A heading that introduces the timeline's content.</td></tr><tr><td><strong>Caption</strong></td><td>A brief description or supplementary context below the title.</td></tr><tr><td><strong>Avatar</strong></td><td>An avatar displayed before the title. Sub-settings: <strong>Fallback Icon Name</strong>, <strong>Image</strong>, <strong>Initials</strong>, <strong>Alternative Text</strong>, <strong>Size</strong> and <strong>Variant</strong> (Circle or Square).</td></tr><tr><td><strong>Is Joined</strong></td><td>Removes the bottom rounding and shadow from the header so it visually joins with the component directly below it.</td></tr><tr><td><strong>Actions</strong></td><td>The action buttons and menu items in the header, wired to the <strong>Header Action Click</strong> interaction.</td></tr><tr><td><strong>Visible Actions Buttons</strong></td><td>How many header actions show as buttons.</td></tr><tr><td><strong>Hide Actions</strong></td><td>Hides the header actions menu.</td></tr><tr><td><strong>Disable Actions</strong></td><td>Disables the header actions.</td></tr></tbody></table>

### Item Date Format

Controls how dates are displayed on each timeline item. Choose from Standard, Relative, Preset (a Luxon preset such as Date Medium), or Custom (a Luxon format string).

[See this tutorial to learn more about customizing date formats.](https://docs.avonnicomponents.com/flow/tutorials/components/timeline/customizing-date-format-in-the-timeline-component-using-luxon.md)

### Fields Layout

Controls how the additional fields are laid out inside a timeline item.

* **Number of Columns**: columns in the smallest container: 1, 2, 3, 4, 6, or 12 Cols.
* **Number of Columns Small Container**, **Number of Columns Medium Container**, **Number of Columns Large Container**: the same choice from 480px, 768px and 1024px wide.
* **Variant**: how each field's label is displayed: **Standard**, **Label Hidden**, **Label Inline**, or **Label Stacked**.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-7837dfd9b1064a5864a57fbceb0887ce9306ad19%2F2023-11-27_22-15-31.png?alt=media" alt="" width="375"><figcaption><p>Fields display in the Timeline</p></figcaption></figure>

### Filter

Add fields from your data source as filters, enabling users to narrow down the timeline view based on specific criteria. The group holds four settings:

* **Display As Popover** shows the filters in a popover instead of inline.
* **Picklist Filter Sort Order** orders a picklist filter's options **Ascending**, **Descending**, or by the **Default Order of Field**.
* **Use Record Picklist Values** derives those options from the values present in the records instead of the field's full defined value set.
* **Use Cascading Filter Values** narrows the options offered in the other filters to the records matching the current selection. When it is on, **Use Record Picklist Values** is ignored.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-9a3829367b12e66acc1b59fca9f2784664e90cb5%2F2023-07-03_21-57-17.png?alt=media" alt=""><figcaption><p>How to add filters on your Timeline</p></figcaption></figure>

### Search

Enable **Show Search** to add a search bar above the timeline. Use **Search Engine Attributes** to set its **Placeholder** and **Position** (Left, Right, Center, or Fill). Which fields the search looks through is set with **Search Fields** in **Data Mappings**; left empty, it searches the fields used by the Title and Description mappings.

### Pagination

Applies to **Vertical** orientation only.

| Setting                   | Description                                                                                                                       |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Max Visible Items**     | If pagination is enabled, the number of items per page. Otherwise, the number of items shown before a "Show More" button appears. |
| **Show Pagination**       | Displays or hides pagination controls below the timeline.                                                                         |
| **Pagination Attributes** | Customize pagination control labels and icons.                                                                                    |

{% hint style="info" %}
**Items loading.** With **Pagination** off, the Timeline shows **Max Visible Items** before a **Show More** button appears, or, if you set a fixed **Height** (Size style), it switches to **infinite scroll** (loading the next batch as you reach the bottom). With **Pagination** on, it pages by **Max Visible Items** with pagination controls.
{% endhint %}

### Item Actions

Per-item actions, listed in a menu at the top right of each timeline item. In **Horizontal** orientation, the menu sits in the item's popover, next to the close button.

{% embed url="<https://demo.arcade.software/OugGPqkH0tUMZAkODVEa>" %}

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-0686a61e44c1e9a3793f5c02534f68591a0f89ac%2F2022-10-05_11-09-18.png?alt=media" alt=""><figcaption><p>End-user view of where the item actions are located.</p></figcaption></figure>

### No Results Message

A collapsible section of the Properties tab.

* **No Results Message** replaces the default text shown when no items match the current search or filter.
* **Hide No Results Image** and **Hide No Results Message** suppress the empty-state image and the text.

## Interactions

[Interactions](https://docs.avonnicomponents.com/flow/component-builder/interactions-panel.md) define what happens when users interact with the Activity Timeline. Configure them from the **Interactions** tab of the Edit Avonni Activity Timeline Component panel.

### Item Action Click

Fires when a user clicks a per-item action button (vertical orientation only). Use **Target Name** to identify which action was clicked. The clicked item's record is available via **Clicked Item Action Item**, its name via **Clicked Item Action Item Name**, and the action name via **Clicked Item Action Name**.

### Header Action Click

Fires when a user clicks a header action button. Use **Target Name** to identify which header action was clicked. The name of the clicked header action is also available via the **Clicked Header Action Name** output variable.

### Item Click

Fires when a user clicks a timeline item. Requires **Items Clickable** to be enabled or an Item Click interaction to be configured. The clicked item's record is available via **Clicked Item** and its name via **Clicked Item Name**.

## Styling

The **Style** tab gives you fine-grained control over the Timeline's appearance. Configure it from the **Style** tab of the Edit Avonni Activity Timeline Component panel.

{% tabs %}
{% tab title="Margin" %}
Controls the *outer* spacing around the timeline, creating space between it and other elements on the screen.

* **Top / Right / Bottom / Left:** Adjust the space on each side of the timeline.
  {% endtab %}

{% tab title="Padding" %}
Controls the *inner* spacing between the timeline's content and its border.

* **Top / Right / Bottom / Left:** Adjust the inner spacing on each side.
  {% endtab %}

{% tab title="Size" %}
Controls the timeline's dimensions.

* **Width / Height:** Set fixed dimensions for the timeline.
* **Min Width / Max Width / Min Height / Max Height:** Constrain the size within bounds.
* **Overflow:** Control how content that exceeds the bounds is handled.
  {% endtab %}

{% tab title="Border" %}
Customizes the border surrounding the timeline.

* **Color:** Set the border color.
* **Size:** Adjust the border thickness.
* **Style:** Choose a border style (e.g. solid, dashed, dotted).
* **Radius:** Control the roundness of the corners.
  {% endtab %}

{% tab title="Header" %}
Styles the timeline's header bar.

* **Background Color:** Set the header background.
* **Padding Top / Right / Bottom / Left:** Adjust the header's inner spacing.
* **Margin Bottom:** Set the space below the header.
  {% endtab %}

{% tab title="Header Border" %}
Customizes the header's border.

* **Color / Size / Style:** Set the border color, thickness, and style.
* **Radius:** Control the roundness of the corners.
* **Bottom Border Color / Size / Style (Is Joined):** Customize the bottom border when the header is joined.
  {% endtab %}

{% tab title="Header Title" %}
Styles the header title text.

* **Color:** Set the title color.
* **Font Size / Font Style / Font Weight:** Control the title typography.
  {% endtab %}

{% tab title="Header Caption" %}
Styles the header caption text.

* **Color:** Set the caption color.
* **Font Size / Font Style / Font Weight:** Control the caption typography.
  {% endtab %}

{% tab title="Header Actions" %}
Styles the action buttons in the header.

* **Text Color / Active / Hover:** Set the action text color in each state.
* **Background Color / Active / Hover:** Set the action background in each state.
* **Border Color / Active / Hover:** Set the action border in each state.
  {% endtab %}

{% tab title="Header Avatar" %}
Styles the avatar shown in the header.

* **Background Color / Foreground Color:** Set the avatar colors.
* **Border Radius:** Control the roundness of the avatar corners.
  {% endtab %}

{% tab title="Flow Dialog" %}
Adjusts the timeline's display when it is opened as a modal dialog inside a Flow screen.

* **Width:** Dialog width.
* **Height:** Dialog height.
* **Background Color:** Dialog background color.
  {% endtab %}

{% tab title="Flow Panel" %}
Adjusts the timeline's display when it is opened as a side panel inside a Flow screen.

* **Width:** Panel width.
* **Background Color:** Panel background color.
  {% endtab %}

{% tab title="Item" %}
Styles each timeline item.

* **Line Color:** Set the connecting line color.
* **Line Clamp:** Limit the item description to a maximum number of lines.
* **Icon Background Color:** Set the item icon background.
  {% endtab %}

{% tab title="Item Body" %}
Styles the body of each timeline item.

* **Background Color Hover:** Set the body background on hover.
* **Background Color Highlight:** Set the body background when highlighted.
  {% endtab %}

{% tab title="Item Fields" %}
Styles the fields displayed within an item.

* **Spacing Inline / Block:** Adjust the spacing between fields.
* **Background Color:** Set the fields' background.
* **Border Color / Size / Style / Radius:** Customize the border around the fields.
  {% endtab %}

{% tab title="Pagination Buttons" %}
Styles the pagination controls.

* **Background Color / Active / Hover / Disabled:** Set the button background in each state.
* **Text/Icon Color / Active / Hover / Disabled:** Set the button text and icon color in each state.
* **Color Border / Active / Hover / Disabled:** Set the button border in each state.
* **Border Size / Style:** Adjust the border thickness and style.
* **Active Button Background / Text/Icon / Border (with Active and Hover states):** Style the currently selected page button.
  {% endtab %}

{% tab title="Footer" %}
Styles the timeline footer.

* **Background Color:** Set the footer background.
* **Border Color / Size / Style / Radius:** Customize the footer border.
  {% endtab %}

{% tab title="Show More Button" %}
Styles the "Show More" button.

* **Block Start / Block End / Inline Start / Inline End:** Adjust the button's spacing.
* **Background Color / Active / Hover:** Set the button background in each state.
* **Text Color / Active / Hover:** Set the button text color in each state.
* **Border Color / Active / Hover / Size / Radius:** Customize the button border.
  {% endtab %}
  {% endtabs %}

***

## Output Variables

The Timeline exposes these output variables you can reference in your flow after the screen. To use them, select the screen element in Flow Builder, then the Timeline component, and pick the output variable you need.

### Item Click

When a user clicks a timeline item (requires **Items Clickable** to be enabled or an Item Click interaction to be configured).

| Output variable       | Type             | What it returns                                            |
| --------------------- | ---------------- | ---------------------------------------------------------- |
| **Clicked Item**      | Record (SObject) | The full record behind the timeline item the user clicked. |
| **Clicked Item Name** | Text (String)    | The name (key) of the clicked timeline item.               |

> **Example:** After the user clicks a task entry, use **Clicked Item** to pre-populate a detail screen with that task's fields.

### Item Action Click

When a user clicks a per-item action button (vertical orientation only).

| Output variable                   | Type             | What it returns                                             |
| --------------------------------- | ---------------- | ----------------------------------------------------------- |
| **Clicked Item Action Item**      | Record (SObject) | The record behind the item whose action button was clicked. |
| **Clicked Item Action Item Name** | Text (String)    | The name (key) of that item.                                |
| **Clicked Item Action Name**      | Text (String)    | The name of the action button that was clicked.             |

> **Example:** Use **Clicked Item Action Name** to branch logic: navigate to an edit screen when the action is "Edit", or open a confirmation dialog when it is "Delete".

### Item Selection

| Output variable         | Type                  | What it returns                                    |
| ----------------------- | --------------------- | -------------------------------------------------- |
| **Selected Items**      | Collection of Records | All timeline items currently selected by the user. |
| **Selected Item Names** | Text Collection       | The names (keys) of all currently selected items.  |

### Header Actions

| Output variable                | Type          | What it returns                                        |
| ------------------------------ | ------------- | ------------------------------------------------------ |
| **Clicked Header Action Name** | Text (String) | The name of the header action button the user clicked. |

### Others

| Output variable     | Type    | What it returns                                                |
| ------------------- | ------- | -------------------------------------------------------------- |
| **Number of Items** | Integer | The total number of items currently displayed in the timeline. |

### Flow Interaction Output Variables

Like all interactive Flow components, the Timeline exposes generic output slots (Variable 1 to 10) that an [Open Flow Dialog](https://docs.avonnicomponents.com/flow/component-builder/interactions-panel/open-flow-dialog.md) or [Open Flow Panel](https://docs.avonnicomponents.com/flow/component-builder/interactions-panel/open-flow-panel.md) interaction can fill with values from a launched flow. See [Flow Interaction Output Variables](https://docs.avonnicomponents.com/flow/component-builder/interactions-panel/flow-interaction-output-variables.md).

## Troubleshooting Common Issues

* **Timeline shows nothing at runtime but items appear in the Component Builder preview**: The flow variable feeding the Items input is empty when the screen loads, because the Get Records element hasn't run yet, or the variable was reset earlier in the flow. Place the Get Records element before the screen, and confirm the collection variable is populated by adding a temporary Display Text before the timeline screen.
* **Items appear but are not sorted, or grouped under the wrong group**: The Start Date field is not mapped in Data Mappings, or it points to a field that's empty on most records. In Data Mappings, map Start Date to a Date or DateTime field that's populated on every record (e.g., `{{Record.ActivityDate}}` for Tasks, `{{Record.StartDateTime}}` for Events).
* **All items are grouped under "Past" or "Upcoming" no matter the date**: The Start Date field is mapped to a String or Number field, not a Date or DateTime. Pick a Date or DateTime field for Start Date, or use the Advanced expression mode to format a string into ISO 8601 (`2026-04-27T15:30:00.000Z`).
* **Date Intervals setting has no effect**: Date Intervals only applies to the horizontal orientation; it's ignored when the timeline is set to vertical. In the Properties tab, set Orientation to Horizontal.
* **Hide Vertical Bar setting has no effect**: Hide Vertical Bar only applies to the vertical orientation; it's ignored on horizontal timelines. In the Properties tab, set Orientation to Vertical.
* **Clicking an item does nothing**: Neither Items Clickable is on, nor an Item Click interaction is configured. Either toggle Items Clickable on, or wire an Item Click interaction in the Interactions tab.
* **Filters in the panel have no effect with a Manual data source**: Filters and Search Fields only apply to the Variable and Query Data Sources, not Manual. Switch the Data Source to Variable or Query.
* **Search returns no results even though the value appears in an item**: Searchable fields are not configured. In Variable or Query mode (Search Fields do not apply to Manual), the component only searches the fields used in the Title and Description mappings. Add the missing field API names to Search Fields in Data Mappings.
* **"Upcoming" group is always empty even though future-dated items exist**: The Start Date field is in the past at the time the timeline loads; the Upcoming group is computed against the current date and time on the user's machine. If you don't need a separate Upcoming group, toggle Disable Upcoming Group on. Otherwise, ensure your Start Date field includes a future timestamp.
* **Item actions seem missing on a horizontal timeline**: in horizontal mode the item menu sits in each item's popover. Hover the item, then open the menu next to the close button.

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/flow/flow-components/timeline.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
