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

# Workspaces

> Organize your analytics projects with workspaces

## What is a Workspace?

A workspace is a container for organizing your analytics assets. Think of it as a project or environment where you create dashboards, metrics, and manage data connections. Each workspace is isolated, allowing you to separate different projects, clients, or environments.

## Key Features

<CardGroup cols={2}>
  <Card title="Data Isolation" icon="shield">
    Each workspace has its own data sources and access controls
  </Card>

  <Card title="Team Collaboration" icon="users">
    Invite team members and control their permissions
  </Card>

  <Card title="Multi-Datasource" icon="database">
    Connect multiple data sources within a single workspace
  </Card>

  <Card title="Multi-Datamart" icon="layer-group">
    Switch between multiple datamarts on one workspace and dashboard
  </Card>

  <Card title="Custom Settings" icon="gear">
    Configure caching, downloads, and access control per workspace
  </Card>
</CardGroup>

## Workspace Types

### Standard Workspace

A standard workspace is visible to all organization members (based on permissions). Use this for team-wide analytics projects.

**Best for:**

* Shared team dashboards
* Department-level analytics
* Cross-functional reporting

### Private Workspace

A private workspace is only accessible to its creator and explicitly invited members. Perfect for personal or sensitive projects.

**Best for:**

* Personal analytics projects
* Client-specific dashboards (draft mode)
* Sensitive data analysis

<Note>
  Learn how to create workspaces in our [Create a Workspace](/guides/onboarding-and-configuration/create-a-workspace) guide.
</Note>

## Workspace Components

A workspace contains several key components:

<Steps>
  <Step title="Dashboards">
    Create collections of metrics and visualizations
  </Step>

  <Step title="Metrics">
    Individual charts, tables, and KPIs
  </Step>
</Steps>

## Workspace Settings

Each workspace has configurable settings to control behavior and access:

### General Settings

* **Workspace name**: Edit the workspace name
* **Creator Settings**: Choose creation mode:
  * **Power Mode**: Drag-and-drop functionality or custom queries. Select **Data Source** from dropdown.
  * **Chat Mode**: Keyword-based search. Select preferred **Datamart**.
* **LLM Settings**: Choose LLM for Chat Mode and Metric Summary. Enable **Metric Suggestions**.
* **Theme Settings**: Set workspace themes

### Access Control Settings

* Configure permissions for end users:
  * Metric Creation, Deletion, Updation
  * Manage Metrics
  * Change Dashboard Layout
  * Schedule Email Reports
  * Underlying Data access
  * Choose between Power Mode and Chat Mode for users

### Cache Settings

* Query result caching
* Cache duration (in seconds)
* Cache host and port configuration
* Access key/AUTH token
* Databrain Caching option

### Download Settings

* Enable/disable download via email
* Control users' ability to download raw data

<Card title="Configure Workspace Settings" icon="gear" href="/guides/onboarding-and-configuration/workspace-settings">
  Learn more about workspace settings configuration
</Card>

## Multi-Datasource Workspaces

DataBrain supports connecting multiple data sources to a single workspace. This enables cross-database analytics and unified reporting.

**Benefits:**

* Combine data from different sources
* Create unified dashboards
* Reduce data silos
* Flexible data modeling

<Card title="Multi-Datasource Workspaces" icon="database" href="/guides/workspace/multi-datasource-workspace">
  Learn about multi-datasource workspace setup
</Card>

## Best Practices

<AccordionGroup>
  <Accordion title="Organize by Project or Client" icon="folder">
    Create separate workspaces for different projects or clients to maintain clear boundaries and access control.
  </Accordion>

  <Accordion title="Use Descriptive Names" icon="tag">
    Name your workspaces clearly to make them easy to identify. Include project names, client names, or environment indicators.
  </Accordion>

  <Accordion title="Set Up Access Control Early" icon="lock">
    Configure permissions and access control when creating the workspace to prevent security issues later.
  </Accordion>

  <Accordion title="Regular Cleanup" icon="broom">
    Archive or delete unused workspaces to keep your organization tidy and reduce clutter.
  </Accordion>
</AccordionGroup>

## Common Use Cases

### SaaS Product Analytics

Create workspaces for different customer segments or product areas. Use multi-tenancy to isolate customer data.

### Internal BI

Set up workspaces for each department (Sales, Marketing, Finance) with appropriate data sources and access controls.

### Client Reporting

Create dedicated workspaces for each client with their specific data connections and custom dashboards.

### Development & Production

Maintain separate workspaces for development, staging, and production environments.

## Next Steps

<CardGroup cols={2}>
  <Card title="Create Your First Workspace" icon="plus" href="/guides/onboarding-and-configuration/create-a-workspace">
    Step-by-step guide to creating a workspace
  </Card>

  <Card title="Connect Data Sources" icon="plug" href="/guides/onboarding-and-configuration/add-a-data-source">
    Add data sources to your workspace
  </Card>

  <Card title="Learn About Dashboards" icon="table-columns" href="/getting-started/core-concepts/dashboards">
    Understand dashboard concepts
  </Card>

  <Card title="Explore Metrics" icon="chart-line" href="/getting-started/core-concepts/metrics">
    Learn about metrics and visualizations
  </Card>
</CardGroup>