Skip to main content
A workspace is your team’s complete AI environment in Dify. It contains and isolates everything your organization needs: applications, knowledge bases, team members, model configurations, and integrations.

​
The Workspace Mental Model

Every resource in Dify belongs to a workspace. When you create an app, it inherits the workspace’s model configurations. When you add team members, they get access to workspace resources based on their role. When you configure models or install integrations, they become available to the entire workspace. 
🏢 Your Organization
└── 📁 Workspace
    ├── 🤖 Apps (chatbots, workflows, agents)
    ├── 📊 Knowledge Bases (documents, embeddings)
    ├── 👥 Team Members (roles & permissions) 
    ├── 🧠 Model Providers (API keys, configurations)
    └── 🔧 Tools & Integrations (integrations, custom code)
This workspace-first design means your resources are completely isolated from other organizations, team members can only access what they’re permitted to see, and you configure models once for the entire workspace.

​
Workspace Creation

An initial workspace is created during installation, with the administrator email and password set during setup. You can run multiple workspaces to keep resources fully isolated between legal entities, regulatory environments, or client projects. Each workspace has its own apps, knowledge bases, members, and model configurations. Administrators provision and manage workspaces from the Enterprise Admin Panel; see Workspace Management.

​
How Resources Connect

Applications you build can use any model providers configured in the workspace, access all workspace knowledge bases, and use installed integrations. Team members see applications based on their workspace permissions. Workspace roles determine access across all resources:
  • Owners control model providers and workspace settings
  • Admins manage team members and configure models and integrations
  • Editors build applications and manage knowledge bases
  • Members use published applications

​
Workspace Navigation

Dify organizes everything around the workspace concept. The main navigation shows Apps, Knowledge, and Tools available in your workspace. Settings contains workspace-wide configurations: Members, Model Providers, Integrations, and personal Account settings.