Organization Settings Reference

The Settings component provides a centralized interface for configuring workforce management features, including time tracking rules, team permissions, geolocation requirements, and break management.

Settings interface showing configuration options

Basic Implementation

iframe

React

React Native

Configurable settings

Feature Configuration

The Settings component allows showing and hiding of feature sections based on your use case. For example in an iframe implementation use-case, use these URL parameters:

Bring Your Own Settings

The component is designed as a plug and play experience into your existing settings page. However, if you'd like to manage some or all settings on your side, please contact our dev team for instructions.

Notification Settings

This feature is being refactored into Embedded Notifications

Use the return value of the current setting configuration from onSave to trigger updates to your notification systems.

You're responsible for notifying employees about relevant events from all components using their corresponding onEvent callbacks.

Geolocation Settings

This feature is being refactored into a <GeolocationSettings> component.

Control geolocation restrictions and other associated location features.
This section controls what actions are geolocation-restricted (E.g. clocking in, clocking out, taking breaks) and the maximum allowed distance.
Read more about Geolocation and Geofencing

Geolocation restrictions and maximum allowed distance

Component Properties

Property	Type	Required	Description
`onSave`	`(settings: SettingsData) => void`	No	Callback when settings are saved. Use this to validate and store the details on your side.
`showGlobalTimeTracking`	`boolean`	No	Optionally pass the current value of the top-most 'Time Tracking' toggle setting.
`showNotificationSettings`	`boolean`	No	Should or hide the Notifications section.
`showBreakSettings`	`boolean`	No	Should or hide the Breaks section.
`geolocation`	`boolean`	No	On mobile, should or hide the Geolocation settings section.
`theme`	`Object`	No	UI customization theme to apply.

Theme Elements

Element Name	Type	Properties	Description
`settingsTeamWrapper`	`Container`	`gap`, `backgroundColor`, `padding`	Styles the container for team member listings.
`settingsTeamAvatar`	`Image`	`borderWidth`, `borderColor`, `borderRadius`	Styles the team member avatar images.
`settingsTeamName`	`Text`		Styles the team member name text.
`settingsTeamRole`	`Text`		Styles the team member role/position text.
`settingsTeamSeparator`	`Divider`	`color`, `height`	Styles the separator lines between team members.
`switches`	`Component`	`trackUnchecked`, `trackChecked`, `thumb`	Styles toggle switches throughout settings.
`settingsActionButton`	`Button`	`backgroundColor`, `borderRadius`, `borderWidth`, `borderColor`	Styles action buttons in settings screens.
`breakTypePicker`	`Container`	`backgroundColor`, `borderRadius`, `padding`	Styles the break type selection interface.
`breakTypeName`	`Text`		Styles break type names in settings.

For a comprehensive overview of UI customization options and to learn more about theming across all components, please see our UI Customization Introduction article.

Custom Strings

Custom strings allows you to override any of the texts on the component with your own texts.

String Key	Default Value	Description
`settingsTitle`	"Settings"	Page title.
`settingsTimeTrackingSection`	"Time Tracking"	Time tracking section header.
`settingsTeamSection`	"Team"	Team section header.
`settingsGeolocationSection`	"Geolocation"	Geolocation section header.
`settingsBreaksSection`	"Breaks"	Breaks section header.
`settingsTimeTrackingSubheadline`	"Enable time clock, timesheets..."	Time tracking description.
`settingsTeamSubheadline`	"Choose which team..."	Team section description.
`settingsGeolocationSubheadline`	"Restrict employee actions..."	Geolocation description.
`settingsBottomOverlaySave`	"Save Changes"	Save button text.

💡

In some cases, some settings need to be stored on your platform's side and provided to the Easyteam Provider on initialization. Reach out to the team with your use case to verify all settings you want to use are supported.

Organization Settings Reference

Basic Implementation#

Feature Configuration#

Bring Your Own Settings#

Notification Settings#

Geolocation Settings#

Component Properties#

Theme Elements#

Custom Strings#