Workgroups
A workgroup is a named list of people. Share a lab or a template with the workgroup once, and everyone in it gets access — including people you add later.
Unlike an organization, a workgroup owns nothing. It is purely an audience for sharing. Anyone can create one, and a person can belong to as many as they like.
Create a workgroup
- Go to Instances → Workgroups.
- Select New workgroup and give it a name.
- Open its settings and add people on the Members tab with the Name or username box, as Member or Admin.
The New workgroup dialog has three fields:
| Field | Rules |
|---|---|
| Name | 1–60 characters |
| Handle | 3–30 characters of lowercase a–z, 0–9, _ and -. It must not be taken by another workgroup. People see it as @handle when they share |
| Description | Optional, up to 300 characters |
Select Create workgroup. You become its owner, and its page opens.
The workgroup's page and settings
A workgroup's page has Instances, Templates and Activity tabs — the labs and templates shared with it, and a record of changes. Its settings dialog has four tabs:
| Tab | What is on it | Who can change it |
|---|---|---|
| General | Workgroup name, Description, the handle and owner. The owner also sees the Danger zone | Owner and admins; only the owner deletes |
| Members | Everyone in it and their role; the box for adding people | Owner and admins |
| Sharing defaults | The default roles described below | Owner only |
| Shared resources | Every template and running lab shared with the workgroup, who shared it and the role, with an Open button | Nobody — it is a list |
Everyone in the workgroup can open the settings; the fields are grayed out for people who cannot change them.
Sharing defaults
When something is shared with the workgroup, each member gets a role. The workgroup's Sharing defaults tab sets what that role is by default:
| Setting | Options |
|---|---|
| Default role for shared templates | Viewer — can see it, nothing more · Deployer — can deploy their own copies · Editor — can edit files and builds |
| Default role for shared running labs | Viewer — read-only dashboard · Operator — start, stop and redeploy |
| Shares apply to | Every member, or Owner and admins only |
The person sharing can still pick a different role in the Share… dialog.
By default, templates are shared as Deployer, running labs as Viewer, and shares apply to Every member. Only the workgroup's owner can change these. Changing a default never changes shares that already exist.
Share with the workgroup
Open the lab or template, select Share…, and pick the workgroup instead of a person.
- Templates: see Sharing and publishing.
- Running labs: see Sharing and workgroups.
Sharing needs a paid plan or enough Zeal — the dialog tells you if you are not there yet. See Zeal and Jolt.
Leave or delete
- Any member can Leave this workgroup from its settings.
- The owner and admins can Remove from workgroup on a member's row.
- The owner can delete the workgroup from the Danger zone. Deleting removes the workgroup and every grant made to it. Members keep their own resources. You are asked to confirm with Delete workgroup; it cannot be undone.
- The owner cannot be removed and cannot leave.
Next steps
- Organizations & teams — when a group needs its own labs and limits
- Sharing and workgroups