Help Center

Find detailed guides and information for all RosterMate features

Rosters

Getting Started with 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.

Navigating the Timeline

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.

Working with Roster Groups

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.

Using Templates

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.

Position View — Building a Roster by Position

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.

Employee View — Building a Roster by Employee

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.

Sidebar Tools

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.

Open Shifts and Bidding

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.

Auto-Generating a Roster (Bot)

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.

Scheduling Meetings

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.

Leave Conflicts and Unavailability

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.

Public Holidays

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 Your Changes

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.

Publishing a Roster

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.

Deleting a Roster

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.

Printing a Roster

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.

The Roster Sidebar Panel

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.

Reviewing Shift Swaps

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.