> For the complete documentation index, see [llms.txt](https://docs.ess-dive.lbl.gov/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ess-dive.lbl.gov/manage-data/share-data-permissions.md).

# Share Data Permissions

Registered data contributors can share their datasets and data portals with other individuals or teams to collaborate directly on ESS-DIVE.

When you share permissions to a dataset or data portal, you can choose who can **view** private content, **edit**, or **manage** that dataset or data portal.

You can share permissions with **project teams** or any individual who has logged into ESS-DIVE using their ORCID. But only registered data contributors will be able to edit content or manage permissions. &#x20;

![Figure 1: The Sharing Options window is used to select which individuals or teams you'd like to share your dataset with](https://3166205607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgU7GrufgIOpY1Ufd5R%2Fuploads%2FQeyEpdnChvSKzD584AdQ%2FShare%20Options%20-%20save.png?alt=media\&token=21d7dba2-6b67-4c53-8eb3-354ffab3edc8)

## **Why share datasets and data portals?**

There are many reasons you may consider sharing data on ESS-DIVE, some reasons include:

* You need someone to review your dataset before publication
* A project manager needs to have access to both private and public datasets generated by your project
* A team member submitted a dataset to ESS-DIVE using the Dataset API and you need to manage or edit it
* You created a data portal and you need a team member to help contribute to the pages
* A team member started a dataset or data portal but someone else needs to complete it

## Choose who to share permissions with

* Share with specific people
* Share with [Project Teams](https://docs.ess-dive.lbl.gov/manage-data/manage-project-data/project-teams.md)

## **What sharing permissions cannot do**

* **Concurrent editing is not possible**, only the changes made in the latest submission will be retained and it will overwrite all previous edits.
* You cannot see who has access to a dataset or data portal unless you have "manage" permissions.
* There is currently no way to review permissions for more than one dataset or data portal at once. To review dataset permission, you will need to open the Share Options window (Figure 1) on each dataset or portal individually.
* The person who originally created the dataset cannot be removed from the dataset share permissions.

## **Permission Types**

There are three permission types to choose from when sharing your dataset with a registered team member\*:

| Type       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **View**   | <p>This team member can read the dataset when it is private. <strong>They cannot edit or share the dataset.</strong> This team member needs to login to ESS-DIVE. </p><p></p><p>The dataset can be found on the search page when they login to ESS-DIVE.</p>                                                                                                                                                                                                                                                                                                                                                                                     |
| **Edit**   | <p>This <strong>registered\*</strong> team member can read the dataset when it is private, view <a href="https://docs.ess-dive.lbl.gov/publish-data/dataset-and-doi-status-badges.md">status badges</a>, change the dataset metadata, add/remove files, and edit the dataset after it is published. This team member must be a <a href="https://docs.ess-dive.lbl.gov/contributing-data/new-contributor-registration.md">data contributor</a>. </p><p></p><p>The dataset can be found in their "My Data" list.</p>                                                                                                                               |
| **Manage** | <p>This <strong>registered\*</strong> team member has all the same access abilities as an editor. They can also <a href="https://docs.ess-dive.lbl.gov/publish-data/publish-your-dataset/reserve-doi-before-publication.md">reserve a DOI</a>, <a href="https://docs.ess-dive.lbl.gov/publish-data/publish-your-dataset/request-publication.md">request publication</a>, and share or remove people from the dataset permissions. This team member must be a <a href="https://docs.ess-dive.lbl.gov/contributing-data/new-contributor-registration.md">data contributor</a>. </p><p></p><p>The dataset can be found in their "My Data" list.</p> |

***Table 1**: There are three permission types that you can grant to your team members when you share your dataset*

\*this person completed the [New Data Contributor form](https://docs.ess-dive.lbl.gov/contributing-data/new-contributor-registration.md) and was approved to edit and submit metadata to ESS-DIVE

{% hint style="info" %}
The person who originally created the dataset will always have access to the dataset
{% endhint %}

## Notify Collaborators

Co-authors do not automatically receive access to your private dataset. ESS-DIVE cannot create accounts for co-authors, so they must log in to ESS-DIVE on their own. Additionally, datasets cannot be shared with someone until they have logged into ESS-DIVE. Once you share your dataset with someone, they will not be automatically notified.

Email your co-authors to notify them that you created a private dataset.

### Email Templates

Here are recommended email templates you can use to notify your co-authors that you have or would like to share your dataset with them, including instructions for co-authors that need to log in or register before you can share it with them:&#x20;

<details>

<summary>Ask your collaborators to log in and / or register</summary>

{% hint style="info" %}
Replace the placeholder text contained within <>
{% endhint %}

**Collaborators with view access:**&#x20;

> Hi,
>
> I have started the following private dataset submission on ESS-DIVE and have listed you as a co-author.&#x20;
>
> To give you access to view the dataset, please log in to [ESS-DIVE](https://data.ess-dive.lbl.gov/) with your ORCiD and let me know once you’ve done so. I will then share the dataset with you and the link below will activate.
>
> \<Paste your private dataset citation here>

**Collaborators with edit or manage access:**

> Hi,
>
> I have started the following private dataset submission on ESS-DIVE and have listed you as a co-author.&#x20;
>
> To give you access to the dataset, please log in to [ESS-DIVE](https://data.ess-dive.lbl.gov/) with your ORCiD and let me know once you've done so. I will then share the dataset with you and the link below will activate.&#x20;
>
> To start editing the dataset, you must [register as an ESS-DIVE data contributor](https://docs.ess-dive.lbl.gov/contributing-data/new-contributor-registration) first.
>
> \<Paste your private dataset citation here>

</details>

<details>

<summary>Notify collaborators that a dataset has been shared with them</summary>

{% hint style="info" %}
Replace the placeholder text contained within <>
{% endhint %}

> Hi,&#x20;
>
> I have started the following private dataset submission on ESS-DIVE and have listed you as a co-author. You now have access to \<view / edit> this dataset. Please confirm that your name, affiliation, contact email, and ORCID are correct.
>
> Let me know if you have any questions or concerns.
>
> \<Paste your private dataset citation here>

</details>

## Find Datasets Shared with Me

When someone grants you permission to **edit** or **manage** a dataset, you can find that dataset in your “My Data” settings. Only registered data contributor will be able to edit or manage datasets.&#x20;

Click on your profile in the top right corner and select “My Data Packages” from the dropdown menu (Figure 2). This will automatically filter the data search page by datasets that you (a) created yourself, (b) have permission to edit, and (c) have permission to manage. You can then use the search filters to locate the shared dataset you are looking for (Figure 3).

If you were granted permission to **view** a dataset, this dataset **will not** be on your "My Data Packages" page. You can find these datasets by using the [search filters](https://docs.ess-dive.lbl.gov/searching-and-accessing-data/data-access.md#data-search-tools) on the data search page (<https://data.ess-dive.lbl.gov/data>). We recommend searching by project title, the dataset creator name, or the dataset title.

![Figure 2: Select “My Data Packages” from the dropdown menu](https://3166205607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgU7GrufgIOpY1Ufd5R%2Fuploads%2FHtu21O7TspCNwMbtuTQC%2Fmy-data-packages-dropdown.png?alt=media\&token=a0175fc2-afb9-42c6-ac75-8702191aeef1)

![Figure 3: The "My Data Packages" dropdown will automatically apply a filter to the data search page](https://3166205607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgU7GrufgIOpY1Ufd5R%2Fuploads%2FFMiID55RHxJZGwsYAlKT%2Fcreator-me-search.png?alt=media\&token=659634d3-e254-4668-8a53-9fbd4226e0f9)
