# Member Roles and Permissions

Permissions control access to your Mergin Maps projects. They can be defined for the whole workspace when inviting workspace members or for a specific project.

# Workspace members and guests

People invited to a workspace can be invited as members or as guests.

Members have access to all projects in a workspace. If a new project is created, they will be able to access it immediately.

Guests have access only to projects they are invited to. If a new project is created in a workspace, they won't see it until they are granted access.

TIP

Do you want to invite members or guests to your workspace? Visit How to share projects and manage user access for detailed steps.

# Workspace member roles

Members of a workspace have access to all projects in a workspace. The level of access to the project is defined by their member roles:

  • Reader: users with read permission are able to see the list of projects, projects data and history
  • Writer: in addition to the Read access, users can also do changes in the projects: adding/removing/updating features, change layer settings and project properties. Users who are expected to actively contribute to the project need to have the write permission.
  • Admin: in addition to the Write access, users with this level of access can delete the project or transfer it to another workspace. Admins can also create new projects and manage workspace members.
  • Owner: in addition to the Admin permission, owners have access to invoicing and subscription settings.
Reader Writer Admin Owner
see the list of projects in the workspace
see project data
see project history
add/edit/delete features in projects 🚫
add/remove layers in projects 🚫
change layer settings and project properties in QGIS 🚫
create new projects 🚫 🚫
delete and transfer projects 🚫 🚫
manage access to projects 🚫 🚫
manage workspace members 🚫 🚫
access to invoicing and subscription settings 🚫 🚫 🚫

Members and their roles can be managed through app.merginmaps.com in the Members tab:
Mergin Maps web members tab

# Project permissions

Permissions to specific projects can be defined for workspace guests as well as for workspace members in addition to their member roles. There are three permission levels: reader, writer and owner.

Reader Writer Owner
see the project in the workspace
see project data
see project history
add/edit/delete features in the project 🚫
add/remove layers in the project 🚫
change layer settings and project properties in QGIS 🚫
delete and transfer projects 🚫 🚫
manage access to the project 🚫 🚫

Although the roles of workspace members define the level of access to projects in a workspace in general, it is possible to grant them higher permissions to specific projects. For instance, a workspace member with a Reader role can be a Writer or Owner of a project.

TIP

How to add users to a project will guide you through inviting a guest to a project. These steps can be also followed to change workspace member's permission to a project.

Project permissions are managed in project Settings when logged in to app.merginmaps.com. From here, you can invite a guest to contribute to your project or
Mergin Maps web project settings

# Public and private projects

A private project is a project that is accessible only to workspace members and to guests that were invited to this project. Projects are private by default.

A public project is a project that everyone (including those who are not registered with Mergin Maps) can see, including data and project history. Other users cannot contribute to your public project unless you give them writing permissions.

TIP

You can make your project public or private in the project's settings.