Guest users
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
Users assigned the Guest role have limited access and capabilities compared to other user roles. Their permissions are restricted and are designed to provide basic visibility and interaction without compromising sensitive project data. For more information, see Roles and permissions.
In GitLab Free and Premium, Guest users count towards the license seat usage.
Unlimited seat usage
- Tier: Ultimate
In GitLab Ultimate, users with the Guest role do not count towards the license seat usage. You can add Guest users to your GitLab instance without impacting your billable seats.
While Guest users generally have limited access, you can configure a custom role that includes the View repository code
permission to allow Guests to read code in your repositories. Adding any other permissions causes the role to occupy a billable seat.
Assign Guest role to users
Prerequisites:
- You must have at least the Maintainer role.
You can assign the Guest role to a current member of a group or project, or assign this role when creating a new member. You can do this through the API or the GitLab UI.
To assign the Guest role to a current group or project member:
- On the left sidebar, select Search or go to and find your project or group.
- Select Manage > Members.
- In the Role column of the group or project member you want to assign the Guest role to, select their current role (for example, Developer).
- In the Role details drawer, change the Role to Guest.
- Select Update role.
If the user you want to assign the Guest role to is not yet a member of the project or group:
- On the left sidebar, select Search or go to and find your project or group.
- Select Manage > Members.
- Select Invite members.
- In Username, name or email address, select the relevant user.
- In Select a role, select Guest.
- Optional. In Access expiration date, enter a date.
- Select Invite.
Guest user permissions and restrictions
Users with the Guest role can:
- View project plans, blockers, and progress indicators.
- View high-level project information such as:
- Analytics
- Incident reports
- Issues and epics
- Licenses
- Create and link new project work items.
- Access public groups and public projects.
Users with the Guest role cannot:
- Modify existing data that they have not created.
- View code in GitLab projects by default.
- Create projects, groups, and snippets in their personal namespaces.
- Access internal or private projects or groups without administrator access.
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support