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

# Workspaces

> Workspaces are your top-level environment in Promptr: solo for personal use, team for collaboration.

A workspace is the top-level container for everything in Promptr. All your Spaces, blocks, tags, and members live inside a workspace. When you log in, you're always working inside a workspace.

<Note>
  You can belong to multiple workspaces, for example a personal Solo workspace and one or more Team workspaces you've been invited to join. Use the workspace switcher in the sidebar to move between them.
</Note>

## Workspace types

<CardGroup cols={2}>
  <Card title="Solo" icon="user">
    A personal workspace just for you. There are no other members, no team billing, and no collaboration features. Use a Solo workspace for personal prompt libraries, individual projects, or experimentation.
  </Card>

  <Card title="Team" icon="users">
    A collaborative workspace for multiple people. Team workspaces support invitations, shared Spaces, member roles, and a subscription-based billing plan. Use a Team workspace when you want to share blocks across a group.
  </Card>
</CardGroup>

## Switching workspaces

If you belong to more than one workspace, you can switch between them using the workspace switcher in the sidebar. Switching workspaces changes the entire context. You'll see only the Spaces, blocks, and tags that belong to the workspace you're currently in.

## Workspace settings

The workspace owner controls the following settings from **Workspace settings → General**:

* **Name:** the display name visible to all members.
* **Logo:** an optional custom image; falls back to the workspace's initial if none is set.

### Member permissions

On Team workspaces, the owner can grant or restrict what regular members are allowed to do:

<AccordionGroup>
  <Accordion title="Allow members to invite others">
    When enabled, any workspace member (not just the owner) can send invitations to new people. When disabled, only the owner can invite.
  </Accordion>

  <Accordion title="Allow members to create tags">
    When enabled, members can create new workspace-level tags to attach to blocks. When disabled, only the owner can create tags.
  </Accordion>

  <Accordion title="Allow members to manage tags">
    When enabled, members can rename, recolor, and delete existing tags. When disabled, only the owner can modify tags.
  </Accordion>
</AccordionGroup>

These settings are available under **Workspace settings → Members**.

## Tags

Tags are workspace-level labels you attach to blocks for filtering and organization. They have a name and a color, and they're shared across all Spaces in the workspace, so a tag you create in one Space is available in every other Space in the same workspace.

You manage all workspace tags from **Workspace settings → Tags**. Depending on the permission settings above, members may also be able to create or manage tags directly from the block editor.

## Member roles

Team workspaces have two roles:

| Role       | Description                                                                                                                                                   |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Owner**  | Full control over the workspace: settings, billing, member management, tag management, and deletion.                                                          |
| **Member** | Can browse and use Spaces and blocks according to Space visibility rules. Additional capabilities depend on the permission settings the owner has configured. |

A workspace must always have at least one owner. If you are the last owner, you cannot leave the workspace. You must transfer ownership or delete the workspace first.

## Plan and billing

Solo workspaces are free. Team workspaces require an active subscription to remain accessible. Billing is managed by the workspace owner from **Workspace settings → Billing**.

Subscription statuses that affect access:

| Status       | Effect                                                  |
| ------------ | ------------------------------------------------------- |
| `active`     | Full access for all members.                            |
| `trialing`   | Full access during the trial period.                    |
| `past_due`   | Access may be restricted until payment is resolved.     |
| `paused`     | Access suspended. Trial ended without a payment method. |
| `canceled`   | Access revoked.                                         |
| `incomplete` | Checkout was started but payment was not completed.     |

If a Team workspace is blocked due to a billing issue, the owner is directed to the Billing tab to resolve it. Other members see a blocked state until the subscription is restored.
