User groups
Use User groups to organize accounts into instance-wide tiers. Each group carries a role that sets the default access its members have across the instance, so putting someone in a group is a quick way to grant a baseline level of permission. You can create your own groups, edit their settings, and move people in and out of them. Three built-in groups — Anonymous, General, and Admin — ship with the instance and cannot be deleted.
Where to find it
- URL:
gitvetrix.com/admin/user-groups - Navigation: Open your avatar menu, select Admin panel, then choose User Groups under Access & Security.
The list shows every group with its Name, Slug, Role, and member count under Members. Built-in groups show a lock icon next to their name and have no delete control.
Roles
Every group has a role that its members receive by default. When you pick a role, the dropdown shows a short description of what it grants. The roles, from broadest access to narrowest, are:
- Instance admin — full access to every resource on the instance.
- Org owner — manages an organization and all of its repositories.
- Org member — may create repositories and manage their own resources.
- Repo admin — manages repository settings, protection rules, and webhooks.
- Repo write — may push code, manage issues, and complete merges.
- Repo read — may browse code, view issues, and clone repositories.
- Custom — a hand-picked permission set, chosen in the custom role builder.
Create a group
- Select New group in the top-right. A dialog with the group form opens. To use a bookmarkable page instead, select the full-page form link in the dialog, or go to
gitvetrix.com/admin/user-groups/new. - Enter a Name. This is required.
- A Slug is filled in for you from the name. You can edit it; it may contain only lowercase letters, digits, and hyphens. Leave it blank to let the instance derive one.
- Optionally enter a Description.
- In Role, choose the role members of this group receive.
- Select Create group. From the dialog, the group is created and you return to the list, where the new group appears; from the full-page form, you land on the new group's page, where you can add members. To close without creating anything, select Cancel.
Edit a group's settings
- Select a group's name, or Edit on its row, to open its page.
- In the Group settings panel, change the Name, Slug, Description, or Role. Changes save automatically when you leave a field or pick a new role.
- On built-in groups the Slug is fixed and cannot be edited.
If you raise a group's Role to the instance-admin level, a confirmation dialog asks you to type the group's slug to confirm, because every member of the group would gain full access to the instance.
Add and remove members
Open a group and use the Members panel:
- Under Add a member, type at least two characters of a username or email. Matching accounts appear.
- Select Add next to the person you want. They join the group. Adding someone to the built-in Admin group prompts an extra confirmation, because it grants them administrator access.
- To find existing members, type in the member search box.
- To take someone out, select the remove (trash) button on their row, labeled Remove <username>. They are reassigned to the General tier.
For a larger view, select View all members to open the full-page member list. It shows 100 members per page and has an Export current page CSV button that downloads the members currently on screen.
The Anonymous group has no member list. It represents everyone who is not signed in, so its page shows an explanatory note instead of members. Changing its role affects what logged-out visitors can see.
Delete a group
- Open a group you created and find the Danger zone section. Built-in groups have no delete control.
- Select Delete group.
- In the confirmation dialog, type the group's name exactly. The confirm button stays disabled until it matches.
- Select Delete user group <name>. The group's members are reassigned to the General tier, and the slug becomes available for reuse.