From 0761a05bb5d94fd14ae168970488042d8c684b32 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Wed, 22 Jul 2026 13:53:42 +0800 Subject: [PATCH] docs: add Workspaces documentation for Comfy Cloud - New cloud/workspace.mdx page covering Personal and Team workspaces - Feature flag availability note included - Fixed member limit to reflect 30-member cap (from teamWorkspaceStore.ts) - Replaced em dashes with colons or periods per style guide - Removed all ja/zh/ko translation files and localized nav entries - Added workspace links to get_started/cloud.mdx, interface/overview.mdx, support/subscription/managing.mdx, and docs.json English navigation --- cloud/workspace.mdx | 152 ++++++++++++++++++++++++++++++ docs.json | 1 + get_started/cloud.mdx | 10 +- interface/overview.mdx | 6 +- support/subscription/managing.mdx | 20 ++++ 5 files changed, 187 insertions(+), 2 deletions(-) create mode 100644 cloud/workspace.mdx diff --git a/cloud/workspace.mdx b/cloud/workspace.mdx new file mode 100644 index 000000000..30b0c2bf2 --- /dev/null +++ b/cloud/workspace.mdx @@ -0,0 +1,152 @@ +--- +title: "Workspaces" +description: "Learn how to use workspaces in Comfy Cloud to collaborate with your team members" +sidebarTitle: "Workspaces" +icon: "users" +--- + +import CloudFeature from '/snippets/cloud-feature.mdx' + + + + + Workspaces are enabled by a server-side feature flag and may not be available to all Comfy Cloud users yet. If you do not see workspace features in your interface, they may not be enabled for your account yet. + + +## Overview + +Workspaces in Comfy Cloud allow you to organize your work and collaborate with team members. Each user has a **Personal** workspace for individual use and can create or join **Team** workspaces to share Comfy Cloud resources with others. + +## Workspace types + +There are two types of workspaces: + +| Type | Description | +|------|-------------| +| **Personal** | Your private workspace. Automatically created for every user. Cannot be deleted. | +| **Team** | A shared workspace where you can invite members and collaborate. Created by users with a plan that supports multiple seats. | + +## Personal workspace + +Your Personal workspace is your default workspace when you first use Comfy Cloud. It is a single-user space. Only you have access to it. You cannot invite others to your Personal workspace or leave it. + +## Team workspaces + +Team workspaces let you work together with other Comfy Cloud users. Members of a team workspace share the workspace's subscription plan, credits, and billing. + +### Creating a team workspace + +To create a new team workspace: + + + + Click your workspace avatar or name in the top navigation bar to open the workspace switcher popover. + + + Click **Create workspace** at the bottom of the popover. Alternatively, navigate to the workspace settings panel and create one from there. + + + Enter a workspace name (1-50 characters) and click **Create**. The name must start with a letter or number and can contain letters, numbers, spaces, and common punctuation (`- _ ' . , ( ) & +`). + + + After creation, you will be automatically switched to the new workspace. + + + + + Each user can own up to **10 team workspaces**. You can be a member of additional workspaces owned by other users. + + +### Workspace roles + +Each member of a team workspace has one of the following roles: + +| Role | Permissions | +|------|-------------| +| **Owner** | Full control: manage members, invite/revoke invites, rename workspace, delete workspace, manage subscription, top up credits | +| **Member** | View other members, leave workspace. Cannot invite others, manage billing, or delete the workspace | + +### Managing members + +As an owner of a team workspace, you can: + +- **Invite members** by email. An invite link is generated and sent to the recipient. +- **Remove members** from the workspace +- **Revoke pending invites** that haven't been accepted yet + +To access member management: + +1. Open the workspace settings panel (click your workspace avatar, then workspace name) +2. Go to the **Members** tab +3. Click the **+** button to invite a new member + +#### Invite members + +When you invite a member: + +1. Enter the recipient's email address +2. A unique invite link is generated +3. Share the invite link with the recipient +4. The recipient accepts the invite by visiting the link (they must have or create a Comfy Cloud account) + + + Invites have an expiration date. Pending invites show their expiry time in the members panel. You can revoke invites that haven't been accepted yet. + + +#### Invite limits + +- Each team workspace is limited to **30 members** including pending invitations +- If you're on a single-seat plan, you'll be prompted to upgrade before you can invite members + +### Workspace settings + +As an owner, you can: + +- **Rename** the workspace from the workspace menu +- **Delete** the workspace (not available if the workspace has an active subscription. Cancel the subscription first.) + +As a member, you can: + +- **Leave** the workspace from the workspace menu + +### Switching between workspaces + +To switch between your workspaces: + +1. Click your workspace avatar or name in the top navigation bar +2. Select the workspace you want to switch to from the list +3. The page will reload and switch to the selected workspace + +Your last active workspace is remembered across browser sessions. + +### Billing and subscription + +Each workspace has its own billing and subscription: + +- **Personal workspaces** use your personal subscription +- **Team workspaces** can have their own subscription plan +- As an owner, you can manage the workspace subscription, top up credits, and view billing status from the **Plan & Credits** tab in workspace settings +- Workspace members share the workspace's credits and resources + +## URL shortcuts + +You can use URL parameters to access workspace features directly: + +| URL | Action | +|-----|--------| +| `?create_workspace=1` | Opens the create workspace dialog | +| `?invite=TOKEN` | Accepts a workspace invite | + +## FAQ + +### Can I have multiple team workspaces? +Yes, you can own up to 10 team workspaces and be a member of additional workspaces owned by others. + +### Can I delete my Personal workspace? +No. Your Personal workspace is permanent and cannot be deleted. It serves as your default workspace. + +### What happens when I leave a team workspace? +The workspace will no longer appear in your workspace list. You'll lose access to the workspace's workflows and resources. + +### Can a workspace be recovered after deletion? +No. Deleting a workspace is permanent. You must cancel any active subscriptions before deleting a workspace. diff --git a/docs.json b/docs.json index 3457c18be..a868452e2 100644 --- a/docs.json +++ b/docs.json @@ -141,6 +141,7 @@ "group": "Cloud Exclusive", "icon": "cloud", "pages": [ + "cloud/workspace", "cloud/share-workflow", "cloud/import-models" ] diff --git a/get_started/cloud.mdx b/get_started/cloud.mdx index 6c7b3230b..b03c228a6 100644 --- a/get_started/cloud.mdx +++ b/get_started/cloud.mdx @@ -31,6 +31,10 @@ ComfyUI Cloud is the cloud version of ComfyUI with the same features as the loca Use ComfyUI from any device with an internet connection - no local installation needed + + + Create team workspaces to collaborate with your team members. Share subscription plans, credits, and workflows + ## Cloud vs local @@ -45,7 +49,7 @@ ComfyUI offers both an official cloud version, [Comfy Cloud](https://comfy.org/c | **Technical Knowledge** | No technical knowledge required. | While desktop and portable give you easy ways to get started, you'll need to troubleshoot custom node installations and local installation issues. | | **Custom Nodes** | Use pre-installed custom nodes and never worry about compatibility issues. | Install any custom node you want, but you'll need to manage it yourself. | | **Models** | Use pre-installed models. Import LoRA models from Civitai. Import models from Hugging Face (coming soon). | Use any models you want, but you'll need to download them first. | -| **Notable Differences** | Easy to onboard your team | Works offline, infinitely customizable | +| **Notable Differences** | Easy to onboard your team with [Workspaces](/cloud/workspace) | Works offline, infinitely customizable | | **Get started** | [Run ComfyUI Cloud](https://comfy.org/cloud) | [Install ComfyUI locally](/installation/system_requirements) | @@ -55,6 +59,10 @@ ComfyUI offers both an official cloud version, [Comfy Cloud](https://comfy.org/c View pricing and subscription options for Comfy Cloud + + Learn about Workspaces in Comfy Cloud: create team workspaces, manage members, and collaborate + + ## How to use ComfyUI Cloud diff --git a/interface/overview.mdx b/interface/overview.mdx index f14e89062..feaa0f402 100644 --- a/interface/overview.mdx +++ b/interface/overview.mdx @@ -47,7 +47,7 @@ Currently, apart from the main workflow interface, the ComfyUI interface is main 4. **Top Area**: Displays the currently opened workflow. 5. **New Workflow Button**: Click to create a new blank workflow file. 6. **Right Control Area**: Run and queue control management, where you can run workflows and view the queue. -7. **Login Status**: Not displayed by default, only shown after login, used when closed-source Partner Nodes are required. +7. **Login Status**: Not displayed by default, only shown after login, used when closed-source API nodes are required. 8. **Quick Access Button**: Opens the right-side panel. **Bottom Right Canvas Controls:** @@ -63,6 +63,10 @@ In the current ComfyUI, we provide four side panels with the following functions 3. Model Library: Models in your local `ComfyUI/models` directory can be found here 4. Local User Workflows (Workflows): Your locally saved workflows can be found here + + If you are using **Comfy Cloud**, you can also create and manage **Team Workspaces**: shared spaces where you can collaborate with team members, invite others, and share subscription credits. Learn more in the [Workspaces](/cloud/workspace) documentation. + + ## Old Menu Version Currently, ComfyUI enables the new interface by default. If you prefer to use the old interface, you can click the **Settings gear icon** and then set `Use new menu` to `disabled` under `Comfy` --> `Menu` to switch to the old menu version. diff --git a/support/subscription/managing.mdx b/support/subscription/managing.mdx index 7a28721f7..12c0c3197 100644 --- a/support/subscription/managing.mdx +++ b/support/subscription/managing.mdx @@ -17,3 +17,23 @@ To manage your Comfy Cloud subscription: 4. Click **Manage subscription** This will take you to Stripe, where you can manage your subscription details. + + + The subscription management above applies to **Personal workspaces**. For Team workspaces, subscription management is done from the workspace settings panel. Only the workspace **Owner** can manage the subscription. See [Workspaces](/cloud/workspace) for more details. + + +## Personal vs Team workspace subscriptions + +Comfy Cloud subscriptions are tied to **workspaces**, not to individual user accounts: + +| Aspect | Personal Workspace | Team Workspace | +|-------|-------------------|----------------| +| **Subscription owner** | You (the user) | Workspace Owner | +| **Credits** | Your personal credits | Shared across all members | +| **Multi-seat** | Single seat | Multiple seats (plan-dependent) | +| **Switching** | Switch to any team workspace | Switch back to personal anytime | + +- Your **Personal workspace** uses your personal subscription. Credits and seats are for your sole use. +- **Team workspaces** have their own subscription managed by the workspace Owner. Credits are shared among all members. +- When you switch to a team workspace, the workspace's credits and billing apply. +- Switching back to your Personal workspace restores your personal subscription context.