# How to Share, Transfer or Delete Projects
# Share projects and manage user access
When granting access to workspaces and projects, it is important to set appropriate permissions to your team members to avoid unwanted modifications of projects.
You can follow our Working collaboratively tutorial to see detailed instructions on how to share your project by inviting a user to your workspace as a guest or by sharing a link to your project with your teammates.
# Add users to a workspace
If you want to share all projects in your workspace with a group of users, you can invite them to be a member of a workspace. It is also possible to invite people as guests and share only selected projects with them.
You have to be the admin or owner of the workspace to manage access to the workspace. See Member Roles and Permissions for more details.
To add users to a workspace:
Log into app.merginmaps.com
Select Members from the left panel and click on Add People
In the invite form, enter the email addresses of people you want to invite.
Select if you invite them as members or as guests:
Click on Invite to send an invitation. An email with a link will be sent to the recipients. After they accept the invitation, they will become members or guests of your workspace.
# Add users to a project
Access to a specific project can be also managed in the project's settings. From here, you can also invite users to become guests in the workspace and gain access to this project.
Similarly, you can also update the member's role for this project. For example, you may grant a write access to a member that has only a Reader role in the workspace. Go to Member Roles and Permissions to learn more about this topic.
Log into app.merginmaps.com
Select Projects from the left panel and click on the project you want to manage
Go to Settings. Here you can manage the permissions of users who have access to the project or remove them from the project.
Click on Share
Enter the email addresses of the users you want to invite as guests. Click Next
If you want to modify permissions for a workspace member, enter their Mergin Maps username to the Share with prompt. After clicking Next, they will be added to the Manage Access table in Settings where you can change their permissions to this project.
In the invite form, it is possible to add more projects to share and set the permissions.
Click on Share to send an email with a link to the recipients. After accepting the invitation, they will become a guest in your workspace.
# Send a link to your project
Another method that is suitable for sharing a project with a large number of users is to send them a link to your project, such as sarah/Basic survey/tree (opens new window).
- Log into app.merginmaps.com
- Go to the project you want to share
- Copy the link from your web browser and share it with your colleagues
Once the user requests access, you (or another project owner) can open the project settings and grant them appropriate permissions and accept their request.
# Make your project public/private
Your projects are private by default. If you make it public, everyone can see your data and project history. However, they cannot contribute to your public project unless you grant them the write permission.
- Choose the project you want to make public
- Go to Settings and click on Make public
If you change your mind, you can make your project private by clicking Make private.
# Transfer a project
A Mergin Maps project can be transferred to another workspace. This can be useful when there are personal changes in your team or if you have multiple workspaces and want to manage the storage between them.
Make sure to correctly synchronise all changes from your collaborators and devices. If you fail to do that, their local changes will be lost!
After synchronisation, all collaborators have to remove the project from their devices
Log in to app.merginmaps.com and choose the project you want to transfer
Go to Settings and click on Transfer project
Enter the name of the workspace to which the project should be transferred and click on Request transfer
The owner of the new workspace will be notified and will be able to accept or deny the request through app.merginmaps.com.
The request is valid for 6 days. If the request is not accepted after this period, the project will remain in the original workspace.
If the same team wants to continue contributing to the project, they need to download the transferred project from the new workspace.
# Delete a project
If you want to delete a project, you can do so through app.merginmaps.com or using the Mergin Maps QGIS plugin.
If you want to create a new project with the same name sooner, you can contact email@example.com.
If you reuse the name of a deleted project, make sure to coordinate your team to follow the steps described in How to Deploy Revised Projects.
To avoid synchronisation issues, everyone should delete the old project from all devices and then download the new project.
# Delete a project through merginmaps.com
- Log in app.merginmaps.com and choose the project you want to delete
- Go to Settings and click on Delete project
# Delete a project using the Mergin Maps QGIS plugin
Using the Mergin Maps QGIS plugin, you can delete a Mergin Maps project either locally on your PC or on the Mergin Maps server. To be able to delete the project on the server, you need to first delete the files locally.
In QGIS, go to the Mergin Maps in the Browser panel
Right-click on the project name and select Remove locally. This will remove the project from your PC. The project will be still available on the Mergin Maps server. You will be able to download the project again.
Right-click on the project name again and select Remove from server option. This will remove the Mergin Maps project completely.