> For the complete documentation index, see [llms.txt](https://help.basespace.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.basespace.illumina.com/collaborate/share-with-collaborators/share-by-email.md).

# Share by Email Invitation

Use the Send Invitation option to invite a collaborator to share a project or run, and to manage collaborator access to shared resources. The shared project or run is visible to the collaborator when they are logged in to their account.

Use this option when you want greater control over who can view your data. For information about using a unique URL that can be used to invite a large group of people, see Share by Link.

When you share a project with a collaborator, the collaborator is granted read-only access to related biosamples, libraries, analyses, and data sets. You can optionally allow write access to the project, which allows collaborators to launch apps that write to the shared project.

When you share a run, related entities are not shared, however the names of entities might be visible in run details.

## Send an Invitation

1. Select a project or run.
2. Select the Share icon, then select Send Invitation.

   ![The Share menu on the Projects page, showing Get Link, Send Invitation, and Transfer](https://330234082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg3bE5PSqw4Kkyc9yUsgB%2Fuploads%2Fgit-blob-5f47e8f11d13e5406a676847b62e6da503a54bb5%2Ftransfer-ownership-share-menu.png?alt=media)
3. Enter the email address for the collaborator.
4. \[Optional] If you are sharing a run and want to share run data only, clear the Share Associated Project checkbox.
5. Select Add Collaborator.
6. \[Optional] If you are sharing a project, select the access level.
   * Read Only—The collaborator can view data.
   * Write—The collaborator can launch apps that write to the project.
7. Select Save Settings.

## Change or Revoke Collaborator Access

You can review the list of collaborators, change the access level for a project, or revoke access to a run or project.

1. Select the shared project or run.
2. Select the Share icon, and then select Send Invitation.
3. In the Collaborator Settings section of the Share dialog, change or revoke collaborator access.
4. Select Save Settings.

{% hint style="info" %}
The collaborator list uses the email address of the user for a personal context, or of the workgroup owner for a workgroup context. Because users can accept shares on behalf of workgroups, the listed collaborator might not be the same as the user who received the invitation to share.
{% endhint %}

{% hint style="info" %}
Runs and projects have separate permissions. When you change access to a project, access to shared runs is not automatically changed.
{% endhint %}
