# Sharing a Project

You can collaborate in BlackDiamond Studio by sharing your projects with other users. They will get a project invite and will see their shared projects on the [project list](/blackdiamond-studio-or-mobilize.net/blackdiamond-studio-documentation/bds-portal/projects-list.md). To share projects, follow these steps:

1. &#x20;**From the project list:**
   1. Hover the project card. \
      ![](/files/YmatM5yjF9J0tpEr2tCK)
   2. Click on the **menu** button. \
      ![](/files/GmoFhe7RyUr9AK5kjzev)
   3. Click on the **Share Project** option.

      ![](/files/FnW04cJQOu0sWAOPgVXo)<br>
2. If you are on the **project home page**, click on the **Share** button.&#x20;

![](/files/KFaaPbq1m4um1S9W3aiP)

&#x20;3\. Add members by email address and press the enter key.&#x20;

![](/files/gchlX6ir6m1tHGC9DT1U)

&#x20;4\.  Choose their role. **Members** can edit the project, connect to the existing database connection, open the repository, open and work in the IDE, and edit the conversion settings. **Admins** do the same as members plus: invite users, assign other project admins, remove users, and delete projects.&#x20;

![](/files/VXtblwu6nCsatvInru2N)

5\.  Click **Invite.**

![](/files/q7j4y244rBIDBqRwxKNZ)

6\.  You should get a confirmation alert that says, “Invite sent.”&#x20;

![](/files/T6vFPsYydAb8sDL2St8t)

7\.  When you are inviting users to a project with an external repository there is a chance that they are not authenticated yet in the repository provider in BlackDiamond Studio. This prevents the portal from inviting them automatically to the repository. If you get the following alert, please make sure you invite these users manually to your external repository. &#x20;

![](/files/pi9QV4MkPCdnwX670gca)

8\.  The invitees will receive an invite email with a link to the project. If they are not users of BlackDiamond Studio yet, they will have to [sign up.](/blackdiamond-studio-or-mobilize.net/blackdiamond-studio-documentation/bds-portal/sign-up.md)&#x20;

![](/files/gatbrr9HqCGlgziVV00M)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gapvelocity.ai/blackdiamond-studio-or-mobilize.net/blackdiamond-studio-documentation/bds-portal/sharing-a-project.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
