> For the complete documentation index, see [llms.txt](https://developer.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.collibra.com/workflows/designing-workflows/workspaces.md).
# Workspaces
Workspaces in Workflow Designer are essential for organizing your workflow models, particularly for large projects or managing multiple distinct workstreams.
Workspaces provide a dedicated area to group and manage your workflow models. This structure allows you to create workspaces tailored to your specific needs, helping to keep different projects or development efforts clearly separated and organized.
{% hint style="info" %}
Your Workflow Designer must have at least one workspace. The out-of-the-box workspace name is **Generated default**.
{% endhint %}
Workspaces offer several features to enhance how you manage your workflow development:
* Improved project organization: You can create distinct workspaces for different projects or initiatives. This helps maintain a clear and focused modeling environment while providing flexibility through the ability to move apps or copy app versions between workspaces.
* Tailored environments: The ability to create workspaces as needed means you can set up an organizational structure that best fits your development processes.
* Default workspace: You can designate one workspace as the default. This can streamline your access to your most frequently used or primary set of workflow apps and models.
* Efficient navigation: The Workspaces page allows you to filter and sort your workspaces. This makes it easier to quickly find and navigate to the specific workspace you need, especially as the number of your projects grows.
By using these workspace features, you can maintain a more organized and efficient workflow development process.
## Find and view workspaces
As you create more workspaces, the Workspaces page provides several options to help you efficiently locate and view them.
* Search: Use the search to find workspaces or jump to recently visited models.
* Filter by name: Enter part or all of a workspace name to narrow down the list of workspaces.
* View options: Click 
**View options** to open the controls for changing how workspaces are shown:
* View: Select **List view** or **Grid view** to change the layout.
* Sort: Choose to sort by **Name** or **Key**, and in **Ascending** or **Descending** order.
## Create a workspace
You can create new workspaces to organize your workflow models according to your project needs.
### Steps
{% stepper %}
{% step %}
In the navigation bar, select **Workspaces**.
{% endstep %}
{% step %}
On the Workspaces page, click 
**Create**.
{% endstep %}
{% step %}
In the **Create a new workspace** dialog box, enter the required information:
| Field | Description |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name | The name for your workspace. This name helps you identify the workspace and its purpose. |
| Key | The unique identifier of the workspace. By default, the Workflow Designer auto-generates the key from the workspace name. Alternatively, you can specify a custom key. |
| Description | Optionally, a description of the workspace. You can use the formatting options for bold, italics, or monospace. |
| Visibility | Whether the workspace is public or private. A public workspace is visible to all users. A private workspace is visible only to users with explicit access. |
| {% endstep %} | |
{% step %}
Click **Create**.
{% endstep %}
{% endstepper %}
:chevrons-right: Your new workspace is created and appears on the Workspaces page. You can now select this workspace to start adding or managing workflow apps and models in it.
## Manage workspaces
After you create workspaces, you can modify their properties, visibility, set one as default, or remove those you no longer need.
To perform these actions, access the actions menu:
* On the Workspaces page, find the workspace and click the 
more icon next to it.
* From an individual workspace page, click 
**Actions** next to the name of the workspace in the navigation menu.
### Edit workspace details
{% stepper %}
{% step %}
From the actions menu, click **Edit workspace**.
{% endstep %}
{% step %}
In the **Update the workspace** dialog box, update any of the following:
* **Name**: Change the display name of the workspace.
* **Key**: Modify the unique key of the workspace.
* **Description**: Update the descriptive text of the workspace.
{% endstep %}
{% step %}
Click **Ok** to apply your changes.
{% endstep %}
{% endstepper %}
### Change workspace visibility
{% stepper %}
{% step %}
From the actions menu, click **Change visibility**.
{% endstep %}
{% step %}
In the **Change visibility** dialog box, select one of the following:
* **Public**: The workspace is visible to all users.
* **Private**: The workspace is visible only to you and users with explicit access.
{% endstep %}
{% step %}
Click **Save** to apply your changes.
{% endstep %}
{% endstepper %}
### Change workspace permissions
A private workspace is visible only to you. You can manage access to your workspace and define user roles through workspace permissions:
{% stepper %}
{% step %}
From the actions menu, click **Change permissions**.
{% endstep %}
{% step %}
In the **Change workspace permissions** dialog box, configure the following options:
* **Users**: Select who has access to the workspace.
* **Type**: Select the role to assign to each user:
* **Owner**: Has full access to the workspace and the apps and models it contains, including the ability to edit, change visibility, or remove the workspace.
* **Modeler**: Can create and edit apps and models.
* **Reader**: Can view the workspace and the apps and models it contains.
{% endstep %}
{% step %}
Click **Save** to apply your changes.
{% endstep %}
{% endstepper %}
### Set a default workspace
From the actions menu of the desired workspace, select **Set as default**.
:chevrons-right: The selected workspace is now your default workspace.
### Remove a workspace
If you no longer need a workspace and the items it contains, you can remove it.
{% hint style="danger" %}
Removing a workspace is a permanent action that also deletes all workflow apps and models from that workspace. Ensure you no longer need the workspace, apps, and models before proceeding.
{% endhint %}
#### Steps
1. From the actions menu, select **Remove workspace**.
2. In the **Delete the workspace** dialog box, click **Delete the workspace** to confirm that you want to remove the workspace.
:chevrons-right: The workspace and the associated workflow apps and models are deleted.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://developer.collibra.com/workflows/designing-workflows/workspaces.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.