🆕Workforce Shifts Widgets

Overview

Admins can incorporate MangoApps Workforce scheduling, time & attendance, and shift management directly into the MangoApps hub. Instead of relying on third-party workforce tools and disconnected integrations, organizations can now manage frontline schedules natively within the same platform employees use every day.

By enabling the Shifts & Schedules module and adding the relevant hub widgets, admins can give employees real-time access to their shifts, time tracking, availability, and time-off requests—all from a single, unified experience.

---

Step 1: Configure Shifts & Schedules Integration

Before adding widgets to the hub, admins must enable and configure the native Shifts & Schedules integration.

Enable the Built-In Integration

1. Navigate to Admin Portal → Integrations → Built-in Integrations

2. Select the MangoApps HCM/WFM connector

1. Configure the OAuth-based connection using:

• Application token

• Application secret

1. Ensure the service account has:

• Impersonate access

• Read access

1. Click Test Connection to verify setup

Once connected, users are automatically mapped using their email address or employee ID.

---

Step 2: Set Up the Schedules Data Source

After the integration is active, configure the schedules data source that powers hub widgets.

1. Navigate to Admin Portal → Modules → Schedules → Data Sources

2. Create a new data source connected to Shifts & Schedules

1. Configure key options:

• Shift data retention (default: 3 weeks)

• Include or exclude break information

• Enable attestation for selected user segments

• Select the centralized attestation tracker

• Enable Availability, allowing employees to submit future availability

This data source is what feeds shift, attendance, and availability data into the hub widgets.

---

Step 3: Add Shifts & Schedules Widgets to the Hub

Once configured, admins can add Shifts & Schedules widgets to the MangoApps hub to surface real-time actions and visibility.

Time & Attendance Widget

The Time & Attendance widget allows employees to manage their workday directly from the hub.

Employees can:

• Clock in to a scheduled shift

• Clock in to an ad hoc shift (if enabled)

• Start planned breaks

• Clock out at shift end

The widget enforces all fraud-prevention and compliance rules configured in Shifts & Schedules, including:

• Shift-required clock-ins

• Clock-in/out time windows

• IP validation

• Photo verification

• Location validation

• Device verification

---

Time-Off Requests Widget

The Time-Off Requests widget enables employees to manage leave without leaving the hub.

Employees can:

• View pending, approved, and upcoming leave requests

• Submit new time-off requests using admin-configured leave types

Key behavior:

• Approval or denial in Shifts & Schedules is reflected instantly

• Business rules are validated in real time

• Clear error messages are shown if rules are not met

---

Upcoming Shifts Widget

The Upcoming Shifts widget shows employees their scheduled shifts and enables shift-sharing actions.

Key action:

• List Shift in Marketplace

Employees can:

• List a shift for pickup by eligible users

• Offer a shift directly to a specific person

Once a pickup request is approved:

• The approved user becomes the assigned owner

• Other requests are automatically canceled

• The shift appears in the new owner’s Upcoming Shifts and Schedules module

---

Shift Marketplace Widget

The Shift Marketplace widget allows employees to discover and claim open shifts.

Employees can:

• View available open shifts with time, location, and owner details

• Request to pick up a listed shift

• Accept direct shift offers made specifically to them

Pickup workflows:

• Requests are reviewed by the original shift owner

• Approval or denial is reflected in real time

• Approved shifts appear instantly in:

  • Upcoming Shifts widget

  • Schedules module

Direct offers:

• Are visible only to the selected user

• Are immediately assigned upon acceptance

• Notify the original shift owner automatically

---

Step 4: Use the Dedicated Schedules Module

In addition to hub widgets, employees and managers can access the full Schedules module for deeper visibility.

Available Views

• Team Shifts Shows shifts assigned to employees at the user’s location

• My Shifts Displays all shifts assigned to the logged-in user, including submitted attestations

• My Availability Lists availability preferences submitted for future scheduling