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

# Set up hierarchy

This page describes setting up and managing your LangSmith [*organization*](/langsmith/administration-overview#organizations) and [*workspaces*](/langsmith/administration-overview#workspaces):

* [Set up an organization](#set-up-an-organization): Create and manage organizations for team collaboration, including user management and role assignments.
* [Set up a workspace](#set-up-a-workspace): Set up and configure workspaces to organize your LangSmith resources, manage workspace members, and configure settings for team collaboration.
* [Set up applications](#set-up-applications): Set up applications within a workspace to further organize LangSmith resources, and take advantage of ABAC permissioning.

<Check>
  You may find it helpful to refer to the [overview on LangSmith resource hierarchy](/langsmith/administration-overview) before you read this setup page.
</Check>

## Set up an organization

<Note>
  If you're interested in managing your organization and workspaces programmatically, refer to [Manage organizations using the API](/langsmith/manage-organization-by-api).
</Note>

### Create an organization

When you log into the [UI](https://smith.langchain.com?utm_source=docs\&utm_medium=cta\&utm_campaign=langsmith-signup\&utm_content=langsmith-set-up-hierarchy) for the first time, LangSmith will create a personal organization for you automatically. If you'd like to collaborate with others, you can create a separate organization and invite your team members to join.

1. Open the **Organizations** drawer by clicking your profile icon in the bottom left
2. Select the organization profile dropdown at the top of the menu.
3. Click **+ Create organization**.

Shared organizations require a credit card before you can use them. You will need to [set up billing](/langsmith/billing#set-up-billing-for-your-account) to proceed.

### Manage and navigate workspaces

Once you've subscribed to a [plan](/langsmith/pricing-plans) that allows for multiple users per organization, you can set up [workspaces](/langsmith/administration-overview#workspaces) to collaborate more effectively and isolate LangSmith resources between different groups of users. To navigate between workspaces and access the resources within each workspace (trace projects, annotation queues, etc.), select the desired workspace from the picker in the bottom left of the [LangSmith UI](https://smith.langchain.com?utm_source=docs\&utm_medium=cta\&utm_campaign=langsmith-signup\&utm_content=langsmith-set-up-hierarchy).

### Manage users

Manage membership in your shared organization in the **Members and roles** tabs on the [Settings page](https://smith.langchain.com/settings). Here you can:

* Invite new users to your organization, selecting workspace membership and (if [RBAC](/langsmith/rbac) is enabled) workspace role.
* Edit a user's organization role.
* Remove users from your organization.

Organizations on the [Enterprise plan](/langsmith/pricing-plans) may set up custom workspace roles in the **Roles** tab. For more details, refer to the [access control setup guide](/langsmith/user-management).

#### Organization roles

Organization-scoped roles are used to determine access to organization settings. The role selected also has an impact on workspace membership:

* **Organization Admin** grants full access to manage all organization configuration, users, billing, and workspaces. Any Organization Admin has `Admin` access to all workspaces in an organization.
* **Organization User** may read organization information, but cannot execute any write actions at the organization level. You can add an Organization User to a subset of workspaces and assigned workspace roles as usual (if [RBAC](/langsmith/rbac) is enabled), which specify permissions at the workspace level.

<Info>
  The [Organization User](/langsmith/rbac#organization-user) and [Organization Viewer](/langsmith/rbac#organization-viewer) roles are only available in organizations on [Plus and Enterprise plans](https://langchain.com/pricing). In Developer organizations (single workspace), all users are assigned the [Organization Admin](/langsmith/rbac#organization-admin) role by default. Custom organization-scoped roles are not available.
</Info>

For a full list of permissions associated with each role, refer to the [Administration overview](/langsmith/administration-overview#organization-roles) page.

## Set up a workspace

When you log in for the first time, LangSmith will create a default [workspace](/langsmith/administration-overview#workspaces) for you in your personal organization. You can use workspaces to separate resources between different teams or business units to establish clear trust boundaries between them. Within each workspace, [Role-Based Access Control (RBAC)](/langsmith/rbac) manages permissions and access levels, which ensures that users only have access to the resources and settings necessary for their role. Most LangSmith activity happens in the context of a workspace, each of which has its own settings and access controls.

For guidance on choosing the right workspace organization model for your team (single workspace per team, multiple teams per workspace, or multiple workspaces per team), refer to [Workload isolation](/langsmith/workload-isolation).

### Create a workspace

To create a new workspace, navigate to the [**Settings** page](https://smith.langchain.com/settings) **Workspaces** tab in your shared organization and click **Add Workspace**.

Once you have created your workspace, you can manage its members and other configuration by selecting the workspace on the **Settings** page.

<Note>
  Different plans have different limits placed on the number of workspaces that you can use in an organization. For more information, refer to the [pricing page](https://www.langchain.com/pricing-langsmith).
</Note>

### Manage users

<Info>
  Only [workspace admins](/langsmith/rbac#workspace-admin) can manage workspace membership and, if RBAC is enabled, change a user's workspace role.
</Info>

For users that are already members of an organization, a workspace admin may add them to a workspace in the **Workspace members** tab on the [**Workspaces settings** page](https://smith.langchain.com/settings/workspaces). Users may also be invited directly to one or more workspaces when they are invited to an organization.

### Configure workspace settings

Workspace configuration exists in the [**Workspaces settings** page](https://smith.langchain.com/settings/workspaces) tab. Select the workspace to configure and then the desired configuration sub-tab.
Configuration options include:

* **Workspace members**
* **API keys**
* **Secrets**
* **Feedback config**
* **Models**
* **Rules**
* **Shared URLs**

### Delete a workspace

<Warning>
  Deleting a workspace will permanently delete the workspace and all associated data. This action cannot be undone.
</Warning>

You can delete a workspace through the [LangSmith UI](https://smith.langchain.com?utm_source=docs\&utm_medium=cta\&utm_campaign=langsmith-signup\&utm_content=langsmith-set-up-hierarchy) or via [API](https://api.smith.langchain.com/redoc?#tag/workspaces/operation/delete_workspace_api_v1_workspaces__workspace_id__delete). You must be a [workspace admin](/langsmith/rbac#workspace-admin) in order to delete a workspace.

In the LangSmith UI:

1. Navigate to **Settings**.
2. Select the workspace you want to delete.
3. Click the delete icon <Icon icon="trash" iconType="solid" /> in the top-right corner of the screen.

## Set up applications

You can create applications within a workspace to further organize resources, such as tracing projects and datasets. A workspace may have zero or more applications.

You can view all resources within a workspace by selecting **All applications** from the LangSmith UI home page. You may tag resources to multiple applications by adding them to the `Application` tag under **Resource Tags** on the **Settings** page.

***

<div className="source-links">
  <Callout icon="terminal-2">
    [Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.
  </Callout>

  <Callout icon="edit">
    [Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/langsmith/set-up-hierarchy.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>
</div>