Skip to content
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .doc.holiday/styleguide-docs.md
Original file line number Diff line number Diff line change
Expand Up @@ -287,7 +287,7 @@ introduction/

paid/
- Documentation of features available only in paid plans.
- Files: organization-template-catalog.mdx
- Files: organization-template-catalog.mdx, customer-workspaces.mdx

reporting-analytics/
- Documentation of analytics and reporting features, as well as ways to import OpenOps content into external BI tools.
Expand Down
3 changes: 2 additions & 1 deletion docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,8 @@
{
"group": "Paid Features",
"pages": [
"paid/organization-template-catalog"
"paid/organization-template-catalog",
"paid/customer-workspaces"
]
},
{
Expand Down
Binary file added images/paid/master-project-selected.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/paid/master-project-selection-preview.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/paid/new-workspace.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/paid/personal-workspace-selected.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/paid/workspace-management-page.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/paid/workspace-management-rename.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/paid/workspace-switcher-search.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/paid/workspace-switcher.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
115 changes: 115 additions & 0 deletions paid/customer-workspaces.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,115 @@
---
title: 'Customer Workspaces'
description: 'Organize and manage work in separate, isolated environments'
icon: 'folders'
---

import { NarrowImage } from '/snippets/narrow-image.jsx'

<Info>
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@cezudas I love this can we added it also the existing Template Catalog doc page?

**Customer workspaces** is an Enterprise edition feature. See [pricing](https://www.openops.com/pricing/) for details.
</Info>

Customer workspaces allow you to organize work in separate, isolated environments. Each workspace contains its own workflows, connections, and resources. This enables organizations to separate different projects, clients, or departments while maintaining clear boundaries between them.
Comment thread
cezudas marked this conversation as resolved.
Outdated

![Workspace Management Page](/images/paid/workspace-management-page.png)

In larger organizations, workspaces help teams organize their work by business unit, environment (dev/staging/production), or client. Central teams can create workspaces for different departments, each with its own workflows and data.

For managed service providers (MSPs), customer workspaces are essential for maintaining strict separation between client data and workflows, ensuring each client's work remains isolated and secure.

## Accessing Workspaces

Every user automatically gets a default workspace. You can access workspaces through the **workspace switcher** in the top navigation bar.

![Workspace Switcher](/images/paid/workspace-switcher.png)

You can also navigate to the **Workspaces Management** page to view all workspaces in a table, create new ones, and manage existing workspaces.

## Creating a New Workspace

To create a new workspace:

1. Navigate to the **Workspaces Management** page
2. Click the **"Add new"** button
3. Enter a unique workspace name (at least 1 character)
4. Click **"Confirm"**


![Workspace Switcher](/images/paid/new-workspace.png)

You will automatically become the owner and be switched to the new workspace. The system creates a dedicated database and authentication tokens for the workspace.

## Switching Between Workspaces

You can switch workspaces by:

- Clicking the workspace name in the top navigation bar and selecting a workspace from the dropdown
- Clicking the **"Switch"** button next to a workspace in the Workspaces Management page

The current workspace is marked with a checkmark (✓). The application reloads when switching workspaces to ensure all data and resources are properly loaded for the selected workspace.

## Managing Workspaces

### Workspace Information

The Workspaces Management page displays for each workspace:

- Workspace name
- Number of active workflows
- Ownership status (only owners see the action menu)

### Renaming a Workspace

Only workspace owners can rename workspaces:

1. In the Workspaces Management page, click the three-dot menu (⋯) on the workspace row
2. Select **"Rename"**
3. Enter a new unique name
4. Click **"Update"**

![Renaming workspace ](/images/paid/workspace-management-rename.png)

### Default Workspace

Every user has a default workspace (typically named "[Your Name]'s Workspace") that is automatically created. Default workspaces appear first in lists and are marked with a users icon in the workspace switcher.
Comment thread
cezudas marked this conversation as resolved.
Outdated

## Workspace Ownership and Members

### Ownership

The user who creates a workspace becomes its owner. Owners can rename the workspace and manage members.

### Member Management

Workspace members can switch to and work within any workspace they have access to. You can manage members and switch workspaces programmatically using a REST client. These operations operate on the workspace you are currently switched to.
Comment thread
cezudas marked this conversation as resolved.
Outdated

### Roles

Workspaces support the following roles: **ADMIN**, **EDITOR**, **OPERATOR**, and **VIEWER**. Role-based permission enforcement is currently being implemented; the primary authorization check is ownership-based.
Comment thread
cezudas marked this conversation as resolved.
Comment thread
cezudas marked this conversation as resolved.

### Master Project Workspace

Each organization has one designated **Master Project** workspace that provides access to special organization-wide features. You must switch to the master project workspace to access these features.

New users are not assigned to the master project by default. They must be granted access and switch to it manually.

![Master Project Selected](/images/paid/master-project-selected.png)
Comment thread
cezudas marked this conversation as resolved.
Outdated

![Master Project Selection Preview](/images/paid/master-project-selection-preview.png)

![Personal Workspace Selected](/images/paid/personal-workspace-selected.png)

#### Analytics Access

**OpenOps Analytics** is only accessible when switched to the master project workspace. All users who have access to the master project can view analytics, regardless of their role.

#### Private Template Catalog Management

Only organization **admins** in the master project workspace can create, edit, or delete private templates (requires private template editor feature to be enabled).

## Searching Workspaces

Use the search bar in the workspace switcher or the Workspaces Management page to filter workspaces by name. Search is case-insensitive and matches partial names.

![Searching in Workspace Switcher](/images/paid/workspace-switcher-search.png)