# 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 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 %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.ess-dive.lbl.gov/manage-data/share-data-permissions/share-datasets.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.