Help Center
Find detailed guides and information for all RosterMate features
Rosters
The Rosters page is where you build, schedule, and publish staff rosters. The page uses an infinite-scrolling timeline so you can scroll left or right to navigate through dates without ever switching weeks. As you scroll, additional dates and any rosters in those date ranges are loaded automatically.
The Date Header
The horizontal date header at the top shows each day in the timeline, including the day of the week, date, month, and year. The current day is highlighted, and any day that is part of a published (live) roster is visually marked. Public holidays are highlighted in red and show the holiday name.
Roster Tables
Rosters appear as tables anchored to the date header. Each roster spans a specific date range (typically a week, but it can be any length defined by its template). You can have multiple rosters visible at once as you scroll through the timeline.
Selecting a Roster
Click on a roster table to select it. The selected roster will be highlighted with a coloured border, and the right-hand sidebar will update to show the hours scheduled for each employee in that roster. Many actions, such as Publish, Print, Delete, and Auto-Generate, only work on the currently selected roster.
Two View Modes
Each roster is built in one of two view modes. Position View arranges the roster by area and position, with each row representing a position to be filled and each cell containing the employee assigned to that shift. Employee View arranges the roster by employee, with each row representing an employee and each cell showing the position(s) they are scheduled to work that day. The view mode is set on the template and cannot be changed after a roster is created.
Scrolling Through Dates
Simply scroll the date timeline horizontally and new dates will be loaded automatically as you reach the edges. There is no need to click "next week" or "previous week" — the timeline extends in both directions on demand. Any rosters that fall within the newly loaded date ranges will appear in their correct positions.
Roster Navigation Buttons
The left and right arrow buttons in the header scroll the timeline smoothly in either direction. Press and hold for continuous scrolling, or click briefly to nudge the view.
Go to Date
Click the "Go to Date" button to open a calendar picker. You can navigate between months using the arrows and click on any date to jump the timeline to that day. The "Today" button at the bottom of the calendar returns you to the current date. The selected date will be centered in the timeline view.
Zoom Control
Use the zoom slider in the header to scale the roster between 50% and 100%. This is useful for viewing more days at once on a smaller screen, or for zooming in to see more detail. Click on the percentage display to instantly reset the zoom to 100%. Your zoom preference is saved between sessions.
What Are Roster Groups?
Roster groups let you separate rosters into independent timelines, for example if you run multiple departments, sites, or shift patterns that are scheduled separately. Each group has its own set of rosters, templates, and published shifts, but employees can appear across multiple groups.
Switching Between Groups
Click the Roster Group button at the top-left of the page to open the Roster Groups modal. Select any group from the list to switch to it. The timeline will reload to show only the rosters belonging to that group.
Creating, Renaming, and Deleting Groups
Inside the Roster Groups modal you can create a new group with the "New Group" button, rename the current group with "Rename", or delete it with "Delete". Deleting a group is permanent and removes all of its rosters, so use this with care.
Cross-Group Shift Visibility
If an employee is scheduled in multiple groups on the same day, the system will detect overlapping shifts and warn you with a visual indicator on the cell. This helps prevent accidentally double-booking staff across departments.
What Are Templates?
Templates are saved roster layouts that you can drop onto the timeline to quickly create a new roster. A template defines the areas, positions, shift times, and (optionally) employee assignments for a recurring pattern, such as a typical week.
Finding Templates
Templates appear in the left-hand sidebar under the Templates section. Click the section header to expand or collapse the list. Use the search bar at the top of the section to filter templates by name. Each template shows its duration (in days or weeks) and its view type (Position or Employee).
Applying a Template to a Date
To apply a template, drag it from the Templates list and drop it onto a date cell in the timeline. As you drag, the date range that the template will cover is highlighted so you can see exactly where it will land. If the date range overlaps an existing roster or template, the drop will be blocked to prevent conflicts.
Auto-Pulling Templates
You can mark a template as Active so it automatically generates new rosters on a schedule. Click the calendar-with-arrow icon next to a template to open the activation modal. Choose how many weeks in advance the template should pull (so rosters are generated ahead of time), select the day of the week the template should start on, and optionally enable email notifications and mobile notifications so employees are alerted when the new roster goes live. Active templates are highlighted with a green indicator.
Deactivating a Template
Click the same icon on an active template to deactivate it. The template will stop auto-generating future rosters, but any rosters that were already created remain in place.
How Position View Works
In Position View, each row of the roster represents a position that needs to be filled in a specific area, and each column represents a date. You select the position for each row, then drop employees into each daily cell to assign who works that shift.
Assigning a Position to a Row
Click the row's position label in the sidebar to open the position selection modal. Search for and select a position, and the row will update with the chosen position name. The position determines which employees are eligible to be placed into that row's cells.
Assigning Employees
Drag an employee from the right-hand sidebar onto an empty cell to assign them to that shift. Alternatively, click an employee in the sidebar to select them, then click an empty cell to place them. To move an employee, drag them from one cell to another. To swap two employees, drag one onto the other.
Setting Shift Times
Click the clock icon (or the existing time text) in any cell to open the time editor. Use the start and end time pickers to set the shift times. The system will automatically calculate the hours and update the employee's daily and weekly hour totals in the sidebar.
Row Context Menu
Right-click anywhere on a row to open the row context menu. "Set Row Times" applies the same start and end times to every cell in the row at once, useful for repeating identical shifts across the week. "Duplicate Row" creates a copy of the row immediately below, including position and shift times. "Delete Row" removes the row from the roster.
Adding More Rows
Each area has a + button at the bottom of its rows. Click this to add a new blank row to that area, ready for you to assign a position and shifts.
How Employee View Works
In Employee View, each row represents one employee, and each cell shows the position (or positions) that employee is scheduled to work that day. This view is useful when you want to see at a glance what each employee is doing across the week.
Adding an Employee Row
Click the + button at the bottom of an area to add a new employee row. An employee selection modal will appear; search for an employee by first or last name and click to select them. The row will be created and ready for you to add positions to each day.
Assigning Positions to Days
Click an employee in the sidebar (or use the position picker that appears) and then click into a day cell to assign that position to the employee for that day. You can place multiple positions in the same day cell if the employee works split shifts. Each position shows its associated time range.
Editing Position Times
Click on a position pill inside a day cell to open the time editor for that specific position. Set the start and end times and save. Times are stored per position, so the same employee can have different times on different days.
Row Context Menu
Right-click anywhere on an employee row to access shortcuts. "Duplicate Row" creates a copy of the row, including all positions and times. "Clear All Shifts" removes every position from the row, leaving the employee in place but with no scheduled shifts. You can also remove the employee entirely from the menu.
Cell Context Menu
Right-click on a specific day cell in Employee View for additional shortcuts. "Copy Shift" copies the cell's contents and "Paste Shift" pastes them elsewhere — keyboard shortcuts Ctrl+C and Ctrl+V also work. "Fill Down" copies the shift into all empty cells below in the same row. "Fill Across" copies the shift to all other days in the same row, useful for setting a uniform week.
The Employee Sidebar
The right-hand sidebar lists every employee, along with their hours scheduled per day and per week (totals update live as you build the roster). Drag employees from the sidebar to roster cells, or click an employee to highlight every cell where they are already scheduled.
Search and Sort
Use the search bar to filter employees by first or last name. The sort dropdown lets you order employees by First Name (A-Z or Z-A) or Surname (A-Z or Z-A). Your sort preference is saved between sessions.
Position Filter
Use the "Show All Positions" dropdown to filter the sidebar to employees holding a specific position, for example only nurses or only kitchen staff. This is helpful when assigning a particular row.
Colour Toggle
Click the colour-wheel icon to toggle employee colour-coding on roster cells. When enabled, each cell takes on the assigned employee's colour, making it easy to spot patterns at a glance.
Eraser Tool
Click the eraser icon to enable eraser mode. While active, your cursor follows an eraser indicator, and clicking on a cell clears its time and assignment. The employee's hour totals in the sidebar are automatically updated. Click the eraser again to turn it off.
Block Tool
Click the block icon to enable block mode. Clicking a cell while this is active marks the cell as blocked, meaning no employee can be assigned to it. Useful for closed days, days off, or unavailable shifts.
Time Tool
Click the clock-with-arrow icon to open the Time Tool. Choose a saved time template (e.g. "9:00 AM - 5:00 PM") and then click any cell to instantly stamp those times onto it. This is much faster than opening the time editor for each cell when you have lots of identical shifts.
Open Shift Tools
The Open Shift (Immediate) and Open Shift (Bidding) tools let you mark cells as available for staff to claim. Immediate shifts are picked up by the first qualified employee who accepts them. Bidding shifts gather applicants over time, and you choose who to award the shift to. See the "Open Shifts and Bidding" section below for full details.
What Are Open Shifts?
An open shift is a scheduled shift that has no employee assigned, but is published so that eligible employees can claim it from their app. There are two types: Immediate, where the first qualified employee to accept gets the shift, and Bidding, where employees apply and an admin chooses who is awarded the shift.
Creating an Open Shift in Position View
Use the Open Shift (Immediate) or Open Shift (Bidding) tool from the sidebar, then click an empty cell. The cell will be marked with a magnifying-glass icon (Immediate) or a gavel icon (Bidding). The cell still requires a position and shift times — set those as you would for any normal shift. When the roster is published, eligible staff will see the open shift and can request or bid on it.
Creating an Open Shift in Employee View
In Employee View, click the magnifying-glass icon on any date in the date header. This opens the Open Shifts modal for that day. Switch between "Create New" and "View Existing" tabs. To create one, choose the type (Immediate or Bidding), select an area and position, set the start and end times, and click "Create Open Shift".
Reviewing and Editing Open Shifts
The "View Existing" tab in the Open Shifts modal lists every open shift for that date with its area, position, and times. Click the pencil icon to edit a shift, or the bin icon to delete it. For Bidding shifts, an "Applicants" button shows how many employees have applied; click it to open the applicants list.
Awarding a Bidding Shift
For Bidding shifts, applicants are listed with their names and submitted notes. Review the list and click on the employee you wish to award the shift to. The cell will be reassigned to that employee, and the others will be notified that they were not selected.
Visual Indicators
Open Shift cells show distinctive icons (a magnifying glass for Immediate, a gavel for Bidding). Bidding shifts also show a small badge with the current number of applicants, so you can see at a glance which shifts are getting interest.
What the Bot Does
The Auto-Generate Bot fills in empty cells of a selected roster automatically, choosing employees based on the rules you have configured. It respects approved leave, employee availability, position eligibility, and any custom hard rules and preferences in your ruleset.
Opening the Bot
First, click on the roster table you want to auto-generate so it becomes the selected roster. Then click the robot icon in the header to open the Bot Ruleset Configuration modal.
Hard Rules vs Preferences
The bot modal has two tabs. Hard Rules are constraints the bot must obey, such as "do not exceed maximum weekly hours" or "do not assign on a leave day". Preferences are softer goals the bot tries to achieve, such as "spread shifts evenly" or "favour senior staff for certain positions". Use the tabs to switch between configuring each set of rules.
Adding Rules to the Active Ruleset
The left side of the modal lists every available rule template; the right side shows the rules currently active. Search for a rule, click to add it to the active ruleset, then configure its parameters in the slide-in panel that appears (for example, setting a maximum hours value, choosing which positions or tags it applies to, or setting time windows).
Removing or Editing Rules
Click any rule in the active list to re-open its configuration panel and adjust the parameters, or remove it entirely. Changes are saved automatically.
Running the Bot
When you are happy with the ruleset, click "Start Auto-Roster". A loading overlay will appear while the bot processes the roster. When complete, the bot fills in the empty cells with its proposed assignments, and any open shift requests or bidding cells it placed remain marked accordingly. The roster is left unsaved so you can review the results and make tweaks before saving.
What the Bot Won't Touch
The bot only fills cells that are genuinely empty. It will not overwrite cells that already have an employee assigned. This means you can manually pre-assign certain shifts (for example, fixed staff in specific roles), then let the bot fill in the rest.
Adding a Meeting
Each date cell in the timeline has a small calendar icon. Click it to open the Schedule Meeting modal for that day. Enter a title, an optional description, and a start and end time (or leave the times blank for an all-day note). Then select the employees to invite using the search box and checkboxes, or click "Select All" to invite everyone.
Multiple Meetings Per Day
You can schedule multiple meetings on the same day. Existing meetings for that day are listed in the modal under "Existing Meetings This Day", where you can click any one to edit it or delete it.
Meeting Indicators
Days that have one or more meetings show a small indicator on the date cell. Hover over it to see a summary of the meetings.
Why Use Meetings?
Meetings are visible to invited employees in their app alongside their shifts. Use them for team meetings, training sessions, induction days, performance reviews, or any other event you want to communicate to staff alongside the roster.
Approved Leave
If an employee has approved leave on a day they are scheduled to work, the cell will show a red exclamation indicator. This warns you that the assignment conflicts with leave, and you should reassign the shift to another employee.
Pending Leave
If an employee has a pending (not yet approved) leave request, scheduled cells on those days show a yellow question-mark indicator. This is a softer warning — the leave hasn't been approved yet, but you may want to plan around it.
Unavailability
Employees can mark themselves unavailable on certain days or for certain time windows. If you assign a shift that overlaps an employee's unavailability, the cell will be flagged. Hover the cell to see the unavailability time range.
Highlighting Leave on the Sidebar
Click an employee's name in the sidebar to highlight all leave days for that employee in the timeline. This makes it easy to see at a glance when they are away before assigning shifts.
Cross-Roster Shift Conflicts
If an employee is scheduled for overlapping shifts on the same day in two different rosters or roster groups, both cells will be flagged with an overlap warning. Resolve by adjusting times or unassigning one of the shifts.
Holiday Detection
The system automatically detects public holidays based on your region and marks them on the date header in red. The holiday name is shown beneath the date and on hover.
Why It Matters
Public holiday detection is purely informational on the Rosters page — it doesn't change how shifts are scheduled. However, it warns you when planning so you don't accidentally roster a closed day. Public holiday pay calculations happen in the Timesheets page once shifts are approved.
Regional Holidays
Some countries have region-specific holidays (for example, anniversary days that vary by region). The system uses your business location to apply the correct regional holiday set.
Saving
Click the green save icon in the bottom-right of the page to save your changes. Saving preserves all assigned shifts, times, open shifts, blocks, and any other edits you've made. Saving does not publish the roster — it only persists your work.
Unsaved Changes Warning
If you try to navigate away from the page or refresh while you have unsaved changes, a warning will appear with three options. "Save & Continue" saves your changes before navigating. "Continue Without Save" discards changes and navigates away. The X button cancels the navigation and keeps you on the page.
Auto-Save Behaviour
Some actions, such as scrolling far through the timeline or opening the Bot configuration, will save the current state automatically before continuing. This protects your work without you having to remember to save.
What Publishing Does
Publishing a roster makes it live, meaning the assigned shifts become visible to employees in their app and the shifts feed into clock-in records and Timesheets. Until a roster is published, it is a draft only.
How to Publish
Select the roster you want to publish by clicking on its table, then click the "Save & Publish" button in the header. The button only appears when a non-published roster is selected. The roster will be saved and then marked as live, and live rosters are visually distinguished by a coloured border and a marker on the dates in the header.
Notifications on Publish
Two icon toggles in the header control whether notifications are sent when you publish. The envelope icon enables Email Notifications, sending each affected employee an email summary of their new shifts. The phone icon enables Mobile Notifications, sending an in-app push notification. Both can be on, off, or used independently. Your toggle states are saved between sessions.
Unpublishing
If you need to make changes to a live roster, select it and click the "Unpublish" button. The roster returns to draft state, and shifts are temporarily hidden from employees. Make your edits, save, and then re-publish when ready.
What Happens to Existing Assignments
Unpublishing does not delete any cells — all assignments, times, blocks, and open shifts remain intact. The roster simply becomes draft again until re-published.
How to Delete
Select the roster you want to remove by clicking on its table, then click the bin icon in the header. A confirmation dialog will ask you to confirm — click OK to proceed.
Deleting Drafts vs Live Rosters
Deleting an unpublished (draft) roster simply removes it from the timeline. Deleting a live roster also removes it from employees' apps and from Timesheets, so use this with care. If shifts on the roster have already been clocked in or recorded in Timesheets, those records will be orphaned — coordinate with your payroll team before deleting a live roster.
Template Instances
If you've dragged a template onto the timeline but haven't saved yet, that "template instance" can be deleted instantly without confirmation from the server, since it doesn't yet exist in the database.
Opening the Print Preview
Select the roster you want to print, then press Ctrl+P (Cmd+P on Mac). The Print Preview modal will appear, showing a print-formatted version of the selected roster. The standard browser print dialog is bypassed in favour of this custom preview, which is laid out specifically for clean printing.
Printing
Click the "Print" button at the top of the preview to send the roster to your printer. Each area of the roster prints on its own page, with the date header repeated and a sidebar listing positions for that area.
Closing Without Printing
Click "Close" to dismiss the preview without printing.
What Gets Printed
Only the selected roster is printed. Toolbars, sidebars, and other interface chrome are hidden so you get a clean schedule that's easy to read on paper.
What the Panel Shows
A fixed sidebar on the left of the timeline shows information about the currently visible roster. In Position View, it lists each row's position name and area. In Employee View, it lists the employees in the roster.
Reordering Rows
You can drag rows in the sidebar to reorder them. The corresponding rows in the roster table will rearrange to match. This is useful for grouping related positions or employees together.
Quickly Selecting Areas, Positions, or Employees
Clicking a label in the sidebar opens the appropriate selection modal so you can change the area, position, or employee for that row without scrolling the roster horizontally.
Following the Visible Roster
As you scroll through the timeline, the sidebar automatically updates to reflect whichever roster is currently visible. If you scroll between two rosters, you'll see the sidebar swap content as the roster anchored to the current dates changes.
What Is a Shift Swap?
Employees can request to swap shifts with each other through their app. Some swaps may require admin approval before they take effect. The Rosters page shows pending and accepted swaps directly on the affected cells.
Swap Indicators
Each shift swap is shown as a small badge on the relevant cell. A grey badge means the swap is pending and waiting for someone to take the shift. A green double-check badge means the swap is accepted or approved. A red badge means the swap was rejected. An amber hourglass badge means the swap needs admin approval — click it to review.
Approving or Denying a Swap
Click the amber hourglass badge to open the Shift Swap Request modal. The modal shows who originally had the shift and who wants to take it. You can add a note explaining your decision, then click Approve or Deny. Approving immediately reassigns the shift; denying notifies the requesters that the swap was not allowed.
After a Decision
The cell's badge updates to reflect the new status (green for approved, red for denied). If you approved, the cell's displayed employee changes to the new owner of the shift.