# Source: https://docs.promptlayer.com/why-promptlayer/shared-workspaces.md

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

# Organizations & Workspaces

The Organizations & Workspaces feature in PromptLayer provides a comprehensive system for team collaboration and resource management. Organizations serve as the top-level container for your company, while workspaces allow you to organize projects, teams, and resources within your organization.

## Key Features

* **Organization Management**: Centralized control over your entire company's PromptLayer usage
* **Workspace Organization**: Create multiple workspaces for different teams, projects, or environments
* **Role-Based Access Control**: Manage permissions at both organization and workspace levels
* **Resource Sharing**: Share prompts, evaluations, and other resources across your team
* **Billing Management**: Consolidated billing and usage tracking at the organization level

## Organizations

An organization represents your company or top-level entity in PromptLayer. It provides:

* Centralized billing and subscription management
* User management across all workspaces
* Organization-wide settings and configurations
* Usage tracking and analytics

### Organization Roles

Organizations support different user roles:

* **Owner**: Full administrative access, billing management, and ability to manage all workspaces
* **Admin**: Can manage users, create workspaces, and access all workspace data
* **Member**: Default role with access to assigned workspaces

For more granular workspace-level permission control, [RBAC (Role-Based Access Control)](/why-promptlayer/rbac) allows you to define custom roles and fine-grained permissions at the workspace level.

### Managing Your Organization

Organization settings allow you to:

* Manage organization members and their roles
* View billing and subscription details
* Configure organization-wide settings
* Monitor usage across all workspaces

## Workspaces

Workspaces are collaborative environments within your organization where teams can:

* Share prompt templates and evaluations
* Collaborate on projects
* Organize resources by team or project
* Maintain separate environments (dev, staging, production)

### Creating a Workspace

You can create a new workspace by clicking the 'Create Workspace' button from the workspace dropdown.

<img src="https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-create-button.png?fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=c529d20b4d81d03c049a4be51d043928" alt="Create Workspaces Button" data-og-width="838" width="838" data-og-height="434" height="434" data-path="images/workspaces-create-button.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-create-button.png?w=280&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=342b4921eb39126d6a2cf65661573c80 280w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-create-button.png?w=560&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=ae5b7a24f12900fb5b37f9622dd73f27 560w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-create-button.png?w=840&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=38617402ec9ac2a347c66e3570f14278 840w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-create-button.png?w=1100&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=859432ab93bc6d2171900349827a42f6 1100w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-create-button.png?w=1650&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=6ec583c12f573eba7b5863afb5dd6d81 1650w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-create-button.png?w=2500&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=a43a851d0af4759e583530263cc5b26c 2500w" />

Choose a unique name for your workspace to enhance its identity and ease of recognition among team members.

<img src="https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-create-modal.png?fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=9324170340085a292b32b5b7e81bce0c" alt="Create Workspaces Modal" data-og-width="1188" width="1188" data-og-height="728" height="728" data-path="images/workspaces-create-modal.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-create-modal.png?w=280&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=816985e1b56730fc3e3c0cb1a3c13cf2 280w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-create-modal.png?w=560&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=88ce8ea5a085dd12d458f79c77843f49 560w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-create-modal.png?w=840&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=6fc32efdd8e2bbd9f3bfd41c67ed68cb 840w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-create-modal.png?w=1100&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=73ebe012d19c1929e20bc34b2b99e0c8 1100w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-create-modal.png?w=1650&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=e713d7d11ec845ac6f3ea809341f77bc 1650w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-create-modal.png?w=2500&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=4b9aa1aa41dedff4510c1692a8f7041e 2500w" />

### Workspace Management

Upon creating a workspace, you'll be designated as the workspace administrator. This role empowers you to:

* Invite new members to the workspace
* Manage member permissions
* Remove members from the workspace
* Configure workspace-specific settings
* Delete the workspace if needed

<img src="https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-management.png?fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=61728c5ac22db8f3790d753ef32d10f5" alt="Workspaces Management" data-og-width="1484" width="1484" data-og-height="882" height="882" data-path="images/workspaces-management.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-management.png?w=280&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=713ac44f5a4a59adc730a9e55b87c072 280w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-management.png?w=560&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=7842f4baec47fd16c63e8102c4695256 560w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-management.png?w=840&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=7aadcc6576f3fd6f3c47b5a2c5700212 840w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-management.png?w=1100&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=fad05eb9e0a136c084eae1dc654c4025 1100w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-management.png?w=1650&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=6d04773776f284f28c866c54632c05aa 1650w, https://mintcdn.com/promptlayer/v0RzaTvbzopITX7U/images/workspaces-management.png?w=2500&fit=max&auto=format&n=v0RzaTvbzopITX7U&q=85&s=b881b438afd1bd076dd4e19fa812064b 2500w" />

### Workspace Roles and Permissions

Each workspace supports granular permission control:

* **Workspace Admin**: Full control over workspace settings and members
* **Editor**: Can create, edit, and delete resources within the workspace
* **Viewer**: Read-only access to workspace resources

## Best Practices

Organizations typically structure workspaces by team (Engineering, Data Science, Product), by project, or by environment (dev, staging, production). When managing access, follow the principle of least privilege and regularly review workspace memberships to ensure proper access control.

## Billing and Limits

* Billing is managed at the organization level
* Workspace limits depend on your subscription plan
* Usage is tracked across all workspaces in your organization