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

# Managing workspaces

> Create, rename, soft-delete, restore, or permanently delete a workspace.

Operations on a workspace: create, update name/slug/logo, switch between workspaces, soft-delete (trash), restore, permanent delete.

## How to create

<Steps>
  <Step title="Open workspace switcher">
    Top-left of the dashboard → **+ New workspace**.
  </Step>

  <Step title="Name + slug">
    Name is the display name. Slug must be lowercase letters, numbers, and hyphens; if you don't specify one, the system generates it from the name.
  </Step>

  <Step title="Done">
    You become the **owner**. The workspace gets the system default short domain attached automatically. UTM rules start at defaults.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/utm-e577acb5/_OFWyAVC_YtnhKc0/images/createnewworkspace.png?fit=max&auto=format&n=_OFWyAVC_YtnhKc0&q=85&s=f6ce60f8abca48dd1c775b4884e1c2bd" alt="Create new workspace modal - workspace name and slug fields" width="1920" height="991" data-path="images/createnewworkspace.png" />
</Frame>

## How to update

<Steps>
  <Step title="Open workspace settings">
    Sidebar → **Settings** → **Workspace** (or `/{slug}/settings`).
  </Step>

  <Step title="Edit name, slug, logo">
    * Name: case-insensitive unique per owner.
    * Slug: must remain unique globally.
    * Logo: image upload.
  </Step>
</Steps>

## How to delete

Two-stage delete process for safety:

<Frame>
  <img src="https://mintcdn.com/utm-e577acb5/nHQFp_ZWa_EOApO0/images/workspacesoftharddelete.png?fit=max&auto=format&n=nHQFp_ZWa_EOApO0&q=85&s=930d0c4cf691230afa97fadfd4d0f91a" alt="Delete workspace panel showing soft delete and permanent delete options" width="1919" height="958" data-path="images/workspacesoftharddelete.png" />
</Frame>

<Steps>
  <Step title="Soft delete (trash)">
    Settings → **Danger zone** → **Delete workspace**. Type `delete/{slug}` to confirm.

    The workspace moves to trash. Members get a notification email. **Workspace remains restorable for 7 days.**
  </Step>

  <Step title="Find and restore a soft-deleted workspace">
    The next time you log in, soft-deleted workspaces appear in the workspace selector as **Deactivated workspaces**. Select it and click **Restore**. Owner only. Workspace becomes active again, members regain access.
  </Step>

  <Step title="Permanent delete">
    After 7 days, the workspace is purged automatically. Or owner can hard-delete immediately by confirming again - owner email gets a final confirmation.

    All data is gone: links, click history, templates, domains, members. Cannot be recovered.
  </Step>
</Steps>

<Warning>
  Permanent delete is irreversible. Click history, custom domains (DNS records remain - you must reassign), member access, and billing history are removed. Export anything you need first.
</Warning>

## Real-world example

Closing out an agency client:

```text theme={null}
Day 0:    Soft-delete "Client: Soylent". Members get email.
Day 1-6:  Client requests final reports - restore, export, soft-delete again.
Day 7+:   Auto-purged. Custom domain (soy.link) becomes orphan; client takes it back via DNS.
```

## Common mistakes

<AccordionGroup>
  <Accordion title="Confusing soft-delete with deactivate">
    Soft-delete blocks workspace use. There's no "pause" mode short of removing members and not creating new links.
  </Accordion>

  <Accordion title="Deleting a workspace with active subscriptions">
    Soft-delete doesn't cancel subscriptions automatically. Cancel billing first via the billing page.
  </Accordion>
</AccordionGroup>

## Edge cases

<Note>
  **Only the owner can delete.** Even an `admin` cannot delete the workspace or manage billing - those two are owner-only. `member` and `viewer` roles cannot delete either.
</Note>

<Note>
  **Soft-deleted workspace links still redirect**, until the 7-day purge. After purge, they stop working and show a "not found" page. If your custom domain is on the workspace, plan the cutover.
</Note>