> 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/share-datasets.md).

# Share Datasets

To share a dataset on ESS-DIVE means that you have given or received permission to **view, edit, or manage** a dataset. Dataset permissions can be changed at any time. 

Sharing a dataset with other people registered to contribute data on ESS-DIVE will allow them to: 

* view private datasets, 
* view status badges,
* change metadata, 
* add/remove files, 
* reserve a DOI,
* publish the dataset, and 
* share the dataset with others

See the [Permission Types](/manage-data/share-data-permissions.md#permission-types) section for details on which access level grants each capability.

## How to Share a Dataset

{% hint style="warning" %}
You must be the dataset creator or have **manage** access to share datasets
{% endhint %}

1. On the dataset landing page, select the **Edit** button (Figure 1).
2. Select the **Share** button in the top right corner of the file table (Figure 2).
3. A new window will appear titled **Sharing Options** (Figure 3) which shows you who already has access to the dataset and what permission type they have. By default the dataset creator has manage permissions.
4. **Share the dataset** with new people by searching for their ORCID, first or last names in the search bar\* (Figure 4). Or look up the **project team** name to share with a group.
   * *\*Only people who have logged into ESS-DIVE using their ORCID can be found in the Sharing Options search bar*
5. **Modify the permission type** as needed using the access level dropdown (Figure 5).
6. Review your changes and hit **Save** (Figure 6)**.**
7. When you have finished sharing your dataset, you can exit the edit session. **It is not necessary to hit the Submit Dataset button**. 

<figure><img src="/files/lk6bWPCUqL8wdFvR6irO" alt=""><figcaption><p><strong>Figure 1:</strong> To share your dataset, open your dataset landing page and click the Edit button</p></figcaption></figure>

<figure><img src="/files/kR44Rc9iRGZHLYUcqOuN" alt=""><figcaption><p><strong>Figure 2:</strong> Select the Share button located to the left of the Add Files button</p></figcaption></figure>

<figure><img src="/files/X2NQdhCF3cCrgTICjQqv" alt=""><figcaption><p><strong>Figure 3:</strong> Review who the dataset is currently shared with</p></figcaption></figure>

<figure><img src="/files/mrZwQWWdGyLtEgjN96S9" alt=""><figcaption><p><strong>Figure 4:</strong> Search for your team members using their first or last names. Selecting their names will automatically add them to the list</p></figcaption></figure>

<figure><img src="/files/7HHXdSI3BNafAGuyMJYM" alt=""><figcaption><p><strong>Figure 5:</strong> Change existing access levels using the dropdown bars in the Access column, if needed.</p></figcaption></figure>

<figure><img src="/files/dT9WkEpgHbiYeAyp4Pvn" alt=""><figcaption><p><strong>Figure 6:</strong> Make sure to save all changes before closing the window and submitting your dataset edits to ESS-DIVE</p></figcaption></figure>

{% hint style="info" %}
**You can also share datasets programmatically using ESS-DIVE's Dataset API.**&#x20;

Visit the [Dataset API Tutorial](https://docs.ess-dive.lbl.gov/contributing-data/data-submission-guidelines/package-service-tutorial#getting-started-with-ess-dive-package-service-1.3) page to learn more about this service. Details on how to  write HTTP requests to (1) change dataset permissions and (2) review access permissions are available via the [Data Package Sharing section](https://api.ess-dive.lbl.gov/#/Data%20Package%20Sharing) of ESS-DIVE's technical documentation page, hosted at <https://api.ess-dive.lbl.gov/>.
{% endhint %}