> 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/user-guide/schedules/workforce-shifts-widgets.md).

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

<figure><img src="/files/PA3PQnJ3WA8jkts7H0FL" alt="" width="563"><figcaption></figcaption></figure>

3. Configure the OAuth-based connection using:

* Application token
* Application secret

4. Ensure the service account has:

* **Impersonate** access
* **Read** access

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

<figure><img src="/files/0rGHLAEMxF7GbF9tuQzi" alt="" width="563"><figcaption></figcaption></figure>

3. 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.

<figure><img src="/files/VclkCqG7fml3GFoJEDT9" alt="" width="563"><figcaption></figcaption></figure>

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