> 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/experience-cloud/experience-components/ax-timeline.md).

# AX - Timeline

## Overview

**AX - Timeline** is an Experience Cloud component that displays Salesforce records in chronological order on Experience Sites pages.

Use it to show portal users date-based activity, like their case history, order timeline, project milestones, or any date-stamped records. Users can search and filter entries, open a record from an item (with an **On Click** interaction on the items), and see events organized by time periods. Pull data from any standard or custom object with date fields.

Perfect for activity feeds, case histories, order tracking timelines, project status updates, or anywhere portal users need to see "what happened when" in a scrollable, chronological format.

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FfhHIof5HQHt9iGpbKEHS%2Fax-timeline-vertical.png?alt=media" alt=""><figcaption><p>A vertical timeline grouped by month, newest first. The two most recent items are open on their Fields, shown in two columns.</p></figcaption></figure>

{% hint style="success" %}
The Avonni Timeline is [Reactive-Ready](https://docs.avonnicomponents.com/experience-cloud/getting-started/reactive-components.md)
{% endhint %}

## Tutorials

Follow these step-by-step guides to build with this component.

<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><a href="https://docs.avonnicomponents.com/projects/use-cases/portals-and-partner-sites/track-my-installation.md">Build a Salesforce Experience Cloud Installation Tracker</a></td><td>Build an installation timeline with Avonni AX - Timeline in Salesforce Experience Cloud. Start with sample milestones, then connect records for signed-in customers.</td><td><a href="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FgqkDEWO2Bv7cDxvSkQm5%2Ftutorial-track-my-installation.png?alt=media">tutorial-track-my-installation.png</a></td><td><a href="https://docs.avonnicomponents.com/projects/use-cases/portals-and-partner-sites/track-my-installation.md">Build a Salesforce Experience Cloud Installation Tracker</a></td></tr></tbody></table>

## Projects

See how Timeline fits into a complete Salesforce workflow. The project includes steps to build it with AI or manually.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><h4><a href="https://docs.avonnicomponents.com/projects/use-cases/portals-and-partner-sites/customer-order-tracking">Customer Order Tracking</a></h4></td><td>Select a customer order to see its delivery milestones. Requires an authenticated Experience site, two test accounts and order sharing by account.</td><td data-object-fit="contain" data-alt="Customer Order Tracking in Experience Cloud with two orders in Avonni List and three delivery milestones for ORD-1041 in Avonni Timeline."><a href="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FaEgKMeIovCIPaQie66U1%2Fcustomer-order-tracking-cover.jpg?alt=media">customer-order-tracking-cover.jpg</a></td></tr></tbody></table>

## Configuration

### Items

The **Items** property holds the timeline's entries. Choose where they come from:

| Name       | Description                                                                 |
| ---------- | --------------------------------------------------------------------------- |
| **Manual** | Manually input timeline items and their details.                            |
| **Query**  | Use a query to automatically populate the timeline with Salesforce records. |

Each item is built from the same settings. In **Manual** mode you fill them in per item; in **Query** mode you map each one to a field of the queried object.

| Setting                  | What it does                                                                                                      |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| **Title**                | The item's heading.                                                                                               |
| **Description**          | The text under the title.                                                                                         |
| **Avatar**               | The item's icon: **Initials**, **Icon Name**, **Image**, and a **Presence Type**.                                 |
| **Date**                 | Required. Places the item on the timeline. In Query mode it also sorts the query, in the **Sorted Direction**.    |
| **Is Active**            | Marks the item as the current one.                                                                                |
| **Has Checkbox**         | Adds a checkbox to the item.                                                                                      |
| **Fields**               | Label and value pairs, shown when the user opens the item. **Field Attributes** sets their layout.                |
| **Name** / **Key Field** | The item's unique identifier (Manual: **Name**; Query: **Key Field**, `{{Record.Id}}` by default).                |
| **Filters**              | Query mode only. The fields users can filter on, see **Filter Menu Attributes**.                                  |
| **Search Fields**        | Query mode only. The fields the search box searches across. Requires **Searchable**.                              |
| **On Click**             | What happens when a user clicks the item, such as navigating to the record. Without it, an item is not clickable. |

### Basic Configuration

**Title** is the main heading for the timeline, and **Caption** is a brief description or supplementary text beneath it. **Title Text Style** and **Caption Text Style** set the typography of each: `Heading 1` to `Heading 4`, or `Paragraph 1` / `Paragraph 2`.

### Visual and Functional Elements

| Setting                | What it does                                                                                                                                                                                                                          |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **API Name**           | A unique identifier used to reference the component.                                                                                                                                                                                  |
| **Icon Name**          | An icon from the Salesforce Lightning Design System shown next to the timeline's title. Each item's own icon is set on the item, under **Avatar**.                                                                                    |
| **Icon Size**          | The size of that header icon: `Xxs`, `Xs`, `Small`, `Medium` (default) or `Large`.                                                                                                                                                    |
| **Item Icon Size**     | The size of the per-item icons: `Xxs`, `Xs`, `Small` (default), `Medium` or `Large`.                                                                                                                                                  |
| **Orientation**        | `Vertical` (default) or `Horizontal` layout.                                                                                                                                                                                          |
| **Sorted Direction**   | `Ascending` or `Descending` (default) chronological order.                                                                                                                                                                            |
| **Group By**           | Groups the items by `Day`, `Week`, `Month`, or `Year`. Leave it unset to list the items ungrouped. Items dated after today are gathered under **Upcoming**.                                                                           |
| **Item Date Format**   | How dates display on the items: **Standard**, **Relative** (for example "2 days ago"), **Preset** (a Luxon preset, `DATE_MED` by default) or **Custom** (the default, `LLLL dd, yyyy, t`, which reads "September 02, 2026, 1:00 PM"). |
| **Is Joined**          | Attaches the header to the timeline body, with no gap between them. Its bottom border is styled under **Header Border**. Off by default.                                                                                              |
| **Collapsible**        | Lets users fold each group. Requires **Group By**. Off by default.                                                                                                                                                                    |
| **Closed**             | Starts those groups folded. Requires **Collapsible**. Off by default.                                                                                                                                                                 |
| **Searchable**         | Adds a search box. In Manual mode it searches the items' title and description; in Query mode it searches the fields listed under **Search Fields** in the Items mapping. Off by default.                                             |
| **Show Pagination**    | Splits the items into pages, with **Max Visible Items** as the page size (20 if empty).                                                                                                                                               |
| **Max Visible Items**  | With **Show Pagination** on, the page size. With it off, the vertical timeline shows that many items, then a **Show More** button.                                                                                                    |
| **Highlight On Click** | Visually highlights an item when it is clicked.                                                                                                                                                                                       |

{% hint style="info" %}
Grouping, collapsible groups, item actions, item icon size, click highlight and the **Show More** button apply to the vertical orientation only.
{% endhint %}

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FZjX4OXJi4jlVjQQnie8o%2Fax-timeline-horizontal.png?alt=media" alt=""><figcaption><p>The same items with Orientation set to Horizontal. The top band shows a 15-day window; the strip below spans every item, and users drag the highlighted window along it.</p></figcaption></figure>

### Interactivity and Customization

**Header Actions** add action buttons in the timeline header. Each action has a **Label**, a **Name**, an **Icon Name**, a **Title**, **Alternative Text** and an **On Click** interaction. **Visible Actions Buttons** sets how many header actions show as buttons before the rest move into a menu.

**Item Actions** add action buttons at the item level (vertical orientation only).

**Field Attributes** set the layout of each item's **Fields**:

* **Number of Columns**: 1 by default. It applies to containers narrower than 480px, and whenever no size-specific value is set.
* **Small**, **Medium** and **Large Container Columns**: the number of columns for each container size.
* **Variant**: `Standard` (default), `Label Hidden`, `Label Inline` or `Label Stacked`.

**Filter Menu Attributes** set how the filters are presented. Filters exist in Query mode only: pick the **Filters** fields in the Items mapping first. **Type** places them `Horizontal` (default), in a `Popover`, or in a `Panel`, and **Picklist Filter Sort Order**, **Use Record Picklist Values** and **Use Cascading Filter Values** control how picklist options are listed.

Every filter also carries an operator, picked from a menu at the top of the filter. Text, picklist, multi-select picklist and lookup filters offer `Equals` (the default), `Not Equals`, `Empty` and `Not Empty`. Number, date and time filters offer `Between` (the default), `Not Between`, `Equals`, `Not Equals`, `Less Than`, `Less or Equal`, `Greater Than`, `Greater or Equal`, `Empty` and `Not Empty`. `Empty` and `Not Empty` take no value, so the filter's inputs are hidden while either is selected. Checkbox filters have no operator menu.

**Search Engine Attributes** customize the search box: its **Placeholder** (`Search` by default) and its **Position**, `Left` (default), `Right`, `Center` or `Fill`.

**Pagination Attributes** set the labels and icons of the **First**, **Previous**, **Next** and **Last** buttons, and their alignment: `Left` (default), `Center` or `Right`.

**No Results Message** replaces the default empty state with your own text when no item matches the search or the filters — or when the data source returns nothing at all. **No Results Message Attributes** controls what that empty state shows: **Hide No Results Image** drops the illustration and **Hide No Results Message** drops the text. Both are off by default.

## Styling

Customize the timeline's appearance from the **Style** section of the property editor.

{% tabs %}
{% tab title="Margin" %}
Controls the outer spacing around the timeline.
{% endtab %}

{% tab title="Padding" %}
Controls the inner spacing of the timeline.
{% endtab %}

{% tab title="Size" %}
Controls the timeline's dimensions (Width / Height / Overflow).
{% endtab %}

{% tab title="Border" %}
Controls the border around the timeline (Color / Size / Style / Radius).
{% endtab %}

{% tab title="Header" %}

| Name                                   | Description                                  |
| -------------------------------------- | -------------------------------------------- |
| **Background Color**                   | Sets the color of the header's background.   |
| **Padding (Top, Right, Bottom, Left)** | Sets the internal spacing within the header. |
| **Margin Bottom**                      | Determines the space below the header.       |
| {% endtab %}                           |                                              |

{% tab title="Header Border" %}

| Name                                | Description                                                             |
| ----------------------------------- | ----------------------------------------------------------------------- |
| **Border Color**                    | Determines the color of the header's border.                            |
| **Border Size**                     | Adjusts the thickness of the border around the header.                  |
| **Border Style**                    | Selects the style of the border (e.g., solid, dashed, dotted).          |
| **Border Radius**                   | Rounds the corners of the header for a softer look.                     |
| **Bottom Border Color (Is Joined)** | When **Is Joined** is on, sets the color of the header's bottom border. |
| **Bottom Border Size (Is Joined)**  | Adjusts the thickness of that bottom border when **Is Joined** is on.   |
| **Bottom Border Style (Is Joined)** | Chooses the style of that bottom border when **Is Joined** is on.       |
| {% endtab %}                        |                                                                         |

{% tab title="Header Title" %}

| Name            | Description                                               |
| --------------- | --------------------------------------------------------- |
| **Color**       | Changes the color of the title text.                      |
| **Font Size**   | Adjusts the size of the title text.                       |
| **Font Weight** | Alters the boldness or thickness of the title text.       |
| **Font Style**  | Applies styling (e.g., italic, normal) to the title text. |
| {% endtab %}    |                                                           |

{% tab title="Header Caption" %}

| Name            | Description                                           |
| --------------- | ----------------------------------------------------- |
| **Color**       | Sets the color of the caption text.                   |
| **Font Size**   | Adjusts the size of the caption text.                 |
| **Font Weight** | Alters the boldness or thickness of the caption text. |
| **Font Style**  | Applies styling to the caption text                   |
| {% endtab %}    |                                                       |

{% tab title="Header Avatar" %}

| Name                 | Description                                                    |
| -------------------- | -------------------------------------------------------------- |
| **Background Color** | Sets the background color of the header avatar.                |
| **Foreground Color** | Sets the color of the avatar's content (its icon or initials). |
| **Border Radius**    | Rounds the corners of the avatar for a softer appearance.      |
| {% endtab %}         |                                                                |

{% tab title="Item" %}

| Name                      | Description                                                              |
| ------------------------- | ------------------------------------------------------------------------ |
| **Line Clamp**            | Limits an item's description to a set number of lines before truncating. |
| **Icon Background Color** | Sets the background color of the per-item icon.                          |
| {% endtab %}              |                                                                          |

{% tab title="Item Body" %}

| Name                           | Description                                                        |
| ------------------------------ | ------------------------------------------------------------------ |
| **Background Color Hover**     | Background color of an item while the pointer is over it.          |
| **Background Color Highlight** | Background color of an item highlighted by **Highlight On Click**. |
| {% endtab %}                   |                                                                    |

{% tab title="Item Fields" %}

| Name                 | Description                                           |
| -------------------- | ----------------------------------------------------- |
| **Spacing Inline**   | Horizontal spacing between the fields inside an item. |
| **Spacing Block**    | Vertical spacing between the fields inside an item.   |
| **Background Color** | Sets the background color of the item's field area.   |
| **Border Color**     | Determines the color of the field area's border.      |
| **Border Size**      | Adjusts the thickness of that border.                 |
| **Border Style**     | Selects the style of that border.                     |
| **Border Radius**    | Rounds the corners of the field area.                 |
| {% endtab %}         |                                                       |

{% tab title="Pagination Buttons" %}

| Name                    | Description                                                                                                 |
| ----------------------- | ----------------------------------------------------------------------------------------------------------- |
| **Background Color**    | Changes the background color of the buttons, with separate Active, Hover and Disabled values.               |
| **Text/Icon Color**     | Adjusts the color of the text or icons within the buttons, with separate Active, Hover and Disabled values. |
| **Color Border**        | Sets the border color of the buttons, with separate Active, Hover and Disabled values.                      |
| **Border Size / Style** | Sets the border properties of the pagination buttons.                                                       |
| **Active Button …**     | The same background, text/icon and border colors applied to the button of the page currently shown.         |
| {% endtab %}            |                                                                                                             |

{% tab title="Footer" %}

| Name                 | Description                                   |
| -------------------- | --------------------------------------------- |
| **Background Color** | Sets the color of the footer's background.    |
| **Border Color**     | Determines the color of the footer's border.  |
| **Border Size**      | Adjusts the thickness of the footer's border. |
| **Border Style**     | Selects the style of the footer's border.     |
| **Border Radius**    | Rounds the corners of the footer.             |
| {% endtab %}         |                                               |

{% tab title="Show More Button" %}

| Name                            | Description                                                            |
| ------------------------------- | ---------------------------------------------------------------------- |
| **Block Start / Block End**     | Vertical spacing above and below the button.                           |
| **Inline Start / Inline End**   | Horizontal spacing before and after the button.                        |
| **Background Color**            | Background color of the button, with separate Active and Hover values. |
| **Text Color**                  | Text color of the button, with separate Active and Hover values.       |
| **Border Color**                | Border color of the button, with separate Active and Hover values.     |
| **Border Size / Border Radius** | Thickness and corner rounding of the button's border.                  |
| {% endtab %}                    |                                                                        |

{% tab title="Flow Dialog & Panel" %}
Styles the dialog or side panel opened by an **Open Flow Dialog** or **Open Flow Panel** interaction.

| Name                   | Description                                                                                      |
| ---------------------- | ------------------------------------------------------------------------------------------------ |
| **Flow Dialog Header** | Background, bottom border (color and size) and label typography (color, font size, font weight). |
| **Flow Dialog Footer** | Background and top border (color and size).                                                      |
| **Flow Panel**         | Background color and border (color, size, style, radius) of the panel itself.                    |
| **Flow Panel Header**  | Background, bottom border, label typography and close-icon colors.                               |
| {% endtab %}           |                                                                                                  |
| {% endtabs %}          |                                                                                                  |


---

# 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/experience-cloud/experience-components/ax-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.
