Agenda Schedule Reference

The Agenda Schedule component provides a mobile-optimized interface for both administrators and employees to interact with work schedules and time-off requests.

Mobile agenda view showing employee shifts, open shifts, and time-off options

The AgendaSchedule component adapts scheduling functionality to mobile screen dimensions, providing an intuitive calendar experience optimized for touch interfaces.
Managers and admins can achieve most functions found in the full web-based WeeklySchedule component. Users with low permissions can access to all of their day-to-day scheduling needs using the Agenda View: can only view the schedule, respond to open shifts and create time off requests.

Employees usually prefer the mobile-first experience of the Agenda View instead of using a web-based version.

Basic Implementation

React Native

User Experiences

Administrator Experience

Administrators can manage team schedules in a mobile-first experience:

View and filter schedules by location and role

Create and modify employee shifts

Manage open shifts and approval process

Publish schedule updates with notifications

Review and approve time-off requests

Employee Experience

Employees with standard permissions can view their scheduled shifts and request time off according to company policies

Employee request time off experience

Open Shifts for Employees

When open shifts are enabled (see Feature Flags), employees can view and interact with shifts that match their assigned location and role, submit preferences for or claim eligible open shifts.

Open shifts on mobile

Parameters

Parameter	Type	Description
`start`	string	The starting date of the week to display in ISO format (YYYY-MM-DD). If not provided, the current week will be shown.
`location`	string	The external ID of the currently displayed location. Defaults to the first location available to the user.

Event Types

The onEvent callback receives various events depending on user actions:

Event	Trigger	Payload
`onScheduleCreate`	A new shift or open shift is created	`current_week`, `shift` object
`onScheduleDelete`	A shift or open shift is deleted	`current_week`, `shift` object
`onScheduleEdit`	A shift is moved or edited	`current_week`, `location_ids`, old `shift` object, new `shift` object
`onScheduleWeekChange`	User switches week on the schedule view	`current_week`, `location_ids`, `new_week`
`onScheduleLocationChange`	User changes location selection	`current_week`, `location_ids`
`onScheduleBulkCopy`	Shifts are copied to future weeks	`current_week`, `location_ids`, `total_shifts`, `copy_method`, `paste_method`, `copy_to`
`onSchedulePublish`	Schedule is published	`current_week`, `location_ids`, `total_shifts`, `total_hours`, `labor_cost`, `notify`
`onSchedulePublishRevert`	A draft schedule is reverted	`current_week`, `location_ids`
`onSchedulePrint`	User prints the schedule	`current_week`, `location_ids`
`onTimeOffRequestsTabView`	Time off requests tab is opened	`current_week`, `location_ids`
`onScheduleViewMenuOpen`	View options menu is opened	`current_week`, `location_ids`
`onScheduleOpenShiftSubmit`	A staff member submits or claims an open shift	`current_week`, `location_ids`, `shift` object, `open_shift_preference`
`onScheduleOpenShiftRetract`	A staff member withdraws an open shift submission	`current_week`, `location_ids`, `shift` object, `open_shift_preference`
`onScheduleOpenShiftApprove`	An open shift submission is approved	`current_week`, `location_ids`, `shift` object, `employees`
`onTimeOffRequestCreate`	Staff or admin submits a time off request	`time_off_request` object
`onTimeOffRequestRetract`	Employee withdraws a pending request	`time_off_request` object
`onTimeOffRequestApprove`	Admin or manager approves a request	`time_off_request` object
`onTimeOffRequestDecline`	Admin or manager declines a request	`time_off_request` object

Next Steps

Read our Mobile Scheduling Guide for common use cases and implementation strategies.

Basic Implementation#

User Experiences#

Administrator Experience#

Employee Experience#

Open Shifts for Employees#

Parameters#

Event Types#

Next Steps#