# Teamspaces

{% hint style="warning" %}
Requires various [permissions](https://documentation.proto.cx/docs/settings/workspace/roles-and-permissions) to view and edit the respective teamspace settings.
{% endhint %}

***

## Definition

Every workspace can have one or more teamspaces. These are collections of preferences that affect its associated AI agents, live agent teams, and the corresponding users and people they affect. For specifics on these preferences, jump to:

* [Banning](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/banning?tab=ban_rules)
* [Tags](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/tags?tab=tags)
* [Assignment](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/assignment)
* [Email Domains](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/email-domains)
* [Email Templates](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/email-templates)
* [Exports](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/exports)
* Livechat
  * [Canned Replies](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/livechat/canned-replies)
  * [Custom Fields](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/livechat/custom-fields)
* Tickets
  * [Custom Fields](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/tickets/custom-fields)
* Customers
  * [Profile iframe](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/customers/profile-iframe)
  * [Custom Fields](https://v3.proto.cx/w/sc/01HSWE652DMW6REJ1FB1135PRZ/settings/subcompany/customers/custom-fields)
* Analytics

***

## Configuration

To manage teamspaces, go to the [settings panel](https://documentation.proto.cx/docs/settings/settings). Under the "Workspace" category select **Teamspaces**.

### Create a Teamspace

1. In Teampace settings select **Create Teamspace.**
2. Edit the new teampace's settings as described below.
3. Select **Create**.

***

### Teamspace Settings

Select the **teampace** in the Teamspace table for its panel options:

* **Avatar** (optional) — an image to visually identify the teampace in Proto AICX.
* **Teamspace name** — the title of the eampace.
* **Description** (optional) — a short description to help orient users when viewing the Teampace table.

Press **Save** to commit any edits.

Existing teampaces have static fields with values that can be copied and utilized with the [Developer API](https://documentation.proto.cx/docs/developer-documentation/developer-api):

* **Teasmapce ID**
* **Takeover Secret**

***

### Delete a Teamspace

* In the Teampace table, select one or more teampace **checkboxes**.
* Select **Delete Teamspace** and confirm.