Cloning a workspace makes another copy of the workspace under your own billing. Cloning creates a completely independent copy of the workspace in which you are the owner and sole user (until you choose to "share" your copy with someone else). You can experiment with code and data in your copy without running the risk of affecting a group workspace. Cloning is useful if you want to run computations in a workspace where you only have "read access."  Cloning a Featured Workspace that covers the research tasks you want to do, for example, is one way to jump into using Terra (without writing your own scripts or notebooks).

For information about collaborating in the same workspace by sharing the workspace, see this article. 

1. Locate the three vertical dots icon

Within the workspace

Click on the three vertical dots on the top right of your workspace Dashboard page.

From the "Workspaces" page

1.1. To access the full list of Terra workspaces available to you, click on View Workspaces from the Terra homepage app.terra.bio.

1.2. Click on the three vertical dots at the lower right of the card of the workspace you want to clone.

2. Complete the clone form

2.1. In the popup menu, choose Clone.

2.2. Type in your new workspace name, choose a billing project, and enter an Authorization Domain (if needed). 

2.3. Then click the Clone workspace button at the bottom of the form. 

You should see the newly cloned workspace in the "My Workspaces" section of the Workspaces page immediately.

Troubleshooting tip

If you get an error message that includes the phrase "Precondition failed" (see screenshot below), you have likely exceeded your Google project quota. To learn more about Google project quotas and how to request more, click here.