# Share Data Permissions

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)

## **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="../publish-data/dataset-and-doi-status-badges">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="../contributing-data/new-contributor-registration">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="../publish-data/publish-your-dataset/reserve-doi-before-publication">reserve a DOI</a>, <a href="../publish-data/publish-your-dataset/request-publication">request publication</a>, and share or remove people from the dataset permissions. This team member must be a <a href="../contributing-data/new-contributor-registration">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) 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 %}

## 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#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)
