> For the complete documentation index, see [llms.txt](https://guides.mangoapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.mangoapps.com/integrations-guide/mangoapps-workforce/shift-widgets.md).

# Shift Widgets

### Overview <a href="#overview" id="overview"></a>

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 <a href="#step-1-configure-shifts-and-schedules-integration" id="step-1-configure-shifts-and-schedules-integration"></a>

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**

<img src="https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1570117564-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKTG8tJVFEuapHmLNC%252Fuploads%252FTUZsW8xMhfDNtVnly3Wc%252F20-01-2026-09-18-37.png%3Falt%3Dmedia%26token%3D855cc0df-b0e6-489a-a7da-1ed2a147f486&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=d894dabf&#x26;sv=2" alt="" width="563">

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 <a href="#step-2-set-up-the-schedules-data-source" id="step-2-set-up-the-schedules-data-source"></a>

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**

<img src="https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1570117564-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKTG8tJVFEuapHmLNC%252Fuploads%252FuSkupKhegCHIHNL5zrbu%252F20-01-2026-09-22-27.png%3Falt%3Dmedia%26token%3D7fcc6d52-e5e0-42e8-b8cf-5e118faae83e&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=84238aa3&#x26;sv=2" alt="" width="563">

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 <a href="#step-3-add-shifts-and-schedules-widgets-to-the-hub" id="step-3-add-shifts-and-schedules-widgets-to-the-hub"></a>

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

<img src="https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1570117564-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKTG8tJVFEuapHmLNC%252Fuploads%252FugPwJTjVFvsnvWOCuTLH%252Fshift-widgets.png%3Falt%3Dmedia%26token%3D39b7b8f7-d1b6-4338-bf7d-dbe4a4ac5374&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=6acf46c5&#x26;sv=2" alt="" width="563">

**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 <a href="#step-4-use-the-dedicated-schedules-module" id="step-4-use-the-dedicated-schedules-module"></a>

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