Managing Workspaces
Learn how to create, configure, and manage workspaces for organizing your research projects.
Introduction
Workspaces are the top-level organizational units in Cnidarity. They provide a way to group related research projects and collaborate with team members. Workspaces can represent research groups, departments, institutions, or any other organizational structure that makes sense for your research.
Each workspace can contain multiple projects, and users can belong to multiple workspaces. This allows for flexible organization and collaboration across different research initiatives.
Creating Workspaces
You can create a new workspace at any time after logging in:
- Click on your current workspace name in the top navigation bar to open the workspace dropdown.
- Select "Create New Workspace" from the dropdown menu.
- Enter a name for your workspace. Choose a name that clearly identifies the purpose of the workspace (e.g., "Marine Biology Lab," "Climate Research Group").
- Optionally, add a description to provide more context about the workspace's purpose.
- Click the "Create Workspace" button to complete the process.
When you create a new workspace, you become its administrator by default. This gives you full control over the workspace, including the ability to invite other users and manage projects.
Managing Workspaces
As a workspace administrator, you have several tools for managing your workspace:
Workspace Dashboard
The workspace dashboard provides an overview of your workspace, including:
- A list of all projects in the workspace
- Recent activity within the workspace
- Quick access to workspace settings
- Options to create new projects
To access the workspace dashboard, click on the workspace name in the top navigation and select "View Workspace Dashboard."
Workspace Settings
You can customize various aspects of your workspace through the settings page:
Accessing Workspace Settings
- Click on your workspace name in the top navigation bar.
- Select "Workspace Settings" from the dropdown menu.
General Settings
In the General tab, you can modify basic workspace information:
- Workspace Name: Update the name of your workspace.
- Description: Add or modify the workspace description.
Advanced Settings
Additional settings for workspace management:
- Default Project Settings: Configure default settings for new projects.
- Workspace Permissions: Customize permission settings for workspace members.
Deleting a workspace will permanently remove all projects, models, and records within it. This action cannot be undone, so use it with extreme caution.
Workspace Collaboration
Workspaces are designed for collaboration. You can invite team members to join your workspace and work together on research projects.
Inviting Members
To invite collaborators to your workspace:
- Go to Workspace Settings
- Select the "Members" tab
- Click "Invite Member"
- Enter the email address of the person you want to invite
- Click "Send Invitation"
Invited members will join as guests. After they join the workspace, you can add them to specific projects with appropriate project-level permissions.
Member Roles
Workspace members can have one of the following roles:
Workspace Owner
Full control over the workspace, including:
- Managing workspace settings
- Inviting and removing members
- Creating and deleting projects
- Managing all projects in the workspace
- Updating subscription tier
- Deleting the workspace
Guest
Limited access to the workspace:
- Can view projects they're invited to
- Cannot modify workspace settings
- Cannot invite or manage workspace members
- Cannot create new projects
- Permissions within projects are determined by project-level roles
A workspace can only have one owner. If you need to assign additional permissions to users, this is managed at the project level with Project Admin, Regular User, and Readonly User roles.
Switching Between Workspaces
If you belong to multiple workspaces, you can easily switch between them:
- Locate your current workspace name in the sidebar on the left side of the screen.
- Click on the workspace name to open the workspace switcher.
- Select the workspace you want to switch to from the dropdown list.
Your active workspace determines which projects you can access and work with. When you switch workspaces, the interface updates to show the projects and settings for that specific workspace.
The workspace switcher in the sidebar always displays your current workspace name, making it easy to know which workspace context you're currently working in.
Best Practices
Here are some recommended practices for effectively managing workspaces:
- Organize logically: Create workspaces that align with your organizational structure or research domains.
- Clear naming: Use descriptive names for workspaces to make them easily identifiable.
- Limit administrators: Restrict administrator privileges to only those who need full control.
- Regular maintenance: Periodically review workspace members and remove those who no longer need access.
- Document purpose: Use the description field to clearly explain the workspace's purpose and scope.
Consider using workspaces to separate different research domains or institutional boundaries, and then use projects within each workspace to organize specific research initiatives.