---
title: Workspaces Overview
description: "Understand the multi-workspace concept in FileRelay and how workspaces provide isolation for different environments."
---

# Workspaces Overview

Workspaces are the top-level organizational unit in FileRelay. They provide complete isolation between different environments, ensuring that sources, destinations, connections, team members, and documents are fully separated.

## Why Workspaces?

Most SAP landscapes have multiple systems -- development, quality assurance, staging, and production. Each system has its own document flow requirements, and you need clear separation between them. Workspaces give you that separation within a single FileRelay deployment.

Common workspace configurations:

| Workspace      | Purpose                                         |
|----------------|------------------------------------------------|
| Development    | Testing new connections and routing rules        |
| QA / Staging   | Validating configuration before production       |
| Production     | Live document archiving for business operations  |

You might also use workspaces to separate different SAP systems entirely -- for example, one workspace for your ECC system and another for S/4HANA.

## Workspace Isolation

Everything in FileRelay is scoped to a workspace. This means:

- **Sources** belong to a single workspace. A repository ID is unique within a workspace.
- **Destinations** (connectors) are configured per workspace. An S3 bucket in your production workspace is completely independent from one in development.
- **Connections** link sources to destinations within the same workspace. Cross-workspace connections are not possible.
- **Team members** are invited per workspace. A user can have admin access in development but only viewer access in production.
- **Documents** are tracked per workspace. The documents dashboard shows only documents for the current workspace.
- **API keys** are scoped to a workspace. A key created in production cannot access development data.
- **Usage and audit data** are tracked per workspace; aggregated counters are also available at the deployment level for capacity planning.

## The Workspace Switcher

The FileRelay dashboard includes a workspace switcher in the top navigation bar that lets you move between your workspaces quickly. Your current workspace is always displayed, and all dashboard views reflect the selected workspace.

> **REPLACE:** Screenshot of the workspace switcher dropdown in the top navigation showing multiple workspaces

When you switch workspaces, the entire dashboard context changes -- the sidebar counts, the documents list, the sources and destinations pages all update to show data for the newly selected workspace.

## Workspace Limits

There is no hard cap on workspaces per deployment — practical limits are governed by your deployment's licensed scope and resources. Most customers map one workspace per SAP system or environment (dev / QA / prod).

## Getting Started

Your first workspace is created the first time you sign in to FileRelay. Your admin (Self-hosted) or the FileRelay team (Managed on-prem / FileRelay-hosted) provisions the deployment, gives you the URL, and the dashboard prompts you to create your first workspace on first sign-in.

From there, you can add additional workspaces as needed.

- [Creating Workspaces](/docs/workspaces/create) -- Step-by-step workspace creation
- [Workspace Settings](/docs/workspaces/settings) -- Configure relay mode, retry settings, and more
- [SAP Connection](/docs/workspaces/sap-connection) -- Set up RFC connectivity for enrichment
- [Team Management](/docs/team/overview) -- Invite team members to your workspace