Patient Timeline
A Patient Timeline is a Salesforce Health Cloud component that displays a patient's healthcare events in one chronological view.
Definition
A Patient Timeline is a Salesforce Health Cloud component that displays a patient's healthcare events in one chronological view. It pulls appointments, encounters, care plan activities, conditions, medications, and other records onto a single horizontal track, so a care team can read the whole history without opening related lists one by one.
The timeline shows past, current, and future events together. It runs in the Health Cloud console for staff and on Experience Cloud sites for patients through Health Cloud Empower. Salesforce ships an Enhanced Timeline that admins configure declaratively, alongside an older managed-package version that some orgs still run.
How the Patient Timeline pulls a clinical history together
What the timeline actually shows
The Patient Timeline renders records as dots or markers along a horizontal track ordered by date. Each marker represents one event, such as an appointment, a clinical encounter, a care plan task, a condition onset, or a hospital admission. Past events sit to one side, upcoming events to the other, and the present moment in between. A care coordinator opening a patient record can see months or years of history in a few seconds. This matters because patient context is chronological by nature. A clinician needs to know what happened before, what is happening now, and what is scheduled next. Without a timeline, that story lives scattered across related lists, child objects, and separate tabs. Someone has to click into each one and reassemble the sequence in their head. The timeline does that assembly for them and keeps the order correct. The component is read-first. It is built for fast scanning and orientation at the start of a patient interaction, not for heavy data entry. Staff still open the underlying record to edit details, but they reach it from a single, time-ordered map of the patient.
Everything hangs off the Account
The timeline can display details from any object related to the patient through the Account object. That covers core Salesforce objects, Health Cloud objects, and custom objects, as long as each one has a path back to the patient's Account record. In Health Cloud, the patient is usually modeled as a Person Account or as a Contact tied to an Account, so the Account is the natural anchor for the whole clinical record. When you configure a timeline, you pick a base object and then add related objects that link to it. The link is what makes a record eligible to appear. A custom object that tracks counseling sessions, for example, shows up once it carries a lookup that traces to the patient's Account. No code is required to surface it. This Account-centric design keeps the model consistent. The same Account that holds demographics, care team membership, and care plans also drives the timeline. If your data model already relates records to the patient correctly, most of the timeline work is choosing what to show and how to label it, rather than rewiring relationships.
Categories, fields, and icons
Every item on the timeline belongs to a category. Categories are how users filter the view. In the console timeline, the Select All Events picklist lets staff show or hide groups of events. On an Experience Cloud site, patients use the equivalent filter. You might create a category called Counseling, another for Appointments, and another for Medications, then assign each object to the category that fits. Each timeline item displays one primary field as its label when collapsed. That label is what a user reads at a glance, so it should be the most recognizable value, such as a session type or an appointment subject. When the user expands an item, additional configured fields appear with more detail. You decide which fields show in the collapsed and expanded states. Icons give each event type a visual identity. A care worker can tell an admission from a phone call without reading the label, just from the shape on the track. Choosing clear categories, sensible primary fields, and distinct icons is the bulk of timeline configuration, and it is the part that decides whether the view feels useful or noisy.
Console for staff, Experience Cloud for patients
The same timeline concept surfaces in two places. Inside the Health Cloud console, care teams use it as their starting point on a patient record. They land on the page, scan the track, filter to the events they care about, and drill into anything that needs attention. It becomes the first stop in most patient interactions once teams are trained on it. On an Experience Cloud site, the timeline appears through Health Cloud Empower components built for patients and members. Here it lets people see their own past, current, and future healthcare events. A patient can review upcoming appointments, look back at recent visits, and understand where they are in a care plan, all without calling in. The same chronological model that helps staff also gives patients a clear picture of their care. Because both surfaces draw on the same configuration approach, an admin defines what each audience sees deliberately. Staff often need a fuller clinical view, while patients see a filtered, friendlier subset. The categories and field choices let you tune each one.
Enhanced Timeline versus the managed-package version
Health Cloud has shipped more than one timeline over its history. The older approach is part of the Health Cloud managed package, and some long-running orgs still rely on it. The newer approach, the Enhanced Timeline, is configured through a dedicated Timeline tool in Setup and leans on declarative, point-and-click setup rather than package-specific configuration. The Enhanced Timeline workflow is straightforward. You enable the timeline, create a new timeline by naming it and choosing the underlying object, add the related objects you want on the track, set conditions that control which records appear, then save, preview, and activate. The preview step lets you check the result before users see it. If you are building a Health Cloud org today, the Enhanced Timeline is the path Salesforce points you toward, and it is where new capability lands. If you inherited an older org, you may still see the managed-package timeline on some pages. Knowing which one a given page uses matters, because the configuration steps and the admin screens differ between them. Check the component type on the Lightning record page when in doubt.
A worked example: a behavioral health coordinator
Picture a behavioral health coordinator named Priya who manages a caseload of members. She opens a member record and the Patient Timeline loads at the top of the page. The track shows three intake appointments last quarter, two completed counseling sessions, a medication start two weeks ago, and a follow-up appointment scheduled for next Tuesday. Priya filters with the Select All Events picklist to hide administrative tasks and focus on clinical events. She expands the most recent counseling session and reads the configured detail fields, including session type and duration, without leaving the page. The medication marker has its own icon, so she spots it immediately and notes the start date relative to the sessions. Behind this view, an admin earlier added a custom Counseling Session object to a Counseling category, set the session type as the primary field, and chose duration as an expanded field. Because the object links back to the member's Account, every session appears automatically. Priya never thinks about the data model. She sees a clean, time-ordered story of the member's care, which is exactly the point of the component.
Configure an Enhanced Patient Timeline
Set up an Enhanced Timeline in Health Cloud so a configured object's records appear chronologically on the patient record. Do this in Setup, then add the component to a Lightning record page.
- Enable and create the timeline
In Setup, open the Timeline configuration tool, enable the timeline, then create a new timeline. Give it a name and choose the underlying base object that anchors the view to the patient.
- Add related objects
Add the objects you want on the track. Each must relate to the patient through the Account object. Core, Health Cloud, and custom objects all qualify when they carry a path back to the Account.
- Set categories, fields, and icons
Assign each object to a category for filtering. Pick the primary field shown as the collapsed label and the extra fields shown when an item expands. Choose an icon so the event type is recognizable at a glance.
- Define display conditions
Add conditions that control which records appear, so the timeline shows only relevant events rather than every record on the object.
- Save, preview, and activate
Save the timeline, use the preview to confirm it looks right, then activate it. Finally add the Timeline component to the Lightning record page in App Builder and activate the page.
The base object the timeline is built on, anchoring events to the patient record.
The filter group an item belongs to, surfaced through the Select All Events picklist or the Experience Cloud filter.
The single field shown as the item label when the timeline marker is collapsed.
Additional fields revealed when a user clicks to expand a timeline item.
Criteria that decide which records on an object appear on the track.
- A record only appears if its object has a relationship path back to the patient's Account. Custom objects without that link will not show.
- Confirm whether a page uses the Enhanced Timeline or the older managed-package timeline, since their Setup screens and steps differ.
- Adding the component to a Lightning record page is separate from configuring the timeline. You must also activate the page for users to see it.
- Too many categories and fields make the track noisy. Show the minimum a role needs, then expand for detail on click.
Prefer this walkthrough as its own page? How to Patient Timeline in Salesforce, step by step
Trust & references
Cross-checked against the following references.
Straight from the source - Salesforce's reference material on Patient Timeline.
- Timeline for Health Cloud Empower ComponentSalesforce
- Add Objects to the Health TimelineSalesforce
Hands-on resources to go deeper on Patient Timeline.
About the Author
Dipojjal Chakrabarti is a B2C Solution Architect with 29 Salesforce certifications and over 13 years in the Salesforce ecosystem. He runs salesforcedictionary.com to help admins, developers, architects, and cert/interview candidates sharpen their fundamentals. More about Dipojjal.
Test your knowledge
Q1. What does the Patient Timeline display in Salesforce Health Cloud?
Q2. Why is the Patient Timeline especially valuable for clinical care-coordination work?
Q3. Which event type would you expect to find plotted on a Patient Timeline?
Discussion
Loading discussion…