Support

Users, roles and permissions

For: Workspace admins

Who can do what in OneShift comes from the role each person has in your workspace. This article shows how to invite people and assign roles, what the five permissions unlock, how team leads differ, and what happens when someone leaves.

01

How access works

Two things decide what a person can do: the permissions their role carries, and whether they lead a team.

  • Roles and permissions come from WorkOS. OneShift signs people in through WorkOS. Each person has a role in your workspace, and the role carries zero or more of the five permissions. OneShift reads the role and its permissions from WorkOS; it does not keep a separate list of its own.
  • Team lead comes from OneShift. It is set on a team, not on the role. SeeTeam lead is not a permission.
  • Every other person is a member. They can open the Dashboard and Timesheets and work with their own time. Nothing else shows in their menu.

A permission can only be given to someone if it exists in your WorkOS environment and has been added to the role. branding:manage andhr:manage in particular are new permissions that must be created and added to the roles that should have them. Until then nobody sees what they unlock.

02

Invite people and assign roles

You manage people and roles on the Access & Roles tab of the Team page. It needs the workspace:manage permission.

  1. Open Team in the side menu under MANAGE.
  2. Choose the Access & Roles tab.
  3. Use the panel that appears to invite people and to choose each person’s role. That panel is WorkOS’s own user management, shown inside OneShift. What it offers and how it looks is up to WorkOS, so this article does not describe its screens.
  4. Wait a few minutes. OneShift checks WorkOS for changes every 5 minutes. A person with a valid role then shows up on the Users tab. Changes to someone’s role or permissions arrive the same way.

If a role is removed from your WorkOS roles while people still hold it, OneShift cannot match it and marks those members inactive. Move them to another role first.

The Team page has four tabs: Teams, Users, Positions and Access & Roles. People with only the HR permission see Users alone. See The five permissions.

03

The five permissions

Each permission is a separate grant. None includes another, so give people exactly the ones they need.

PermissionWhat it unlocks
workspace:manageProjects, Customers, Workspace settings and the Audit log. On the Team page, the Teams, Positions and Access & Roles tabs as well as Users. Member Settings. The Issues report. Together with billing:manage, the Billing → Rates page.
timesheets:manageApprovals: approve or reject any submitted timesheet, your own included. The Timesheets and Detailed reports.
billing:manageStatements and the Customer report. Together with workspace:manage, the Billing → Rates page.
branding:manageBranding: the workspace email signature and the public profile template. workspace:manage does not include it.
hr:manageTeam → Users and each member’s Member Settings page, where every field can be edited. An HR manager can assign an existing position but not create, rename or delete one, and sees none of the other Team tabs.

How the approval permission and team leads work together is in theBilling guide. What Branding contains is in theWorkspace guide.

04

Team lead is not a permission

A team lead is someone with the role Lead in at least one team. It is a team membership. It is not a permission and it does not appear in WorkOS.

  1. Open Team → Teams and click the team’s name.
  2. In the members list, change the person’s Role from Member to Lead. A “Member role updated” message confirms it.

A team lead sees Approvals and the Timesheets and Detailed reports in the menu, without any permission. A lead can approve and reject the submitted timesheets of the other members of their teams. They cannot approve their own timesheet or the timesheet of another team lead: OneShift answers “You cannot approve your own timesheet.” and “You cannot approve another team lead’s timesheet.” Only a person with timesheets:manage can approve those. The details are inTimesheet approval.

Creating teams, adding members and choosing leads is covered inTeams, positions and member settings.

05

What each permission shows

The side menu shows only what the signed-in person may open. This is the full list.

Menu itemShown to
Dashboard, TimesheetsEveryone.
Approvalstimesheets:manage, or a team lead.
ACCOUNTING → Statementsbilling:manage.
ACCOUNTING → Ratesbilling:manage and workspace:manage together.
ACCOUNTING → Reports → Customerbilling:manage.
ACCOUNTING → Reports → Timesheets and Detailedtimesheets:manage, or a team lead.
ACCOUNTING → Reports → Issuesworkspace:manage.
MANAGE → Projects, Customersworkspace:manage.
MANAGE → Teamworkspace:manage or hr:manage. HR managers get the Users tab only.
MANAGE → Workspaceworkspace:manage.
MANAGE → Brandingbranding:manage.
MANAGE → Audit logworkspace:manage.

The ACCOUNTING heading appears when the person has billing:manage,timesheets:manage or workspace:manage, or leads a team. The MANAGE heading appears with workspace:manage,hr:manage or branding:manage.

The menu only hides what a person cannot use. The permission is checked again on the server, so opening a page by its address does not get around it.

06

Deactivate and remove members

You end someone’s access in WorkOS. OneShift then marks their member inactive; it does not delete anything.

  1. On Team → Access & Roles, remove the person from the workspace using the WorkOS panel.
  2. Wait a few minutes for the 5-minute sync. The person’s member in OneShift becomes inactive.
  3. If they should not be measured against future days, also set an end date on their Member Settings. See Working period.

What the sync does

In WorkOSIn OneShift
The person’s membership of your workspace is removedTheir member in your workspace becomes inactive.
The person’s WorkOS user is deletedTheir members in every workspace they belonged to become inactive.
Their role is not one of your workspace’s rolesTheir member becomes inactive.
A membership is created or its role changes to a valid roleThe member is created or updated with the new role and permissions, and is active.

An inactive member cannot be added to a team (“Cannot add an inactive member to a team.”) and their public profile page is hidden. A person you add again with a valid role becomes active again.

Show inactive

On Team → Users, the Show inactive switch swaps the list. Switched on, it lists only the inactive members, with their names struck through. Switched off, it lists only the active ones. It never shows both together. Click a name to open that member’s Member Settings.

An end date and the inactive status are separate. The end date stops time being logged after a day you choose; the inactive status follows WorkOS. OneShift never changes one because of the other.