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

# Organizations and Projects

> This page explains how to create, configure, and manage Organizations and Projects.

An **Organization** is the top-level container that isolates data, users, and settings, while a **Project** is the workspace where conversations are ingested, analyzed, and reported. For a conceptual overview of how they work together, see [**Organizations & Projects**.](/guides/platform/org-projects)

## Managing organizations

### Creating an organization

Organizations are typically created during onboarding by your Nebuly administrator or account team. Each organization is completely isolated from every other organization, making it suitable for separating production and development environments, business entities, or customers.

### Managing organization members

Organization administrators can invite new members, remove existing users, and assign organization roles. Membership in an Organization does not automatically grant access to every project—project access is managed independently.

### Organization settings

Organization-level settings apply to every project within the Organization. These include:

* Authentication and Single Sign-On (SSO)
* Organization members and roles
* Alerts and notifications
* Organization-wide preferences

For more information, see [**Authentication**](/guides/admin/authentication) and [**User Management & Permissions**](/guides/admin/permissions-and-user-management).

## Managing Projects

A **Project** is the workspace where conversations are ingested, analyzed, and reported.

### Creating a project

Create a **root project** when you want to analyze a new AI application or ingest conversations from a new data source.

Each root project stores its own interactions and configuration, including reports, taxonomies, processing settings, ROI configuration, and API keys.

Once created, you can start sending interactions to the project using the [Interaction API](https://docs.nebuly.com/tracking/api-reference/events/post-events-interaction-with-trace-v2).

<Frame caption="Creating a root project">
  <div style={{ maxWidth: '520px', margin: '0 auto' }}>
    <img className="rounded-xl" src="https://mintcdn.com/nebulyai/G04Jo9hLv86JYsPM/images/create-project.png?fit=max&auto=format&n=G04Jo9hLv86JYsPM&q=85&s=be7fa55781745e9c787b2e7fbc0711ea" alt="Creating a root project" width="866" height="704" data-path="images/create-project.png" />
  </div>
</Frame>

### Creating a sub-project

A sub-project creates a filtered view of an existing root project.

To create one:

1. Open the parent root project.
2. Apply the global filters that define the subset of data.
3. Click **Save as project**.
4. Enter a project name.
5. Confirm.

The new project inherits the filtered dataset and appears in the project switcher.

<Frame caption="Creating a sub-project">
  <img className="rounded-xl" src="https://mintcdn.com/nebulyai/G04Jo9hLv86JYsPM/images/create-sub-project.png?fit=max&auto=format&n=G04Jo9hLv86JYsPM&q=85&s=01c92f9ef48c4ab73e36d7a4dd0cf098" alt="Creating a sub-project" width="2628" height="1018" data-path="images/create-sub-project.png" />
</Frame>

### Managing project access

By default, new users may be granted access to all projects in the Organization, but this can be restricted on a per-project basis to maintain focus and security.

To change which users have access to a specific project, an Admin can open the project's settings and adjust the access list. Project-level access is governed by **RBAC** and is independent of Organization-level membership. A user can be a member of an Organization without having access to every project inside it.

<Frame caption="Selecting the projects a user can access">
  <img className="rounded-xl" src="https://mintcdn.com/nebulyai/G04Jo9hLv86JYsPM/images/project-access-configuration.png?fit=max&auto=format&n=G04Jo9hLv86JYsPM&q=85&s=d50d1975ab9997dd3e326548e49d1ad8" alt="Configuring project access for a user" width="2614" height="826" data-path="images/project-access-configuration.png" />
</Frame>

## Key Management Features

Nebuly is designed to securely separate data across organizations and projects.

* **Organizations** provide complete isolation. Each Organization has its own users, authentication (SSO), settings, alerts, and data. Information is never shared across Organizations.
* **Root projects** contain the actual conversation data and have their own analytics configuration, including taxonomies, AI ROI, AI Proficiency, and processing settings.
* **Sub-projects** inherit data from a root project through global filters, allowing different teams to analyze specific subsets of the same data without duplication.
* **Permissions** are managed independently at both the Organization and Project levels using **Role-Based Access Control (RBAC)**. This lets administrators control who can access each project while maintaining centralized organization management.
