Skip to main content

Users, roles and permissions

Users are the people who sign in to the BeepClock app (app.beepclock.com), as opposed to employees who clock in on the recorder. Every user has exactly one role. The role decides what the user may do: which sections they can open and which changes they can make there. Users work with the data of all employees of the organisation, unless the employee portal add-on limits them to some employees.

The role is set in Accounts and roles → User accounts → select a user → Access. Roles themselves are managed in Accounts and roles → Roles.

Roles​

A role is a named set of permissions. Each section of the app has one permission to open it and, where it makes sense, separate permissions for changes. For example, a role with Attendance but without Edit time entries can view attendance but not correct it.

SectionOpen the sectionChanges
AttendanceAttendanceEdit time entries, Manage day notes
ReportsReportsScheduled reports
EmployeesEmployeesAdd employees, Edit employees, Archive and restore employees, Delete employees permanently, Manage custom attributes
DevicesDevicesEdit devices, Synchronize devices
LocationsLocationsManage locations
User accountsUser accountsManage user accounts
RolesRolesManage roles
PaymentsPayments and billing dataPay and edit billing data
SettingsSettingsChange settings
WebhooksWebhooksManage webhooks
Add-onsAdd-onsActivate and deactivate add-ons

Permissions for features that are not enabled for your organisation, such as Locations or Webhooks, are not shown in the role editor.

The built-in Administrator role cannot be edited. It has every permission, including ones added in future versions.

caution

Manage user accounts and Manage roles let a user give access to others, including the Administrator role. Grant them only to people you would trust as administrators.

FAQ​

What changed for the users we already had?
Nothing until you decide. Every existing user received the Administrator role, so they work exactly as before. Create roles and assign them when you want to narrow someone's access.
How do I create a role?
Open 'Roles' in the menu and click 'Add role'. Enter a name and tick the permissions: first the sections the role may open, then the changes it may make in each of them. Save. The role is now available in the Access section of every user.
How do I give a user a role?
Open 'User accounts', select the user and go to the 'Access' section. Choose the 'Role' and click 'Save access'.
Can I limit a user to some employees, for example a shift supervisor to their team?
Not with roles alone: every user works with the data of all employees. Limiting users to their own record or to the employees they supervise is part of the employee portal add-on.
Why can't I change my own role?
Nobody can change their own access, so a user cannot grant themselves more permissions or lock themselves out by mistake. Ask another user with the 'Manage user accounts' permission to do it. For the same reason you cannot edit the permissions of the role you hold yourself.
Why can't I remove the Administrator role from a user or delete them?
At least one user with the Administrator role must always remain. Give the Administrator role to another user first, then change or delete the original one.
Why can't I delete a role?
A role that is assigned to at least one user cannot be deleted. Assign those users a different role first. The 'Users' column on the Roles page shows how many users hold each role.
A user sees 'You do not have permission to view this page'. What now?
Their role does not include the permission to open that section. An administrator can add it to the role in 'Roles', or assign the user a different role in 'User accounts'. If the user can open a section but a change is refused, the role is missing the change permission for it, for example 'Edit time entries'.
I don't see Roles in the menu. Why?
Either your role does not include the 'Roles' permission, or roles have not been enabled for your organisation yet. In the second case write to [email protected].