# 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](https://docs.ess-dive.lbl.gov/manage-data/share-data-permissions/..#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 1: To share your dataset, open your dataset landing page and click the Edit button

Figure 2: Select the Share button located to the left of the Add Files button

Figure 3: Review who the dataset is currently shared with

Figure 4: Search for your team members using their first or last names. Selecting their names will automatically add them to the list

Figure 5: Change existing access levels using the dropdown bars in the Access column, if needed.

Figure 6: Make sure to save all changes before closing the window and submitting your dataset edits to ESS-DIVE

{% hint style="info" %} **You can also share datasets programmatically using ESS-DIVE's Dataset API.** 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 . {% endhint %}