Skip to main content
Documentation

Creating a Workspace

Only Site Administrators can create Workspaces. When a Site Administrator creates a Workspace, the Workspace gets its own root folder automatically.

Workspaces can be created through the Web App. They can also be provisioned automatically as part of onboarding workflows or infrastructure-as-code practices through the API/SDKs, CLIExternal LinkThis link leads to an external website and will open in a new tab, and Terraform.

A New Workspace Starts Fresh

When a Site Administrator creates a new Workspace, it starts as a clean slate. No files, folders, users, groups, partners, automations, syncs, or integrations carry over from the main site. The Workspace Administrator builds out the environment from scratch, creating the folder structure, onboarding users and partners, and configuring automations and integrations for their team, department, or business unit.

Creating a new Workspace does not move or remove any existing resources from the main site. All existing files, folders, users, groups, partners, automations, and integrations on the main site remain unchanged.

The new Workspace's root folder uses the same storage region as the site's root folder at the time of creation; changing the site's root folder region later does not update existing Workspaces.

The Default Workspace

Every Files.com site has a Default Workspace, which is the main site itself. Sites that don't use additional Workspaces run entirely within the Default Workspace. All resources (files, folders, users, groups, partners, automations, remote servers, syncs) live in the Default Workspace until additional Workspaces are created.

Designating Workspace Administrators

After creating a Workspace, the Site Administrator designates one or more Workspace Administrators to manage it. The Site Administrator can:

  • Create a new user for the Workspace and assign the Workspace Administrator role to them. This is common when onboarding a new business unit, department, or team onto the Files.com site.
  • Promote an existing user on the main site to the Workspace Administrator role.
  • Assign the Workspace Administrator role to a user who is already a Workspace Administrator for another Workspace. A user can be a Workspace Administrator for multiple Workspaces and can switch between them independently.

Site Administrators do not need to be designated as Workspace Administrators because they already have full access to all Workspaces.