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

# Workspace Settings

> Learn how to manage your workspace, including renaming and deleting workspaces

## Overview

Workspace settings allow you to manage your workspace configuration, including updating your workspace name and permanently deleting the workspace when it's no longer needed.

<Info>
  Only workspace owners have access to all settings. Admins and members have limited access based on their role.
</Info>

## Accessing Workspace Settings

To access your workspace settings:

<Steps>
  <Step title="Open Settings">
    Click on **Settings** in the left sidebar navigation.
  </Step>

  <Step title="Select Workspace">
    Click on **Workspace** in the settings menu to open the workspace settings page.
  </Step>
</Steps>

## Workspace Information

The workspace information section displays your current workspace name and allows you to update it.

### Renaming Your Workspace

You can change your workspace name at any time to better reflect its purpose or organization:

<Steps>
  <Step title="Navigate to Workspace Settings">
    Go to **Settings** → **Workspace** from the sidebar.
  </Step>

  <Step title="Edit the Name">
    In the **Workspace Information** card, update the **Workspace Name** field with your new name.
  </Step>

  <Step title="Save Changes">
    Click **Save Changes** to update the workspace name.
  </Step>
</Steps>

<Tip>
  Choose a descriptive name that clearly indicates the workspace's purpose. This helps team members quickly identify the right workspace when switching between multiple workspaces.
</Tip>

### Workspace Name Guidelines

When naming your workspace, keep these guidelines in mind:

| Guideline                 | Description                                                                 |
| ------------------------- | --------------------------------------------------------------------------- |
| **Be descriptive**        | Use names like "Marketing Team", "Customer Support", or "Acme Corp Project" |
| **Keep it concise**       | Names should be easy to read and recognize at a glance                      |
| **Use consistent naming** | If you have multiple workspaces, use a consistent naming convention         |

## Danger Zone

The danger zone contains irreversible actions that can permanently affect your workspace. These options are highlighted with a red border to indicate their critical nature.

### Deleting a Workspace

<Warning>
  Deleting a workspace is permanent and cannot be undone. All agents, knowledge sources, conversations, and data associated with the workspace will be permanently deleted.
</Warning>

Only workspace **owners** can delete a workspace. Before deleting, consider:

* Have you exported any important data or conversations?
* Are there team members who still need access to the agents?
* Is there any content you want to preserve?

#### Steps to Delete a Workspace

<Steps>
  <Step title="Open Workspace Settings">
    Navigate to **Settings** → **Workspace**.
  </Step>

  <Step title="Locate the Danger Zone">
    Scroll down to find the **Danger Zone** section highlighted with a red border.
  </Step>

  <Step title="Click Delete">
    Click the **Delete** button next to "Delete Workspace".
  </Step>

  <Step title="Confirm Deletion">
    A confirmation dialog will appear. To proceed:

    * Read the warning message carefully
    * Type the exact workspace name in the confirmation field
    * Click **Delete Workspace** to confirm
  </Step>
</Steps>

<Note>
  Copy-pasting the workspace name into the confirmation field is disabled for safety. You must type the name manually to confirm deletion.
</Note>

#### What Happens When You Delete a Workspace

When a workspace is deleted:

| Item                  | What Happens                                        |
| --------------------- | --------------------------------------------------- |
| **Agents**            | All agents in the workspace are permanently deleted |
| **Knowledge Sources** | All web, text, and Q\&A sources are removed         |
| **Conversations**     | Chat history and conversation data are deleted      |
| **Team Members**      | All member access is revoked immediately            |
| **Settings**          | Widget configurations and customizations are lost   |

After deletion, you'll be redirected to:

* **Create Workspace** page if you have no other workspaces
* **Agents** page of another workspace if you belong to multiple workspaces

## Permissions Overview

Different roles have different access to workspace settings:

| Action                  | Owner | Admin | Member |
| ----------------------- | ----- | ----- | ------ |
| View workspace settings | Yes   | Yes   | Yes    |
| Rename workspace        | Yes   | No    | No     |
| Delete workspace        | Yes   | No    | No     |
| Manage team members     | Yes   | Yes   | No     |

<Info>
  For detailed information about managing team members and invitations, see the [Team Members](/workspace/members) documentation.
</Info>

## Troubleshooting

<AccordionGroup>
  <Accordion icon="lock" title="Cannot access workspace settings">
    Make sure you're signed in and have selected the correct workspace from the workspace dropdown. If you still can't access settings, you may not have the required permissions.
  </Accordion>

  <Accordion icon="floppy-disk" title="Changes not saving">
    If your changes aren't saving, check your internet connection and try again. If the problem persists, refresh the page and re-enter your changes.
  </Accordion>

  <Accordion icon="trash" title="Delete button is disabled">
    The delete button may be disabled if:

    * You don't have owner permissions
    * A delete operation is already in progress
    * There's a temporary system issue
  </Accordion>

  <Accordion icon="input-text" title="Confirmation text not matching">
    When deleting a workspace, you must type the workspace name exactly as shown, including capitalization and spaces. Copy-paste is disabled for safety.
  </Accordion>
</AccordionGroup>

## Best Practices

<CardGroup cols={2}>
  <Card title="Backup Before Deleting" icon="download">
    Before deleting a workspace, export any important conversation data or agent configurations you may need later.
  </Card>

  <Card title="Communicate with Team" icon="comments">
    If you're deleting a shared workspace, notify team members in advance so they can save any information they need.
  </Card>

  <Card title="Use Descriptive Names" icon="tag">
    Keep workspace names clear and descriptive to help team members identify the right workspace quickly.
  </Card>

  <Card title="Review Before Confirming" icon="eye">
    Always double-check that you're deleting the correct workspace. The confirmation step exists to prevent accidental deletions.
  </Card>
</CardGroup>

## Getting Help

A **Help** section is available in the sidebar directly below Settings. Use it to contact the Humanizing support team without leaving the app.

<CardGroup cols={2}>
  <Card title="Report a Bug" icon="bug">
    Describe unexpected behavior. The form opens pre-filled for a bug report and supports screenshots (paste or upload) and file attachments.
  </Card>

  <Card title="Request a Feature" icon="lightbulb">
    Share an idea or improvement. The form opens pre-filled for a feature request. You can switch between request types inside the form.
  </Card>
</CardGroup>

<Tip>
  The Help section is available both in the workspace sidebar and in the agent detail sidebar so you can reach support from wherever you are in the app.
</Tip>

## Next Steps

<CardGroup cols={2}>
  <Card title="Manage Team Members" icon="users" href="/workspace/members">
    Learn how to invite team members and manage their roles.
  </Card>

  <Card title="Create an Agent" icon="robot" href="/agents/onboarding">
    Build your first AI agent for your workspace.
  </Card>
</CardGroup>