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 section for details on which access level grants each capability.

How to Share a Dataset

You must be the dataset creator or have manage access to share datasets

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

You can also share datasets programmatically using ESS-DIVE's Dataset API.

Visit the Dataset API Tutorial 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 of ESS-DIVE's technical documentation page, hosted at https://api.ess-dive.lbl.gov/.