# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.mangoapps.com/integrations-guide/mangoapps-workforce/shift-widgets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.