> 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/tutorials/components/timeline.md).

# Timeline

Step-by-step Timeline tutorials for screen flows: show a customer's activity history, group and format it, act on items, search and filter.

The Avonni Timeline shows activities in date order on a flow screen: calls, meetings, cases, anything with a date. These tutorials follow a service manager preparing a call with Harbor Point Logistics, from showing the account's history to closing the tasks that are done.

{% hint style="info" %}
New to the component? Start with [Display Tasks](https://docs.avonnicomponents.com/flow/tutorials/components/timeline/display-tasks.md), then keep the [Timeline reference](https://docs.avonnicomponents.com/flow/flow-components/timeline.md) open for every property.
{% endhint %}

## Display activities

Bring a customer's history onto a flow screen, from one object or several.

<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></tbody></table>

## Shape the timeline

Choose how activities are grouped, laid out and dated.

<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>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></tbody></table>

## Act on activities

Let users close, log or edit activities without leaving the screen.

<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>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></tbody></table>

## Find activities

Help users reach one activity among dozens.

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

To turn several collections into timeline items yourself, see the [SObject Collection to Activity Timeline Items](https://docs.avonnicomponents.com/flow/actions/data-manipulation-and-transformation/sobject-collection-to-activity-timeline-items.md) action.


---

# 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/tutorials/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.
