# Creating, editing, or deleting a workspace

## Creating a workspace <a href="#workspaces-create-options" id="workspaces-create-options"></a>

When you create a new workspace, you can either:

* [Create a completely new workspace.](#workspace-create-new)
* [Create a copy of an existing workspace.](#workspace-create-copy)\
  \
  The copy initially uses the configuration from the original workspace.\
  \
  After the copy is created, it is completely independent from the original workspace.
* [Create a child of an existing workspace.](#workspace-create-child)\
  \
  Child workspaces inherit configuration from the parent workspace. They continue to be updated automatically when the parent workspace is updated. For more information, go to [workspaces-inheritance](https://docs.tonic.ai/app/workspace/managing-workspaces/workspaces-inheritance "mention").

You can also view this [video overview of how to create a workspace](https://youtu.be/iH-wBYJLQlk).

When you create a workspace, a new [Structural Agent](https://docs.tonic.ai/app/structural-agent/agent-about) chat starts for the workspace.

### Creating a completely new workspace <a href="#workspace-create-new" id="workspace-create-new"></a>

{% hint style="info" %}
**Required global permission:** Create workspaces
{% endhint %}

To create a completely new workspace, on **Workspaces** view, click **Create Workspace > New Workspace**.

### Creating a copy of a workspace <a href="#workspace-create-copy" id="workspace-create-copy"></a>

{% hint style="info" %}
**Required workspace permission:** Copy workspace (in the workspace to copy)

Or

**Required global permission:** Copy any workspace
{% endhint %}

To create a workspace based on an existing workspace, either:

* On the workspace management view of the workspace to copy, from the workspace actions menu, select **Duplicate Workspace**.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FEn5VYq6fj7bUICgsvkU1%2FWorkspaceHeadingOptionsMenu.png?alt=media&#x26;token=eae153e0-20df-424a-bcb9-e379389b9c01" alt=""><figcaption><p>Workspace actions menu</p></figcaption></figure>

* On **Workspaces** view, click the actions menu for the workspace, then select **Duplicate Workspace**.

![Workspace options column and dropdown list](https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FOtZWZAQCxaIXeJwAe2rO%2FWorkspaceOptionsColumn.png?alt=media\&token=2d9d03c5-25e9-45cb-b398-ecb09f65da14)

When you create a copy of a workspace, the copy initially inherits the following workspace configuration:

* Source and destination database connections
* Sensitivity designations, including manual designations that override the sensitivity scan results
* Table mode assignments
* Generator configuration
* Subsetting configuration
* Post-job scripts

### Creating a child workspace <a href="#workspace-create-child" id="workspace-create-child"></a>

{% hint style="info" %}
**Required license:** Enterprise

**Required workspace permission:** Create child workspaces (in the parent workspace)
{% endhint %}

You can create a workspace that is a child of an existing workspace. You cannot create a child workspace of another child workspace.

The parent workspace must have a source database configured. You cannot create a child workspace from a workspace that uses the Databricks, self-managed Spark cluster, or MongoDB data connector.

To create a child workspace, either:

* On **Workspaces** view:
  * Click **Create Workspace > Child Workspace**.
  * Click the actions menu for the parent workspace, then select **Create Child Workspace**.
* On the workspace management view, from the workspace actions menu, select **Create Child Workspace**.

On the **New Workspace** view, under **Child Workspace**, **Parent Workspace** identifies the parent workspace.

If you used the **Create Workspace > Child Workspace** option to create the child workspace, then **Parent Workspace** is not populated. From the **Parent Workspace** dropdown list, select the parent workspace for the new child workspace.

If you selected the child workspace option for a specific workspace, then **Parent Workspace** is set to that workspace.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2Fist5TmvpFxxx5td2vACM%2FWorkspaceNewChild.png?alt=media&#x26;token=0587a2c2-4495-486f-a6ef-91044f23fb92" alt=""><figcaption><p>New Child Workspace view for a child workspace</p></figcaption></figure>

If you originally chose to create a completely new workspace, then on the **New Workspace** view:

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FfCmy7o8tJs65yv8wrIOX%2FWorkspaceCreateChildOption.png?alt=media&#x26;token=fada7fc3-89e4-48c4-9340-feea86ab4bf3" alt=""><figcaption><p>Create Child Workspace option on the New Workspace view</p></figcaption></figure>

1. To change to a child workspace, select **Create Child Workspace** from the **Create a child workspace** panel at the right.\
   \
   Structural adds the **Child Workspace** panel to the **New Workspace** view.
2. From the **Parent Workspace** dropdown list, select the parent workspace for the new child workspace.

## Editing a workspace <a href="#workspaces-edit" id="workspaces-edit"></a>

{% hint style="info" %}
**Required workspace permission:** Configure workspace settings
{% endhint %}

To edit the configuration for an existing workspace, either:

* On the workspace management view:
  * On the workspace navigation bar, click **Workspace Settings**.
  * From the workspace actions menu, select **Workspace Settings**.
* On **Workspaces** view, click the actions menu for the workspace, then select **Workspace Settings**.

## Deleting a workspace <a href="#workspaces-delete" id="workspaces-delete"></a>

{% hint style="info" %}
**Required workspace permission:** Delete workspace
{% endhint %}

You can delete workspaces that you no longer need.

You cannot delete a parent workspace. You must first delete all of its child workspaces.

To delete a workspace:

* On the workspace management view, from the workspace actions menu, select **Delete Workspace**.
* On the **Workspaces** view, click the actions menu for the workspace, then select **Delete**.
* On the **Workspace Settings** view, click **Delete Workspace**.