Set up hierarchy

This page describes setting up and managing your LangSmith organization and workspaces:

• Set up an organization: Create and manage organizations for team collaboration, including user management and role assignments.
• 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 within a workspace to further organize LangSmith resources, and take advantage of ABAC permissioning.

​

Set up an organization

​

Create an organization

When you log into the UI 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 to proceed.

​

Manage and navigate workspaces

Once you’ve subscribed to a plan that allows for multiple users per organization, you can set up 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.

​

Manage users

Manage membership in your shared organization in the Members and roles tabs on the Settings page. Here you can:

• Invite new users to your organization, selecting workspace membership and (if RBAC is enabled) workspace role.
• Edit a user’s organization role.
• Remove users from your organization.

Organizations on the Enterprise plan may set up custom workspace roles in the Roles tab. For more details, refer to the access control setup guide.

​

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 is enabled), which specify permissions at the workspace level.

For a full list of permissions associated with each role, refer to the Administration overview page.

​

Set up a workspace

When you log in for the first time, LangSmith will create a default workspace 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) 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.

​

Create a workspace

To create a new workspace, navigate to the Settings page 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.

​

Manage users

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

You can delete a workspace through the LangSmith UI or via API. You must be a 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 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.

---