Setting Up Your First Workspace
A workspace is a dedicated area inside your organization for a specific product, team, or project. Think of it as a focused space where all the releases, sprints, tasks, and issues for that area live together.
Creating a workspace
During onboarding
If you just created your organization, the onboarding flow prompts you to create your first workspace automatically. Fill in the details and you are done.
Manually at any time
- Click the Workspaces link in the left sidebar.
- Click New Workspace (or the + button).
- Fill in:
| Field | Description |
|---|---|
| Workspace name | A clear, descriptive name (e.g., "Mobile App", "Platform Team") |
| Description | Optional — a brief summary of what this workspace covers |
| Color / Icon | Optional — helps visually distinguish workspaces |
- Click Create Workspace.
Most teams start with one workspace per product or major project. If your team works on several unrelated products, create one workspace for each. Members can belong to multiple workspaces.
Navigating your workspace
Once inside a workspace, the left sidebar shows the main areas:
- Dashboard — An overview of open sprints, recent activity, and key metrics
- Releases — All releases for this workspace
- Sprints — Sprints grouped by release
- Tasks — All tasks across sprints
- Issues — All bugs and reported problems
- Epics — High-level groupings of work
- Kanban — Board view of the current sprint
- Gantt — Timeline view of tasks and dependencies
- Team — Members and their roles in this workspace
- Settings — Workspace-level configuration
Switching between workspaces
Use the workspace switcher at the top of the left sidebar to move between workspaces. Click your current workspace name to see a dropdown of all workspaces you belong to.