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

# Creating Workspaces

> Set up workspaces for your roadmaps

## Overview

Workspaces are isolated environments for your roadmaps. Each workspace contains its own items, products, strategic priorities, and settings.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/wey/images/placeholder-workspaces.png" alt="Workspaces" />
</Frame>

## When to Create Workspaces

Create separate workspaces for:

| Use Case                   | Example                                  |
| -------------------------- | ---------------------------------------- |
| **Different products**     | "Mobile App", "Web Platform"             |
| **Different teams**        | "Engineering", "Design", "Marketing"     |
| **Different clients**      | Agency managing multiple client roadmaps |
| **Different environments** | "Production", "Planning", "Archive"      |

<Tip>
  If work is closely related and should be visible together, keep it in one workspace with product areas for organization.
</Tip>

## Creating a Workspace

<Steps>
  <Step title="Open Workspace Selector">
    Click on your current workspace name in the sidebar header.
  </Step>

  <Step title="Click New Workspace">
    Select **+ New Workspace** from the dropdown.
  </Step>

  <Step title="Enter Details">
    Provide a name and optional description for your workspace.
  </Step>

  <Step title="Create">
    Click **Create Workspace** to finish.
  </Step>
</Steps>

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/wey/images/placeholder-create-workspace.png" alt="Create Workspace Dialog" />
</Frame>

## Workspace Settings

Configure your workspace:

| Setting          | Description                                  |
| ---------------- | -------------------------------------------- |
| **Name**         | Display name for the workspace               |
| **Description**  | Brief description of the workspace purpose   |
| **Default View** | Which view opens when entering the workspace |

### Accessing Settings

1. Click the gear icon in the sidebar
2. Select **Workspace Settings**
3. Modify and save changes

## Workspace Contents

Each workspace has its own:

* **Items**: Initiatives, Epics, Stories, Tasks, Bugs
* **Products & Product Areas**: Organizational structure
* **Strategic Priorities & Goals**: Strategy alignment
* **Saved Views**: Filter configurations
* **Settings**: Workspace-specific configuration

<Info>
  Data does not automatically share between workspaces. Each workspace is independent.
</Info>

## Demo Data

Start with sample data to explore features:

<Steps>
  <Step title="Create New Workspace">
    Or open an empty workspace.
  </Step>

  <Step title="Generate Demo Data">
    Click **Generate Demo Data** in settings or the empty state prompt.
  </Step>

  <Step title="Explore">
    Browse the pre-populated roadmap to learn the features.
  </Step>
</Steps>

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/wey/images/placeholder-demo-data.png" alt="Demo Data" />
</Frame>

## Deleting a Workspace

<Warning>
  Deleting a workspace permanently removes all its data. This cannot be undone.
</Warning>

To delete a workspace:

1. Go to **Workspace Settings**
2. Scroll to **Danger Zone**
3. Click **Delete Workspace**
4. Confirm by typing the workspace name

## Best Practices

<AccordionGroup>
  <Accordion title="Start with One">
    Begin with a single workspace and split only when the need is clear.
  </Accordion>

  <Accordion title="Clear Naming">
    Use descriptive names that make the purpose obvious.
  </Accordion>

  <Accordion title="Regular Cleanup">
    Archive or delete workspaces that are no longer active.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Switching Workspaces" icon="arrows-rotate" href="/docs/workspaces/switching-workspaces">
    Navigate between your workspaces.
  </Card>

  <Card title="Products" icon="box" href="/docs/organization/products">
    Organize within a workspace.
  </Card>
</CardGroup>