> 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-portals.md).

# Share Portals

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

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

* Edit page markdown, 
* Add/remove pages, and
* Add/remove data filters

{% hint style="warning" %}
Sharing a portal with someone gives them permission to edit your portal page; it **does not** give them permission to edit or manage **any datasets** or view private datasets in the data portal
{% endhint %}

## How to Share Portals

If you have access to **manage** a data portal, you can follow the instructions below to change portal permissions through your portal's settings page. The instructions for changing the sharing options are the same for datasets and data portals, visit the dataset sharing guide to read more about how this feature is used.

1. **Login** to [ESS-DIVE](https://data.ess-dive.lbl.gov/) and select the [Portals](https://data.ess-dive.lbl.gov/portals) button in the navigation bar
   * *Only* [*registered data contributors*](/contributing-data/new-contributor-registration.md) *can create or share portals, make sure you are logged in and registered before attempting to share a portal*
2. **Find your portal** in the "My Portals" section and click edit, or create a new portal if you do not have one already
3. Open the **portal settings** page on the right-hand side (Figure 1)
4. Scroll down the settings page until you see the **sharing options table** (Figure 2) which shows you who the portal is already shared with and what permission type they have. By default the portal creator has manage permissions.
5. **Share the portal** with new people by searching for their first or last names in the search bar in the sharing options window (Figure 3). Select the appropriate name to be added to the list of people with portal permissions.
   * *Only people who have logged into ESS-DIVE using their ORCID can be found in the Sharing Options search bar*
6. **Modify existing** permission types as needed using the dropdown bars under the Access column
7. Review your changes and hit **Save**

![Figure 1: Open the portals settings to find portal sharing options](/files/AbwqILYtFHtmPQYE7Jvx)

![Figure 2: The sharing options window is towards the bottom of the settings page](/files/PDDgcqgBEKzW6xAIphaq)

![Figure 3: Use the search bar to find your colleague's name and add them to the data portal permissions](/files/mrZwQWWdGyLtEgjN96S9)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.ess-dive.lbl.gov/manage-data/share-data-permissions/share-portals.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.