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

# Workspace settings

> Manage workspace name, avatar, context variables, and deletion

Workspace settings let you edit a workspace's identity and declare its Context
Variables. You can access them from the gear icon next to a workspace in the
workspace selector, which opens that workspace's **General** page without
switching to it, or from **Settings > Workspace**, where each workspace has its
own group of pages: **General**, **Context variables**, and
[**API keys**](https://docs.typewise.app/documentation/settings/api-keys.md).

***

## General

The **General** page lets you update the workspace's name, description, and
avatar.

* **Name**: the display name shown in the workspace selector, ticket filters,
  and team cards.
* **Description**: an optional note to help admins identify the workspace's
  purpose (e.g., "EU Support" or "Compliance team").
* **Avatar**: choose a color, emoji, or uploaded logo. See
  [avatar options](https://docs.typewise.app/documentation/workspaces/create-workspace.md) for details.

Click **Save** to apply your changes.

![Workspace settings: General](https://mintcdn.com/typewise/_bhTmVJiii6-b3Ia/images/documentation/workspaces/workspace-settings/general-tab.webp?fit=max\&auto=format\&n=_bhTmVJiii6-b3Ia\&q=85\&s=fc34124528a99ae7cdbe421fc8fdde62)

***

## Context Variables

The **Context variables** page lets you declare workspace-specific variables.
Each workspace maintains its own set, so different workspaces can pass different
data through to actions, lookups, and the AI Agent.

For details, see [Context Variables](https://docs.typewise.app/documentation/settings/context-variables.md).

![Workspace settings: Context variables](https://mintcdn.com/typewise/wWCsyrRix2Hpa5Kr/images/documentation/workspaces/workspace-settings/variable-registry-tab.webp?fit=max\&auto=format\&n=wWCsyrRix2Hpa5Kr\&q=85\&s=16a3d5365f16e9d5792cc4349913282f)

***

## Ticket labels

The Ticket labels tab holds the labels the AI Agent applies to this workspace's
conversations, such as `Angry customer` or `Churn risk`. Each workspace keeps
its own list of up to 30.

For details, see [Ticket labels](https://docs.typewise.app/documentation/settings/ticket-labels.md).

***

## Deleting a workspace

The **Danger zone** section at the bottom of the General page lets you
permanently delete a workspace.

> [!NOTE]
>
> The default workspace cannot be deleted. If you need to change which workspace
> is the default, contact support.

Deleting a workspace removes all of its configuration (behaviour, channels,
knowledge, actions, specialists, integrations, and Context Variables). Tickets
that belonged to the workspace remain accessible in the shared inbox and All
tickets view.

***

## See also

* [Workspaces overview](https://docs.typewise.app/documentation/workspaces/overview.md): Understand what is
  isolated vs shared
* [Create a workspace](https://docs.typewise.app/documentation/workspaces/create-workspace.md): Set up a new
  workspace
* [Import resources](https://docs.typewise.app/documentation/workspaces/import-resources.md): Copy resources
  between workspaces


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.