Creating a Workspace

This page covers creating a new Workspace and the choices made at create time. See Workspaces for an overview of what Workspaces are and when to use them.

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, CLI, and Terraform.

A New Workspace Starts Empty

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 Default Workspace

Before Workspaces are enabled on a Site, all existing resources (files, folders, users, groups, partners, automations, remote servers, syncs) live in the Default Workspace, which is the main Files.com site.

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.