Users, roles and permissions
This page explains who can sign in to SmartLIMS and what each person may see and do. Roles bundle permissions, and every user has one role.
Who this is for: Laboratory owners and administrators · You need: the "Manage users" permission for users, and "Manage roles" for roles
The idea in short
- A user is a person who can sign in. Users belong to your company.
- A permission allows one kind of work, for example "Manage requests" or "Verify work order tasks".
- A role is a named bundle of permissions, for example "Receptionist". Each user has exactly one role.
- Departments are a separate layer. A permission says what kind of work someone may do; department membership says which work orders they may work on. See Company, laboratories and departments.
Every new company starts with two roles you can see:
| Role | What it has |
|---|---|
| Owner | All permissions at setup. It is the default role and can't be deleted. |
| Member | Manage requests, Manage work orders, Manage messages and See invoices from Financial on requests. |
Role names you create show exactly as you type them. Owner and Member show in English in both languages.
Where accounts come from
Most accounts come from the SmartLabSys platform, the shared account hub that signs you in to all SmartLabSys apps:
- A person added to your company on the platform can sign in to SmartLIMS with their platform account. Their LIMS account is created automatically.
- The platform role owner becomes the LIMS role Owner. The platform role member becomes Member for a new user.
- If you give someone a custom role in LIMS, it is kept. A later change on the platform to "member" only moves an Owner down to Member; it does not overwrite a custom role.
- Removing a person on the platform deactivates them in LIMS. Their history (results, verifications, messages) stays.
- The name of a platform account is kept on the platform. In LIMS it is read-only, and you change it in your platform profile. An organization owner or admin can allow a member to change their name in the apps (Allow name change in apps on the platform's Members page). The person can then change it on their user details page, and a user admin can change it on the Users list. The new name goes to the platform and to the person's other apps.
You can also invite a person directly in LIMS (see below). See Signing in for how people sign in.
How to invite a user
- Open Settings and click the Users tile (People who can sign in).
- Click Invite user.
- Enter First name, Last name, Email and a Password, and choose a Role.
- Click Save changes.
- Give the person their email and password through a safe channel.
An email address can belong to only one account, across all companies in SmartLIMS.
How to change or deactivate a user
- On the Users page, click the person's row (or Edit in the row's ⋯ menu).
- Change First name, Last name or Role, or untick Active to stop them signing in.
- Click Save changes.
To switch someone off without opening the form, use Deactivate (or Reactivate) in the row's ⋯ menu. The email can't be changed here. A deactivated user keeps their history; nothing they did is deleted. You can't deactivate your own account; your row is marked You.
The list shows each person's Name with their email underneath, their Role, the Departments they lead or belong to (the first two, then "+N"; hover it for the rest), their Status and when they Joined. The header counts the people in your company, the active ones, and your roles. Search looks in names and email and ignores upper and lower case and accents; you can also filter by Role and Status, and switch between a table and cards with the view settings button. A greyed-out "System Notifications" user, marked System, is the system's own sender of automatic messages. It can't be edited.
📷 Screenshot: the Users page with the Invite user dialog open
How to set a user's password
If someone has forgotten their password, open the row's ⋯ menu and choose Set password. Type a new password of at least 8 characters and tell the person what it is through a safe channel; no email is sent. They are signed out everywhere and sign in with the new password.
Someone who signs in with SmartLabSys has no Set password item: their password belongs to their SmartLabSys account. They can use "Forgot password" on the SmartLabSys sign-in page, or a platform admin can set it or send them a reset link.
How to choose which laboratories someone works in
A person who works in one or more laboratories sees only those laboratories' forms on New request, and can register requests only for them. A person in no laboratory sees every form; that is how every account starts.
- For one person: on the Users page, open the row's ⋯ menu and choose User details. Pick their laboratories under Laboratories, and click Save changes.
- For a whole laboratory: on the Laboratories page, open the laboratory and pick its people under Users. Click Save changes.
You need the "Manage users" permission for the first and "Manage laboratories" for the second. This only changes which forms are offered on New request. Requests that already exist stay open to everyone who could open them before.
How to create a role
- Open Settings and click the Roles tile (What each role may see and do).
- Click New role.
- Enter a Name and tick the permissions the role should have. They are grouped by area (see Permissions), each with a line saying what it allows; All next to an area ticks or clears the whole area.
- Click Save changes.
- Assign the role to users on the Users page.
The Roles page shows each role as a card: how many of the permissions it has, the faces of the people who have it, and one bar per area saying how much of that area it covers (hover a bar to see which permissions). Use the view settings button at the left of the search box to switch to a table.
To change a role, click its card (or Edit in its ⋯ menu). The change applies to everyone with that role. Duplicate opens a new role with the same permissions, to start a similar one from. A role still assigned to users can't be deleted; move the users to another role first. The default role (marked Default) can't be deleted either. Roles marked SmartLabSys stand for the platform's roles (see Where accounts come from); you can still change their permissions.
📷 Screenshot: the New role dialog with permissions ticked
Permissions
Permissions are grouped here the way the Settings page groups the work.
| Area | Permission (as shown on screen) | What it allows |
|---|---|---|
| Organization | Manage company profile | Edit company details and tracking number formats. |
| Manage users | Invite, edit and deactivate users. | |
| Manage roles | Create and change roles. | |
| Manage laboratories | Add and edit laboratories. | |
| Manage departments | Add and edit departments and their members. | |
| Lab setup | Manage products | Edit products. |
| Manage parameters | Edit parameters and import them from Excel. | |
| Manage groups of parameters | Edit groups of parameters. | |
| Forms and reports | Manage forms | Edit request forms. |
| Manage predefined fields | Edit fields reused across forms. | |
| Manage report templates | Edit how reports are laid out. | |
| Translate reports | Translate what prints on reports, set the report languages and change the report wording. See Translations. | |
| Regulatory | Manage product catalog / Manage parameter catalog | Edit the shared catalogs. |
| Manage regulatory frameworks | Edit rulebooks and limits and import limits. | |
| Daily work | Manage requests | Create and edit requests. |
| Unlock sent requests | Open a sent request again to correct it; the reason is kept in its history. See Sent and locked. | |
| Manage customers / Manage inspectors | Edit customers and inspectors. | |
| Manage work orders | Create work orders, assign work and enter results. | |
| Verify work order tasks | Verify results (the second-level review). | |
| Confirm work order tasks | Confirm results (the final review). | |
| Manage messages | Post messages and subscribe to them. | |
| Integrations and billing | Manage QC (SmartQC) integration | Set up SmartQC and work with QC requests. |
| Send work to other laboratories (subcontracting) | Send work to another laboratory through SmartQC and import its results. See Subcontracting. | |
| See invoices from Financial on requests | See the invoice Financial sends back, on a request. Works together with Manage requests. |
Verification is the second-level review of results, and confirmation is the final one. See the Glossary.
What someone without a permission sees
- Sidebar: items the user can't use stay visible but greyed out, with the tooltip "You don't have access to this". This applies to Requests, Work Orders, Verification, Confirmation, Customers and Inspectors. Work Orders opens with any of Manage, Verify or Confirm work order tasks.
- QC Requests appears only for users with the QC permission, and only when an integration is set up.
- Test reports opens with the "Manage requests" permission, like Requests.
- Settings: tiles the user may not open are hidden, not greyed. If no tile is allowed, the Settings link itself is hidden.
What permissions don't do
- Entering results needs "Manage work orders" and membership of the panel's department (or being assigned the work). See Company, laboratories and departments.
- No four-eyes rule is enforced. Someone with both permissions can enter, verify and confirm the same result. SmartLIMS records who did each step, so you can check it later, but it doesn't stop it. If your quality system needs separate people, set up roles so that no one has all three, or check it in review.
A suggested role setup
This is a suggestion only. Adapt it to how your lab works.
| Role | Permissions |
|---|---|
| Receptionist | Manage requests, Manage customers, Manage inspectors, Manage messages |
| Analyst | Manage work orders, Manage messages (plus department membership) |
| Head of department (verifier) | Manage work orders, Verify work order tasks, Manage messages |
| Quality manager (confirmer) | Confirm work order tasks, Manage messages, and the Lab setup and Forms and reports permissions if they maintain methods and templates |
| Owner | Everything (the built-in Owner role) |
Add "See invoices from Financial on requests" to anyone who needs to see billing on requests, and the Regulatory permissions to whoever maintains limits.
Your profile photo
Open My details from your user menu and, under Profile photo, click Upload photo (PNG, JPG or WebP, up to 2 MB). It is cropped to a square from the centre and shows, round, in the sidebar from the next page you open; Remove brings your initials back. Whoever manages users can set or remove anyone's.
If your company is connected to Academy, a coloured ring around your photo shows the badges you hold: one colour for each badge, certifications first. The more badges, the more colours.
Your signature and stamp
What prints where someone signs a test report comes from their user details: their degree after the name, on the same line ("Andrijana Petrović, mast. biol"), their specialisation and position under the name, one printed line per line you type (a specialisation, then a position), their signature over the line and their stamp beside it.
- Open your user menu (your name, bottom of the sidebar) and click My details. Whoever manages users can open anyone's from the Users list: ⋯ → User details.
- Type the Degree and Specialisation and position and click Save changes.
- Under Signature and Stamp, click Upload signature / Upload stamp and choose the image. It is saved at once. A PNG with a transparent background, scanned at 300 dpi or more, prints best (up to 2 MB).
The images are not public files: only signed-in people of your company can see them. Reports issued before you change or remove an image keep the one they were issued with. See How to approve and issue a report.
AI keys
AI features such as machine translation run on an API key from an AI vendor: Anthropic (Claude), OpenAI (ChatGPT) or Google (Gemini). LIMS uses the first key that is set:
- your own key, from My details;
- the company's key, set by a company admin on the company page — so one key can cover everyone;
- the server's key, if the laboratory's server has one.
With none of them, AI features are off for you.
To set a key (your own on My details, or the company's on the company page under AI key):
- Create an API key with the vendor: console.anthropic.com, platform.openai.com or aistudio.google.com. This is pay-as-you-go API billing, separate from a Claude.ai, ChatGPT or Gemini subscription.
- Choose the Vendor, paste the key and click Save key. Leave Model empty for the vendor's default, or type a model name the vendor offers. LIMS checks the key and the model with the vendor first and stores the key encrypted.
- To stop using it, click Remove key; LIMS falls back to the next key in line.
A company admin can also tick Personal keys off — everyone uses the company key under the company's AI key. People's own keys are then ignored (they stay saved, and each person can still remove theirs) and no new ones can be saved, so every AI call is billed to the company's key, or the server's if the company has none. Untick it to allow personal keys again.
Only the last four characters of a key are ever shown again. Your own key is yours alone: whoever manages users cannot see or change it.
Rules
| Rule | What happens |
|---|---|
| One role per user | To combine permissions, create a role that has all of them. |
| Role still assigned to users | It can't be deleted. |
| Default role (Owner) | It can't be deleted. |
| Same email in two companies | Not allowed. Each email belongs to one account. |
| User removed on the platform | Deactivated in LIMS; history stays. |
| Name of a platform account | Changed in the platform profile, unless the organization allows changing it in the apps. |
Tips
- Keep at least two people with the Owner role, so the lab is never locked out of Settings.
- Deactivate people who leave instead of trying to remove them. Their name stays on the work they did, which the audit trail needs.
- After changing a role, ask an affected user to reload the page to see the new sidebar.