Introduction
The Team Patients tab is your digital handover sheet, displaying all patients currently assigned to your team. It provides a comprehensive overview of each patient's status, location, responsible clinician, and outstanding actions, helping you coordinate care and manage workload across your team.
Before You Start
Required Access:
- You must be a member of the team, OR
- You must be an Organisation Administrator
If you lack access, the system will display: "You do not have permission to view the patients of this team."
Steps
Navigating to Your Team Patients
- From the sidebar, click Teams
- The Teams accordion expands to show all teams you belong to
- Click the name of the team you want to view
- The Team view opens with the Patients tab active by default (this is the first tab)
The URL will show /teams/teamId?tabindex=0.
Understanding the Patient Table
The patient table displays the following information for each patient:
Profile Column:
- Profile image with gender icon
- Age badge (calculated from date of birth)
- Overdue action count badge (if applicable)
Name Column:
- First name and last name
- Risk flag icon (hover to see risk reason)
- Gender label
- Date of birth with calculated age
- Medical Record # (hospital number)
- Nat.ID (NHS number)
- Location tag (if set)
Status Column:
- Colour-coded status tag with current status name
- Time since last status update (e.g., "2 days ago")
- Full date/time of last update
- Name of user who last updated the status
- "No Status" if not set
Other Columns:
- Actions: Badge showing count of outstanding actions
- Location: Patient's current location (ward, bed, room)
- Source: Where the patient was transferred from (team-specific)
- My Patient: Tag displayed if you are the responsible clinician
Mobile View: Most columns are hidden on mobile and shown in a detail view format instead.
Searching for Patients
- Click the search icon in the top navigation bar
- A search field appears with placeholder text: "type the patients first or last name ..."
- Type the patient's first or last name
- The table updates automatically after 300ms
- Your search query is saved for this team (persists in session storage)
Filtering by Patient Status
- Click the filter icon in the top navigation bar
- A dropdown menu appears showing:
- Active Patients (selected by default)
- No Status (patients without a status)
- All organisation-defined patient statuses
- Inactive (if not hidden)
- Select a status from the list
- The table updates to show only patients with that status
- Your filter selection is saved for this team (persists in session storage)
Viewing Additional Patient Information
To show handover categories:
- Click the tree icon in the top navigation bar
- Toggle the Show Handover Categories: switch to ON
- Patient rows expand to display team-specific handover category data
- This setting persists to local storage
To show patient actions:
- Toggle the Show Actions: switch to ON
- Each patient row expands to show:
- List of actions with name, due date/time, and status tag
- Quick close buttons for each action (2-second confirmation)
- Create Action button for adding new actions inline
- This setting persists to local storage
Printing Patient Lists
To print your patients only:
- Click the My Patients button (hover text: "Print MY patients in this team")
- A PDF generates showing only patients where you are responsible
- The PDF respects current search/filter settings
- The PDF downloads automatically
To print all team patients:
- Click the All Patients button (hover text: "Print ALL patients in this team")
- A PDF generates showing all patients in the team
- The PDF respects current search/filter settings
- The PDF downloads automatically
Accessing Team Actions
- Click the kebab menu (⋮) in the team header
- Available actions depend on your role:
All team members can:
- Add patient: Create a new patient record or readmit a discharged patient
- Handover all my patients in this team: Transfer responsibility for all your patients in this team
- Take responsibility for all patients: Become responsible for all patients in the team
Team Owners and Administrators can also:
- Rename team: Update the team name
- Add user to team: Invite a new member to join the team
- Manage Handover Categories: Configure team-specific patient fields
- Update Team Memo: Add or edit the team message
Organisation Administrators can also (if chat enabled):
- Update Team Chat Settings: Configure team chat features
Viewing Individual Patient Details
- Click anywhere on a patient row
- The browser navigates to the individual patient view (
/patients/patientId) - The patient view opens showing Profile, Actions, Notes, and Log tabs
Sorting the Patient List
Default sorting:
- Patients are sorted by last name in descending order
To change sorting:
- Click a column header (Name, Status, or Location)
- The sort direction toggles between ascending and descending
- Your sort preference is saved (persists in session storage)
Navigating Multiple Pages
Pagination:
- Default: 50 patients per page
- Use PREV/NEXT buttons or page numbers to navigate
- Your current page is saved (persists in session storage)
Tips
-
Search is debounced: The search field waits 300ms after you stop typing before updating the table. This prevents excessive API calls while you're still typing.
-
Filters and search work together: You can combine search terms with status filters to narrow down the patient list.
-
The "My Patient" tag helps you prioritise: Quickly identify which patients you're responsible for by looking for the "My Patient" tag in the table.
-
Expand patient details: Click a patient row to expand and view clinical summary, team categories, and quick actions (if toggles are enabled).
-
Risk flags need attention: If you see a risk flag icon, hover over it to read the risk reason. These patients may require additional monitoring.
-
Print reflects your view: When you print a patient list, the PDF includes your current search/filter settings. This is useful for creating focused handover sheets.
-
Overdue action badges are red flags: The red badge on a patient's profile indicates overdue actions that need immediate attention.
-
Status timestamps matter: The time since last status update helps you identify patients who may need review (e.g., "Status last updated 3 days ago").
-
Toggle settings persist: Your "Show Handover Categories" and "Show Actions" preferences are saved to local storage, so they'll remain active when you return to this team.