> ## Documentation Index
> Fetch the complete documentation index at: https://www.integrate.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ETL: Workspaces

> Learn about Integrate.io ETL workspaces for organizing packages, connections, and team resources. Separate environments for your data projects.

## What is an Integrate.io ETL Workspace?

A Workspace provides a way to group and organize packages together. Think of Workspaces like folders. You can group pipelines by team if there’s many users using the same Integrate.io ETL account, or group pipelines by customer, or if you simply want to have some template packages you’d like to go back to in the future. You could use an Integrate.io ETL Workspace to group packages together based on your requirements. You can have a look at our Workspaces feature by clicking this new icon we’ve introduced.

<Frame>
  <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/getting-started/ETL_Workspace_part01.webp?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=eceb5924d74fdd35df6ff2e8fe6780a7" alt="Workspaces icon in the left navigation menu" width="1200" height="631" data-path="images/getting-started/ETL_Workspace_part01.webp" />
</Frame>

## Creating a Workspace

To create a Workspace, navigate to the Workspaces tab and click **New Workspace**. A modal will then popup (see image below). Give the Workspace a name and add a description if so desired. You can also add packages to this Workspace if you already have some packages in mind, otherwise you can just click **Create Workspace** and add packages later.

<Frame>
  <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/getting-started/ETL_Workspace_part02.webp?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=82d92581b216fc376a638a2dccef1b07" alt="New Workspace modal with name and description fields" width="1200" height="631" data-path="images/getting-started/ETL_Workspace_part02.webp" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/getting-started/ETL_Workspace_part03.webp?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=edc3b5c9c59f42e57600d45a3f537fc6" alt="Workspace creation confirmation with packages listed" width="1100" height="532" data-path="images/getting-started/ETL_Workspace_part03.webp" />
</Frame>

## Adding Packages to a Workspace

After Workspace creation, you can add packages to your Workspace by clicking the triple dot icon on the Workspace and clicking **Edit Workspace.** You can then click the dropdown and add packages to the Workspace. Take note that only packages that do not already belong to a Workspace can be added - i.e. a given package can only belong to one Workspace. Click the triple dot icon, and click **Edit Workspace** and add packages accordingly.

<Frame>
  <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/getting-started/ETL_Workspace_part04.webp?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=1025cbb0e6296a3e4038da2ec831ec99" alt="Edit Workspace option in the triple dot menu" width="654" height="286" data-path="images/getting-started/ETL_Workspace_part04.webp" />
</Frame>

## Moving a Package to Another Workspace

If you would like to move a single package to another Workspace, you can go to the **Packages** tab, click the triple dot icon, and click **Change Workspace**. Packages not belonging to any Workspace would have **Add to Workspace** instead.

<Frame>
  <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/getting-started/ETL_Workspace_part05.webp?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=b0fc4bce7a8b4e38de99aba65582b112" alt="Change Workspace option on a package in the Packages tab" width="1200" height="471" data-path="images/getting-started/ETL_Workspace_part05.webp" />
</Frame>

For moving packages to another Workspace in bulk, you can remove the packages from a Workspace by clicking **Edit Workspace**, removing the relevant packages, and saving it. You can then edit another Workspace by using the same **Edit Workspace** button and add the packages.

<Frame>
  <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/getting-started/ETL_Workspace_part06.webp?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=436125f546cabeb102294d506728476d" alt="Removing packages from a Workspace in the edit dialog" width="1103" height="926" data-path="images/getting-started/ETL_Workspace_part06.webp" />
</Frame>

## Deleting a Workspace

You can delete a Workspace by clicking the triple dot icon on the Workspace and clicking **Delete Workspace**. Deleting a Workspace will not delete the packages under the Workspace. These packages will no longer belong to a Workspace.

## Workspace Summary Bar

<Frame>
  <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/getting-started/ETL_Workspace_part07.webp?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=df763bd003e663b79fddc90e286b45f0" alt="Workspace summary bar showing job status counts" width="378" height="232" data-path="images/getting-started/ETL_Workspace_part07.webp" />
</Frame>

A summary bar on each Workspace is shown which indicates the following job-related information.

<Note>
  **Note**:

  Archived packages are excluded from all counts in the summary bar.
</Note>

* The leftmost number represents the total number of active (non-archived) packages under the Workspace
* ❌ Red cross indicates the number of packages failed on last run
* ⏸️ Gray Pause symbol indicates the number of packages stopped on last run
* ✅ Green tick indicates number of packages completed on last run.

This could be helpful if the packages underneath are being run regularly (via an Integrate.io ETL schedule for example) as it would quickly give insights on whether all the jobs succeeded during the last run, or if a package failed.