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

# Move a file to another workspace

> Send a file from one of your workspaces to another: who can move it, what comes along and what doesn't, and what to do when no workspace is listed.

Move a file when it belongs to a different team, or out of your personal workspace into a team's. The file keeps its pages and history, and the people in its new workspace can open it.

**Before you start** · Web and desktop · Free plan

## Who can move a file

You need both of these:

* **In the file's current workspace,** you're the owner or an admin, and you can edit there. When a team workspace is on the Free plan, or its subscription has lapsed, only its owner can edit. In your personal workspace, you're the owner.
* **In the workspace you're moving it to,** you're at least an editor, and you can edit there. The same rule applies: a team workspace on the Free plan, or with a lapsed subscription, only takes files from its owner.

Editors and viewers don't see **Move to workspace**. See [Members and roles](https://wonder.design/docs/members-and-roles.md).

## Move a file

1. Go to your files and find the file.
2. Click **⋯** on the file, or right-click it, and choose **Move to workspace**.
3. Choose the workspace to move it to. Wonder shows the destination's name and address under the list.
4. Click **Move file**.

Wonder shows **File moved to workspace**, and the file leaves your current workspace's files.

You can also ask your agent to move a file through the [Wonder MCP](https://wonder.design/docs/wonder-mcp-tools.md#files-folders-and-pages). The same rules apply.

## What moves with the file and what doesn't

| | After the move |
| - | - |
| **Pages and history** | Stay with the file. |
| **Who can open it** | The members of the new workspace. Members of the old workspace lose access unless they're also in the new one, or the file is public. |
| **Public or private** | Stays the same. A public file stays public, now under the new workspace. |
| **Folder** | Removed. The file sits outside any folder in the new workspace. |
| **Pin** | Removed. Pin it again in the new workspace if you want it pinned. |
| **Published Preview links** | Taken down. Publish again after the move. See [Publish your app](https://wonder.design/docs/publish-your-app.md). |

Anyone who has the file open in its old workspace is taken out of it and sees **This file was moved to another workspace by another member.** Members of the new workspace find it in that workspace's files.

## Which workspaces are listed

The list shows every other workspace you belong to that can take the file:

* you're an editor, admin or owner there, and you can edit there (it isn't a team workspace on the Free plan, unless you're its owner);
* it hasn't reached its file limit;
* a private file has no more pages than the workspace allows. See [Plans and limits](https://wonder.design/docs/plans-and-limits.md#limits-on-every-plan).

If none can, the dialog says **No workspace is eligible. You need editor access and enough space within the destination's limits.**

![The Move to workspace dialog: the file keeps its pages and history, access follows the destination workspace, and its folder, pin and GitHub connection will be removed. Below, No workspace is eligible, with Cancel and a disabled Move file button](https://mintcdn.com/wonder-0722b0f6/FAcJgcaD_LvDyRge/images/workspaces/move-to-workspace.webp?fit=max\&auto=format\&n=FAcJgcaD_LvDyRge\&q=85\&s=15ed776a501555e55335c97107bfe04e)

To get a workspace into the list, ask its owner or an admin to invite you as an editor or admin (see [Members and roles](https://wonder.design/docs/members-and-roles.md#invite-people)), or create a workspace of your own (see [Workspaces](https://wonder.design/docs/workspaces.md#create-a-team-workspace)). Then open **Move to workspace** again.

## If something goes wrong

* **You don't see Move to workspace.** Only owners and admins of the file's workspace can move it, and only while they can edit there. Ask an owner or admin to move it for you.
* **No workspace is eligible.** No other workspace you belong to can take the file. See [Which workspaces are listed](#which-workspaces-are-listed).
* **The list of workspaces doesn't load.** Read the message in the dialog, then click **Try again**.
* **The destination workspace has reached its limit of 10,000 files.** Email the address in the message to ask for more, or choose another workspace.
* **This file has more pages than the destination workspace allows.** Delete some pages, or choose another workspace.
* **Wait for this file's preview to finish publishing, then move the file again.** A publish from this file is still running. Wait for it to finish, then move the file.
* **This workspace is on the free plan. Only the owner can edit.** The destination is a team workspace whose subscription has lapsed, and you're not its owner. Ask the owner to upgrade, or choose another workspace.
* **This file changed while it was being moved.** Someone else moved the file, or made it public or private, at the same moment. Move it again.

## Related

* [Files and folders](https://wonder.design/docs/files-and-folders.md)
* [Workspaces](https://wonder.design/docs/workspaces.md)
* [Members and roles](https://wonder.design/docs/members-and-roles.md)
* [Share a file](https://wonder.design/docs/share-a-file.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.