Easyteam Embedded
GuidesAPIWhite-Label UIs
GuidesAPIWhite-Label UIs
  1. Component Reference
  • Integration
    • Easyteam Components
    • iframe Components
    • React Web Components
    • React Native Components
  • Component Reference
    • Time Clock Reference
    • Employees List Reference
    • Timesheets Reference
    • Shift Form Reference
    • Shift Notes Reference
    • Weekly Schedules Reference
    • Agenda Schedule Reference
    • Time Off Policies Settings Reference
    • Time Off Single Policy Reference
    • Organization Settings Reference
  • Themes
    • UI Customization
  1. Component Reference

Weekly Schedules Reference

The Schedules web component enables administrators to create, manage, and visualize employee weekly work schedules across teams and locations.
Weekly schedule interface showing employee shifts, availability, and time-off requests
The Schedules component for web provides a calendar-based interface for managing your team schedules. Administrators can easily create shifts, assign employees, manage availability, and handle time-off requests all in one place.
The weekly view allows for drag-and-drop scheduling across multiple employees and locations, with visual indicators for conflicts, overstaffing, understaffing, and schedule gaps.
Read more about employee scheduling in our guides section

Basic Implementation#

iframe
React

Feature Reference#

Location Selector#

Scheduling employees takes place on a per-location basis. When the current user has permissions to view multiple locations, use the location selector to switch between them.
Location selector

Open Shifts#

The open shifts row will appear above the regular schedule entries.
image.png
Open shifts row
Open shifts allow managers to pre-define what shifts and the amount of labor needed on a specific week, then allow employees to provide their preferences for these shifts.

Publish Schedule#

By default, when making changes to a weekly schedule, the changes applied as drafts and only visible to the managers. After done with changes, managers need to 'publish' the schedule for notifications to go out and for the changes to be reflected on employee calendars.
image.png
Publish schedules
Creating drafts, publishing, managing notifications are automatically handled by the WeeklySchedule component.

Time off requests#

The user will be able to see and approve time off requests using the 'Time off requests' tab.
Time off requests
Read about time off management to learn more.

Event Types#

The onEvent callback receives various events depending on user actions:
EventTriggerPayload
onScheduleCreateA new shift or open shift is createdcurrent_week, shift object
onScheduleDeleteA shift or open shift is deletedcurrent_week, shift object
onScheduleEditA shift is moved or editedcurrent_week, location_ids, old shift object, new shift object
onScheduleWeekChangeUser switches week on the schedule viewcurrent_week, location_ids, new_week
onScheduleLocationChangeUser changes location selectioncurrent_week, location_ids
onScheduleBulkCopyShifts are copied to future weekscurrent_week, location_ids, total_shifts, copy_method, paste_method, copy_to
onSchedulePublishSchedule is publishedcurrent_week, location_ids, total_shifts, total_hours, labor_cost, notify
onSchedulePublishRevertA draft schedule is revertedcurrent_week, location_ids
onSchedulePrintUser prints the schedulecurrent_week, location_ids
onTimeOffRequestsTabViewTime off requests tab is openedcurrent_week, location_ids
onScheduleViewMenuOpenView options menu is openedcurrent_week, location_ids
onScheduleOpenShiftSubmitA staff member submits or claims an open shiftcurrent_week, location_ids, shift object, open_shift_preference
onScheduleOpenShiftRetractA staff member withdraws an open shift submissioncurrent_week, location_ids, shift object, open_shift_preference
onScheduleOpenShiftApproveAn open shift submission is approvedcurrent_week, location_ids, shift object, employees
onTimeOffRequestCreateStaff or admin submits a time off requesttime_off_request object
onTimeOffRequestRetractEmployee withdraws a pending requesttime_off_request object
onTimeOffRequestApproveAdmin or manager approves a requesttime_off_request object
onTimeOffRequestDeclineAdmin or manager declines a requesttime_off_request object

Next Steps#

Read the our Shift Scheduling Guide for the most common use cases.
Modified at 2025-07-16 15:57:25
Previous
Shift Notes Reference
Next
Agenda Schedule Reference