Easyteam Embedded
GuidesAPIWhite-Label UIs
GuidesAPIWhite-Label UIs
  1. Development
  • Getting Started
    • Introduction
    • Why Choose Easyteam Embedded
  • Development
    • Overview
    • Authentication
    • Web Integration
    • Mobile SDK Integration
    • Passing Data
    • Using Identifiers
    • Events
    • Error Handling
  • Going Live
    • Data Security
    • Support
  • Embedded Workforce Management
    • Organizations & Locations
    • Employees
    • Permissions
    • Compliance
  • Embedded Time Tracking
    • Overview
    • Time Clock
    • Timesheets
    • Breaks
    • Geofencing
    • Timezones
  • Embedded Scheduling
    • Overview
    • Availability & Open Shifts
    • Multi-Location Scheduling
    • Publishing Schedules
    • Working with Time Off in Schedules
    • Notifications on Schedule Actions
    • Calendar Sync (Google / Apple Calendar)
  • Embedded Time Off Management
    • Overview
    • Time Off Policies
    • Requests & Approvals
    • Balance Tracking & Accruals
    • Carryover Rules
    • Time Off and Payroll Sync
  • Embedded Notifications
    • Overview
  • Payroll Integrations
    • Embedded Payroll with Salsa
      • What is Embedded Payroll?
      • Time & Attendance in Payroll
      • Money Movement and Compliance
    • External Providers
      • Embedded Payroll Integrations
  • AI-Native Integrations
    • Integrating an MCP Server with Easyteam
  1. Development

Web Integration

Easyteam's web components offer a fully customizable workforce management interface that can be seamlessly integrated into your platform in minutes.
Choose between React Components for deeper customization or the Iframe Component for quick deployment. This guide will walk you through selecting and implementing the right approach for your platform.

Iframe Integration#

For platforms requiring a quicker setup, the Iframe integration using EasyTeamLauncher offers a complete workforce management interface with minimal effort.
Recommended for most platforms: Use the iframe element to embed Easyteam features directly in your web app while maintaining full control over customization and behavior.

Installation#

Basic Implementation#

Read more about authentication and passing employee, location and employer data in the relevant guides.

Navigation Between Pages#

The launcher supports navigation between different views:
Read more about Iframe UI implementation in White-Label UI docs - Iframe.

Parameters#

PropertyTypeRequiredDescription
jwtstringYesAuthentication token for the session. See Authentication docs.
employeesArray<Employee>YesEmployee data (IDs, names, roles, locations). No PII is stored. See Passing Data docs.
locationsArray<Location>NoList of work locations. Used to define organizational structure.
organizationOrganizationNoMetadata about the company using the platform.
rolesArray<Role>NoCustom permission structures to apply to users. See Passing Data.
themeobjectNoUI customization object. See Theme Configuration docs.
fontsobjectNoCustom fonts mapping, e.g. regular, bold, semiBold.
baseURLstringNoThe iframe source base URL (e.g., Easyteam sandbox or production endpoint).
apiBaseURLstringNoBase URL for API calls (matches the iframe base or separate endpoint).
onEvent(event: Event) => voidNoCallback for user actions like clock-in, break start, or export.

React Integration#

Installation#

Provider Setup#

Wrap your application with the EasyTeamProvider:

Example Component Implementation#

Read more about UI implementation in White-Label UI docs. Parameters passed to the provider are similar to the parameters described for EasyTeamLauncher above.

Comparison#

React Integration#

✔️ Full customization control
✔️ Deep integration with existing UI
✔️ Custom state management
✔️ Flexible routing
⚠️ Requires more initial setup

Iframe Integration#

✔️ Fastest implementation
✔️ Automatic updates
✔️ Minimal maintenance
✔️ Built-in responsive design
⚠️ Limited customization

Next Steps#

1.
Choose your integration method based on your requirements.
2.
Set up Integration and Authentication.
3.
Explore the complete White-Label UI docs.
💡
Need help deciding? Contact our team to discuss your specific needs and get implementation guidance.
Modified at 2025-06-12 13:00:21
Previous
Authentication
Next
Mobile SDK Integration