---
title: Create a Workspace
nav_order: 3
tags:
    - Guide
    - External
    - User
# exclude-from-main-guides-list
---

## Create a Workspace

This section explains how to create a blank workspace, import a dataset from TDEI, or upload an OpenSidewalks data file.

_For a list of all guides on the TCAT Wiki, refer to the [Guides List](../../guides-list/index.md)._{ .guides-list-ref }

---

### Choose a creation method

1. **Open** **Create Workspace** in the navigation bar
2. Review the three available creation methods:
    - **Blank Workspace** creates an empty workspace with no data.
    - **From TDEI** creates a workspace by importing an asset stored in TDEI.
    - **From File** creates a workspace from an OpenSidewalks data file on your computer.

3. **Select** **Start** on the method that matches your source data

---

### Create a blank workspace

1. **Select** **Start** under **Blank Workspace**
2. Enter a name in **Workspace Title**
3. Select a **Project Group**
4. Under **Dataset Type**, select **OpenSidewalks** or **GTFS Pathways**
5. **Select** **Create Workspace**

---

### Create a workspace from TDEI

1. **Select** **Start** under **From TDEI**
2. Enter a name in **Workspace Title**
3. Select a **Project Group**
4. Select a **Dataset** from the available TDEI datasets
5. Review the dataset information and map preview
6. **Select** **Create Workspace**

The dataset information panel can include the dataset name, description, dataset type, status, TDEI dataset ID, project group, service, collection date, publication date, and OpenSidewalks schema version.

!!! note "Import behavior"

    Creating a workspace from TDEI creates a *copy* of the selected dataset. The workspace is a separate editing context from the source dataset, which remains unchanged.

---

### Create a workspace from a file

1. **Select** **Start** under **From File**
2. Enter a name in **Workspace Title**
3. Select a **Project Group**
4. Under **Dataset Type**, select **OpenSidewalks** or **GTFS Pathways**
5. Under **Dataset File**, **select** **Browse...** and choose the data file from your computer
6. **Select** **Create Workspace**

---

### Monitor workspace setup

After creating a workspace from a dataset, Workspaces may show the workspace with a **Setting up...** status while the data is being populated. The workspace actions may remain unavailable during setup.

!!! tip "Wait for setup to finish"

    Refresh the workspace status and wait for setup to finish before trying to open workspace-dependent actions.

---

**Previous:** [Getting Started](getting-started.md) | **Next:** [Dashboard](dashboard.md)