> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/settings/project-share.md).

# 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 %}