> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dataerai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sharing & permissions

> Control access to projects, collections, and assets with Read, Write, and Admin roles that cascade through the hierarchy.

Dataerai controls access **per object**. You can set permissions on a project, a collection, or an asset, using three roles.

<Steps>
  <Step title="Open permissions">
    For an **asset**, select it and click **Permissions** in the action bar that appears when something is selected. For a **project** or **collection**, open its **Settings** from the sidebar — the same access controls live there.

    <Frame caption="The action bar for a selected item — open Permissions.">
      <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/nav-permissions-btn.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=d86e744abe613ba1966060740a297668" alt="Dataerai action bar with the Permissions button for a selected item" width="480" height="46" data-path="images/nav-permissions-btn.png" />
    </Frame>
  </Step>

  <Step title="Set access">
    The dialog has a public-access toggle, Users and Groups tabs, and a role per grantee.

    <Frame caption="The permissions dialog — a public-access toggle, Users and Groups tabs, and a role (Read / Write / Admin) per grantee.">
      <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/permissions.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=7fbb1b60d57949dd29f9006cf146260a" alt="Dataerai record permissions dialog with public toggle, Users/Groups tabs, and per-grantee roles" width="485" height="455" data-path="images/permissions.png" />
    </Frame>
  </Step>
</Steps>

## The three roles

| Role      | What it allows                                                                                        |
| --------- | ----------------------------------------------------------------------------------------------------- |
| **Read**  | View the object — its metadata, content, and notes.                                                   |
| **Write** | Everything in Read, plus edit metadata, content, and notes (and add or manage items in a collection). |
| **Admin** | Everything in Write, plus **share** the object with others (and lock an asset).                       |

<Frame caption="Switch between the Users and Groups tabs, then set each grantee's role from the dropdown.">
  <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/permissions-role.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=c1d99531060810cae596aacbde506b0c" alt="Dataerai permissions dialog Users/Groups tabs with a per-grantee role dropdown" width="470" height="150" data-path="images/permissions-role.png" />
</Frame>

What each role grants is tailored to the object:

* **Project** — Read sees and lists the project; Write can edit it and add data
  using the project's assigned allocations; Admin can share it.
* **Collection** — Write can also add and organize the items inside; Admin can share.
* **Asset** — Read includes the file content and notes; Admin can also lock the asset.

Project Write does not make someone a storage admin. They can use allocations
already assigned to the project, but they cannot move allocations between
projects or browse the organization's storage pool unless they also have the
right admin access.

## Permissions cascade

Access granted higher in the hierarchy flows down: someone with Read on a project can read the collections and assets inside it. You can grant access on a specific item to widen or narrow it for that item.

A dataset is governed through this same hierarchy — through the project, collection, and assets it draws from — rather than through a separate sharing dialog of its own. [Restricted fields](/sharing/restricted-fields) within a dataset can be kept protected even on data you otherwise share.

## Who you can share with

* **Individual people** in your organization.
* **Groups**, to grant many people at once.
* The **public**, for read-only access to any signed-in user with the link.

See [Share with people and groups](/sharing/people-and-groups) and [Public sharing](/sharing/public).

## Next steps

<CardGroup cols={2}>
  <Card title="People & groups" icon="users" href="/sharing/people-and-groups">
    Grant and manage access for individuals and teams.
  </Card>

  <Card title="Restricted fields" icon="lock" href="/sharing/restricted-fields">
    Protect sensitive columns within a dataset.
  </Card>
</CardGroup>
