> Documentation index: [/llms.txt](/llms.txt). Every page as one file: [/llms-full.txt](/llms-full.txt).

# Copy an app to another workspace

Copy an app to another workspace [#copy-an-app-to-another-workspace]

A copy is a separate app in the other workspace, owned by you; the original stays where it is and keeps working.

You can copy an app you can open if you are a member of the workspace it was built in. The copy goes into any other workspace where your role has **Create Agents** (every built-in role has it).

Copy an app [#copy-an-app]

1. In the workspace the app was built in, select **Apps** in the sidebar.

2. Point at the app's card and select **Copy to workspace**.

3. Select the workspace to copy into, then **Copy**.

   <img alt="The Copy to workspace dialog for Acme Feedback Tracker with the Acme Support workspace selected" src="__img0" />

4. Switch to that workspace. The copy is on its **Apps** page, marked **Copied**.

   <img alt="The copy of Acme Feedback Tracker in Acme Support, marked Copied and Update available" src="__img1" />

* The copy starts the first time someone opens it, which can take a moment.
* Copying the same app into the same workspace again does not make a second copy: the message says the app is already there.
* **Copy to workspace** is missing on an app whose files have not been saved yet, and on an app with more than 100 MiB of files.

What the copy takes along [#what-the-copy-takes-along]

| Part                                  | In the copy                                                                                                                          |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| The app's code and the files in it    | Copied as the original last saved them.                                                                                              |
| The agent that builds the app         | Copied as its published version, so you can change the copy by chatting.                                                             |
| Connections the app and its agent use | Copied. Connections that sign in each person separately need every member to connect again; the message after copying says how many. |
| The agent's knowledge files           | Copied into the other workspace's Library.                                                                                           |
| Secrets                               | Copied, except the app's own Alomana key, which is replaced by a new one in your name.                                               |
| Name                                  | Unchanged.                                                                                                                           |
| Visibility                            | **Space** if the other workspace has other members, otherwise **Private**, whatever the original's.                                  |
| Version                               | Starts again at **v1**.                                                                                                              |
| Chat history                          | Not copied. The copy has a new, empty chat.                                                                                          |
| Data the app shows from connectors    | Not copied. The copy loads it for each person who opens it.                                                                          |

Update a copy from the original [#update-a-copy-from-the-original]

When the original changes after you copied it, the copy's card shows **Update available**.

1. Select **Update available** on the copy's card.
2. The copy takes the original's latest code and files, and restarts the next time it is opened.

* Updating replaces the copy's code and files, including changes you made to the copy by chatting.
* Secrets, visibility, name, description and the copy's agent stay as they are.
* You need to be able to change the copy, and still be a member of the original's workspace.
* If the original was deleted, the message says there is nothing to update from.

For copying apps with an API key, see [Hosted agent apps](/docs/api/configurable-agents/apps) in the API documentation.
