Create a workspace for collaboration

In P4 One, each project has its own folder where you store files and subfolders related to the project. This folder is a workspace. For example, a workspace may contain a 3D scene with hundreds of textures and scene files, or a 2D project with one file.

You must create a workspace before you start working files in P4 One.

If you are collaborating with others on a project, your workspace must be connected to P4.

On this page:

Decide the best method to create a workspace

Before you create the workspace, decide the best way to do it based on your setup and needs.

To create a workspace that is connected to an existing P4 stream depot, follow the steps on this page. If your project is stored in P4 local depot, use one of the following options to set up your workspace instead.
To create a new workspace using settings from an existing P4 workspace, see Create a workspace for collaboration using settings from an existing P4 workspace.
To use an existing P4 workspace with both P4 and P4 One, see Use an existing P4 workspace for collaboration.

After you connect the workspace to P4 One, you can continue to use it with other P4 clients.

If you working on a new project independently and not collaborating with others, follow the steps in Create a workspace for yourself.

Create the workspace

In the navigation pane, under Workspaces, click Create.

In the Create a workspace dialog box, click For collaboration.
Click Create a workspace.
In the Connect to P4 dialog box, select the P4 connection to create the workspace for.
- If the P4 connection is not available in the list, click Add to add a new connection. Enter the information provided by your P4 administrator and then click Sign in:
  - Server address:P4 Server address and port. Example: ssl:files.wysicorp.com:1666.
  - Username: Your P4 username.
  - Password: Your P4 password (required). To log in using single sign-on (SSO), click Sign in with SSO. The Password field is hidden. To switch back to using a password, click Sign in with password.
- If you are not connected to the selected P4 connection, you are prompted to sign in. Enter your credentials and click Sign in. To sign in using single sign-on (SSO), click Sign in with SSO.
Click Continue.
Select the Depot and Stream on the P4 Server that contains the project files. If you do not know the depot or stream, ask another team member or your P4 administrator for help.
The Workspace Name field contains an automatically-generated name. You can change the name to uniquely identify your project. To get a new generated name, click the refresh button.
In the Workspace Path field, a default path for the workspace on your computer is displayed. You can enter a different location or click the browse files button to select a different location. If you do not want to include the workspace name in the path, clear Include workspace name in path.

By default, workspaces are stored in the following locations:
- macOS: /Users/<YourUsername>/Documents/PerforceP4 One/<WorkspaceName>
- Windows: C:\Users\<YourUsername>\Documents\PerforceP4 One\<WorkspaceName>
Do not store workspaces in a cloud storage service, such as OneDrive or Google Drive because you may experience performance issues.

Click Create Workspace.

The workspace is created on your computer and opens in P4 One. The new workspace is also displayed in the Recent Workspaces list in the navigation pane.

A .p4one hidden folder and a few configurations are now in the root folder of the workspace folder to facilitate communication with P4 Server.

What's next

Start working with files in your project in P4 One. See Work with items in the file view