> ## 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.

# Key concepts

> How organizations, projects, collections, assets, datasets, transfers, storage, groups, and permissions fit together in Dataerai.

Start here if the product terms are new.

The most important ideas are:

* Where your data lives.
* How records are grouped.
* Who can access them.
* How files move in and out.

<CardGroup cols={3}>
  <Card title="Organization" icon="building-2">
    Your institution or lab's home. Holds projects, members, and storage.
  </Card>

  <Card title="Project" icon="folder-kanban">
    A workspace for a study, grant, or effort.
  </Card>

  <Card title="Collection" icon="folder-tree">
    A nestable container that groups assets within a project.
  </Card>

  <Card title="Asset" icon="file">
    A file (or bundle) plus its metadata, notes, and relationships.
  </Card>

  <Card title="Dataset" icon="database">
    A versioned, analysis-ready view of your data.
  </Card>

  <Card title="Transfer" icon="arrow-right-left">
    An upload or download of file content.
  </Card>
</CardGroup>

## The hierarchy

Data nests from broad to specific:

**Organization → Project → Collection → Asset → Content**

An **organization** contains **projects**. A project contains **collections**.
Collections hold **assets**, and an asset holds file **content**.

Access usually flows down the hierarchy: a person who can read a project can read
the collections and assets inside it, unless access is changed on a specific
item.

<Frame caption="Inside a project: collections and assets in the data list, with the selected item's details on the right.">
  <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/project-contents.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=e84de0a1390e046712093094e505725f" alt="Dataerai project workspace showing collections and assets" width="1420" height="175" data-path="images/project-contents.png" />
</Frame>

## Organizations and members

An **organization** is the top-level home for your institution, lab, or company. Every member of an organization has a role:

| Role       | What it allows                                                                     |
| ---------- | ---------------------------------------------------------------------------------- |
| **Member** | Work within the organization's projects according to the permissions they're given |
| **Admin**  | Manage the organization and its members                                            |

<Frame caption="An organization in Settings — members and their roles.">
  <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/organization.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=d7809b6c012b5806087dc63527c9510c" alt="Dataerai organization detail showing members and roles" width="555" height="320" data-path="images/organization.png" />
</Frame>

See [Organizations & members](/account/organizations).

## Projects

A **project** is the primary workspace, typically one per study, grant, or
effort. Within a project, members have a role:

| Role        | What it allows                                                |
| ----------- | ------------------------------------------------------------- |
| **Member**  | View and work with project data they have access to           |
| **Manager** | Create and manage content in the project                      |
| **Admin**   | Full control of the project, including sharing and membership |

The person who creates a project is its Admin. See [Projects & members](/account/projects).

<Frame caption="The home view lists your projects.">
  <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/projects.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=e7c9b60091e521f3238ce0e578c13615" alt="Dataerai home view listing projects" width="1420" height="130" data-path="images/projects.png" />
</Frame>

## Collections

A **collection** is a folder-like container that groups assets inside a project.
Collections can nest, so you can organize data by experiment, instrument, sample,
or date. See [Collections](/organize/collections).

<Frame caption="Creating a collection — name, description, and where its data is stored.">
  <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/new-collection.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=7981f8380b3fb2c79308cdfe6a137309" alt="Dataerai Create collection dialog" width="482" height="470" data-path="images/new-collection.png" />
</Frame>

## Assets and content

An **asset** is the core unit of data. It combines:

* **Metadata** — title, description, tags, and structured fields (often extracted automatically from instrument files).
* **Content** — the actual file or files. An asset can exist *before* its content is uploaded, which is useful for metadata-first workflows.
* **Notes** — a Markdown note or README describing protocols, settings, and caveats.
* **Relationships** — links to other assets that capture **provenance** (which data produced which).

See [Assets & content](/organize/assets) and [Provenance](/organize/provenance).

<Frame caption="An asset's detail panel, with tabs for General, Metadata, Notes, and Comments. The General tab shows the asset's DID, tags, relationships, and a ready-to-copy citation.">
  <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/asset-detail.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=9f977953a6566993035bd229118cb121" alt="Dataerai asset detail panel" width="350" height="600" data-path="images/asset-detail.png" />
</Frame>

## Datasets and versions

A **dataset** is a curated, **versioned** view of data prepared for analysis.

Each version is a snapshot. Dataerai can analyze it to infer structure, such as
columns and types in a table, so it is ready to explore and visualize.

<Frame caption="A ready dataset — Dataerai's automatic analysis: a histogram, a row preview, and a scatter chart.">
  <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/dataset-asset.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=d9998cf304dd2b04a98991dc7a552504" alt="Dataerai dataset asset with histogram, table preview, and scatter chart" width="345" height="790" data-path="images/dataset-asset.png" />
</Frame>

See [Datasets](/datasets/overview).

## Transfers

A **transfer** is an upload or download.

Dataerai is built for large scientific files, so transfers can resume if
interrupted. You can transfer in the browser, or with the
[desktop app and CLI](/data/desktop-and-cli).

<Frame caption="The Transfer tracker — live, day-grouped history of uploads and downloads.">
  <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/transfer-tracker.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=7632c3f53151e109081933c7de54a086" alt="Dataerai Transfer tracker panel" width="432" height="620" data-path="images/transfer-tracker.png" />
</Frame>

## Storage: repositories and allocations

Your data lives in a **repository**. Your team gets a storage **allocation** in
that repository.

Most of the time this is set up for you. You will mainly notice it when choosing
where new data goes or checking usage. See [Storage](/account/storage).

<Frame caption="An allocation — its repository and usage against the space and record limits.">
  <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/allocations.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=2cb4becd21f7119b51339bc05edf7c49" alt="Dataerai allocation showing usage against limits" width="555" height="165" data-path="images/allocations.png" />
</Frame>

## Groups and permissions

Access is controlled **per object** — project, collection, asset, or dataset — using three roles:

| Role      | What it allows                               |
| --------- | -------------------------------------------- |
| **Read**  | View metadata, content, and notes            |
| **Write** | Read, plus edit metadata, content, and notes |
| **Admin** | Write, plus share the object with others     |

You can grant a role to an individual, to a **group** of people, or to the **public**. Public access is always read-only: any signed-in user who has the link can view, but no one without an account can. Datasets can also mark sensitive **restricted fields** that are hidden from people who lack an extra grant to view them.

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

See [Sharing & permissions](/sharing/permissions).

## Attribution

Dataerai connects your data to the research record.

You can connect data to:

* **Grants** that funded it.
* **Publications** it supports.
* **People** who contributed.

See [Attribution](/attribution/grants).
