# Project Share

<figure><img src="/files/TTDWaQ8eEx4o6Dgfh24W" alt=""><figcaption></figcaption></figure>

The **Project Share** feature allows administrators to control **who can access specific projects** within the environment. This mechanism ensures proper segregation of data, dashboards, and studios across teams, users, or external collaborators.

***

### Purpose of Project Share

Project Share is used to:

* Grant access to projects without changing global user roles
* Share projects selectively with users or groups
* Enforce least-privilege access across environments
* Support multi-team or multi-client setups

Access granted here directly impacts visibility of:

* Dashboards
* Studios
* Project-level resources

***

### Step-by-Step: Sharing Projects

#### 1. Access Project Share

Navigate to:

**Settings → Project Share**

***

#### 2. Select Who Will Receive Access

At the top of the screen, use **Grant to** to select:

* A **Project**

This defines **which** project will receive access to bucket tables.

***

#### 3. Choose Projects to Share

The screen is divided into two panels:

**Available items (left)**

* Displays all projects you are allowed to share
* Includes:
  * Search field
  * Item counter
  * **Select all** option

**Selected items (right)**

* Displays projects already selected for sharing
* Initially empty if no project is selected

***

#### 4. Select Projects

* Check the box next to each project you want to share
* Selected projects will appear in the **Selected items** panel
* You can:
  * Search projects by name
  * Select multiple projects
  * Remove individual selections or use **Remove all**

***

#### 5. Apply Changes

Once the desired projects appear under **Selected items**:

* Click **Apply**

Access is granted immediately.

***

### Resulting Permissions

After applying:

* The selected **project** will gain access to:
  * All shared tables.

***

### Modifying or Revoking Access

You can update project sharing at any time:

* Reopen **Project Share**
* Change selected projects
* Click **Apply** again

Changes take effect immediately.

***

### Best Practices

* Share only the projects required for the user’s responsibilities
* Regularly audit shared projects to avoid overexposure

***

### Security Notes

* Removing a project instantly revokes access
* No logout or refresh is required
* Access control is enforced in real time

{% hint style="info" %}
Project Share provides **granular, auditable, and scalable access control** at the project level.
{% 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.gaiodataos.com/settings/project-share.md?ask=<question>
```

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.