Timeline
The timeline displays each user’s upcoming, current, and past activities.
The Timeline is also available as an Experience Cloud Component.
📘 Overview
The Timeline is a graphical representation of events, activities, or other items chronologically (it can be used with multi-objects). It can be used to track the progress or history of a particular process or project and provide an overview of events or activities that have occurred over a specific period.
The Timeline Component consists of a horizontal or vertical timeline, with each event or activity represented by a marker. The timeline can be divided into different periods, such as days, weeks, or months.
This page walks you through:
🎓 Tutorials
Name | Description | Illustration |
---|---|---|
The Timeline component showcases activities from multiple sources, organized according to a timeline view. | ||
Building an timeline that shows a list of tasks using the horizontal orientation. | ||
Enhance timelines with Avonni's flexible, user-centric date formatting via Luxon. | ||
Building an timeline that shows a list of tasks based on a GetRecords collection. | ||
Building an timeline component that lists selectable tasks based on a GetRecords collection. |
🎛️ Configuring the Timelime
Configuring the Data Source
The Data Source is crucial for determining what information will be displayed on the timeline. Three data sources are available: Manual, Variable, and Query.
![](https://flow.avonnicomponents.com/~gitbook/image?url=https%3A%2F%2F27923732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1FUd4apB9YHgCEMUFbVb%252Fuploads%252FcIQ9C7KEbBPTKO9ff0vs%252F2023-11-27_22-24-16.png%3Falt%3Dmedia%26token%3Df9477d81-3f1d-49dc-be73-3138d807cf19&width=768&dpr=4&quality=100&sign=2cad5ffe&sv=1)
Data Source Type | Use Case | When to Use |
---|---|---|
Manual | Ideal for static timelines with a predetermined set of events or activities. | When the data doesn’t require updates or changes over time. |
Variable | Perfect for dynamic timelines where events or activities are linked to changing data in Salesforce. | When your timeline needs to reflect real-time data or updates from Salesforce records. |
Suitable for complex timelines that need to pull data from various sources or based on specific criteria. | Ideal for complex data retrieval or when sourcing. Using a 'Get Records' collection with this data source is unnecessary, as the query itself is powerful enough to simplify your flow. |
ry Data Source:
Initial Display: By default, only 20 items will load at first. This helps keep the Timeline fast and responsive.
See All Data: Don't worry! The "Show More" button lets users easily load the rest of your Timeline items.
Customization (Optional): You can adjust the number of initially displayed items if desired. Set a value for the "Max Visible Items" attribute in the Pagination section.
Data Mappings integration
Completing data mappings is essential when using a variable data source. This means connecting Salesforce fields from your 'Get Records' collection or the Query Data Source to the matching attributes in the Avonni Timeline component. Doing this will ensure your Salesforce data populates the timeline correctly, displaying the correct information in the right places.
Example: For instance, you might map a field from your 'Get Records' collection, which contains event start dates, directly to the start date attribute of a timeline event in the Avonni Timeline.
Check out our article on assigning various source collections from multiple objects to the Activity Timeline.
Timeline Orientation
Horizontal: Displays the timeline in a left-to-right format.
Vertical: Presents the timeline in a top-down format.
Orientation | Description | Image |
---|---|---|
Horizontal | The Horizontal Orientation is presenting chronological events or activities in a linear, horizontally-oriented way. | |
Vertical | Display a list of activities in a chronological vertical way. |
Sorted Direction
Display Order (Asc/Desc): Control how timeline items are arranged – earliest to latest (Ascending) or latest to earliest (Descending).
Group By
Group By (Vertical Timeline): Organize your timeline by Day, Week, Month, or Year. For example, group tasks by their due date, or project milestones by month.
![](https://flow.avonnicomponents.com/~gitbook/image?url=https%3A%2F%2F27923732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1FUd4apB9YHgCEMUFbVb%252Fuploads%252FaTmWSNbwNTFpDZ2RqpoV%252FAvonni%2520Components%25204.4%2520Mar%252012.webp%3Falt%3Dmedia%26token%3Dbc7d7db6-8b63-4cf8-adfb-dbe7edf68c50&width=768&dpr=4&quality=100&sign=1eebe735&sv=1)
Field Attributes
Customization of Layout
Define the number of columns each field occupies within the container, allowing precise control over the timeline's layout and appearance.
Purpose: Optimize the visual presentation for improved readability and alignment across different screen sizes.
![](https://flow.avonnicomponents.com/~gitbook/image?url=https%3A%2F%2F27923732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1FUd4apB9YHgCEMUFbVb%252Fuploads%252F7lCaLmo8QwzRey3slLVV%252F2023-11-27_22-15-31.png%3Falt%3Dmedia%26token%3Ddf2290f0-893a-46db-bba1-165b91c75a6e&width=768&dpr=4&quality=100&sign=60ad82ab&sv=1)
Item Actions
Enhancing User Interaction
Place actions at the top right of each timeline item, providing users with quick access to complete tasks in Salesforce.
Benefit: Enables setting specific action names for each item, streamlining user interactions and task completion.
![](https://flow.avonnicomponents.com/~gitbook/image?url=https%3A%2F%2F27923732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1FUd4apB9YHgCEMUFbVb%252Fuploads%252F7cnfEkeBrEufBcEjjmDq%252F2022-10-05_11-09-18.png%3Falt%3Dmedia%26token%3Def515e85-c533-457b-86b8-7b1027125396&width=768&dpr=4&quality=100&sign=43bdbc91&sv=1)
Filtering Options
Offer filtering options displayed as a popover, allowing users to refine what's shown on the timeline.
Setting Up Filters: Add fields from your data source as filters, enabling users to narrow down the timeline view based on specific criteria or attributes
![](https://flow.avonnicomponents.com/~gitbook/image?url=https%3A%2F%2F27923732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1FUd4apB9YHgCEMUFbVb%252Fuploads%252Fk58t67Kx7Kl8lTovbqC5%252F2023-07-03_21-57-17.png%3Falt%3Dmedia%26token%3D1652356d-1a0c-4889-9308-9c5873b7258e&width=768&dpr=4&quality=100&sign=4e9ac085&sv=1)
🎚️ Changing the Properties
Changing the Orientation
The Timeline is available in two variants. Horizontal
and Vertical
orientation.
Orientation | Description | Image |
---|---|---|
Horizontal | The Horizontal Orientation is presenting chronological events or activities in a linear, horizontally-oriented way. | |
Vertical | Display a list of activities in a chronological vertical way. |
Header
The Header section gives you control over the appearance and functionality of your Timeline header.
![](https://flow.avonnicomponents.com/~gitbook/image?url=https%3A%2F%2F27923732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1FUd4apB9YHgCEMUFbVb%252Fuploads%252FrNYhvC3ZabZLu8ArwnQC%252F2023-07-03_20-40-26.png%3Falt%3Dmedia%26token%3D4bb85e17-b99c-4f12-b6a2-2a3855b7a445&width=768&dpr=4&quality=100&sign=692c6e8f&sv=1)
Attribute | Description |
---|---|
Title | Define a meaningful title for your Timeline. It introduces the timeline's content and is a key element of the visual hierarchy. |
Caption | Use the caption field to add a brief description or supplementary information for your Timeline. This can be especially useful for providing context or additional details about the table data. |
Icon | Add an icon to your header to enhance its visual appeal or to help convey the Timeline's purpose or content at a glance. |
Is Joined | This property, when activated, gives the header a square, shadowless bottom border. This makes the header blend seamlessly with another component, making the Timeline appear as a continuous, unified element. |
Buttons | Add interactive buttons to your header to enable specific actions from the interaction pane. This provides additional functionality and enhances user engagement with the Timeline. |
🪄 Adding Interactions
From the interactions panel, you can create interactions when users click on an activity item and/or an action. For example, you may want to redirect users to the record page when they click the activity item link.
Here is a complete list of actions you can add to the Timeline.
🎨 Styling the Timeline
From the Style panel, you can customize styling attributes for the Timelime component:
Size
: set a specific size for the component.Toolbar
: customize the background color of the toolbar.
You can only define Margin and Size for the Timeline from the Styles panel.
🎛️ Specifications
Name | Type | Description |
---|---|---|
| String | Array of action objects. The actions are displayed at the top right of each item. |
| Boolean | If present, the group sections are closed by default. This attribute is supported only for the vertical orientation. |
| Boolean | If present, the section is collapsible and the collapse icon is visible. This attribute is supported only for the vertical orientation. |
| String | If present, the value will define how the items will be grouped. Valid values include |
| String | The Lightning Design System name of the icon displayed in the header, before the title. Specify the name in the format 'utility:down' where 'utility' is the category, and 'down' is the specific icon to be displayed. |
| String | The size of the title's icon. Valid values are xx-small, x-small, small, medium and large. |
| String | The date format to use for each item. See this tutorial to learn more. |
| String | Orientation of the timeline. Valid values include vertical and horizontal. |
| String | If present, the value will define how the items will be grouped. Valid values include week, month or year. This attribute is supported only for the vertical orientation. |
| String | Title of the timeline, displayed in the header. |
| String | The maximum number of visible items to display. |
| ActivityTimelineItem | Array of item objects. |
Last updated