# Workspace

Workspaces in SEO Utils allow you to organize and separate your projects, clients, or different SEO campaigns. Each workspace maintains its own set of data, making it easy to manage multiple projects without mixing information.

## What are Workspaces?

Workspaces act as separate containers for your SEO data. When you switch between workspaces, you're essentially switching between different databases of:

* [Organic Rank Tracker reports](https://help.seoutils.app/guide/organic-rank-tracker)
* [GMB Rank Tracker reports](https://help.seoutils.app/guide/google-my-business-rank-tracker)
* [LLM Rank Tracker reports](https://help.seoutils.app/guide/llm-rank-tracker)
* [Content Structs](https://help.seoutils.app/guide/content-struct)
* [Google Search Console properties](https://help.seoutils.app/guide/google-search-console)
* And many more...

### Default Workspace

Every SEO Utils installation comes with a **Default** that cannot be deleted. This ensures you always have at least one workspace to work with.

## Managing Workspaces

### Accessing Workspaces

You can access the workspace switcher from the sidebar. The current active workspace is displayed with its logo (if set) or a default icon.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-cdbd5010ef19c5d7171b64e42ac0efe6fa862a8b%2FXnapper-2025-08-14-23.05.36.png?alt=media" alt=""><figcaption><p>Workspace switcher in the sidebar</p></figcaption></figure>

### Creating a New Workspace

#### Step 1

Click on the workspace switcher in the sidebar to open the dropdown menu.

#### Step 2

Click on the **"Add workspace"** button at the bottom of the dropdown.

#### Step 3

Enter a **name** for your workspace and optionally add a **logo URL** to help identify it visually.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-9de4bdcf420b1cbb2d56276680132556cc2a6931%2FXnapper-2025-08-14-23.09.26.png?alt=media" alt="" width="563"><figcaption><p>Create workspace modal</p></figcaption></figure>

Click **"Create"** to create the workspace, or **"Create & Switch"** to create and immediately switch to the new workspace.

### Editing a Workspace

To edit an existing workspace:

1. Open the workspace dropdown
2. Hover over the workspace you want to edit
3. Click the **pencil icon** that appears
4. Update the name or logo URL
5. Click **"Save"** to apply changes

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-c4f6b273a91a3c3d6cd8a77efcd0deca916caa78%2FCleanShot%202025-08-14%20at%2023.10.22%402x.png?alt=media" alt="" width="288"><figcaption><p>Edit workspace by clicking the pencil icon</p></figcaption></figure>

### Deleting a Workspace

{% hint style="warning" %}
You can only delete workspaces that contain **no data**. If a workspace has any reports, tracked keywords, or other data, you must first delete or move that data before deleting the workspace.
{% endhint %}

To delete a workspace:

1. Open the workspace dropdown
2. Hover over the workspace you want to delete
3. Click the **trash icon** that appears
4. Confirm the deletion in the modal

{% hint style="info" %}
The **Default Workspace** cannot be deleted.
{% endhint %}

## Switching Between Workspaces

### Using the Dropdown

Click on any workspace in the dropdown to switch to it. The app will reload with the selected workspace's data.

### Using Keyboard Shortcuts

You can quickly switch between workspaces using keyboard shortcuts:

* **Mac**: `⌘1` through `⌘9`
* **Windows/Linux**: `Ctrl+1` through `Ctrl+9`

The number corresponds to the workspace's position in your list. For example, `⌘1` switches to the first workspace, `⌘2` to the second, and so on.

### Reordering Workspaces

You can reorder workspaces to customize your keyboard shortcuts:

1. Open the workspace dropdown
2. Hover over a workspace to see the **drag handle** (grip icon)
3. Click and drag the workspace to your desired position
4. Release to save the new order

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-2242d4efc94b43cad74e5944566532b4beeea1f5%2FCleanShot%202025-08-14%20at%2023.10.22%202%402x.png?alt=media" alt="" width="288"><figcaption><p>Drag workspaces to reorder them</p></figcaption></figure>

## Moving Data Between Workspaces

You can move existing data from one workspace to another using the bulk move feature:

### Moving Multiple Records

1. Select the records you want to move (using checkboxes in any data table)
2. Click on **"Bulk Actions"** button
3. Select **"Move to Workspace"**
4. Choose the target workspace from the dropdown
5. Click **"Execute"** to move the selected records

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-80bcc5e73fd80619c6d482dc368f9b68fbd7efe4%2FXnapper-2025-08-14-23.12.54.png?alt=media" alt=""><figcaption><p>Bulk move records to another workspace</p></figcaption></figure>

## Use Cases for Workspaces

### Client Management

Create separate workspaces for each client to keep their SEO data isolated:

* **Client A Workspace**: Contains all rank tracking, backlinks, and reports for Client A
* **Client B Workspace**: Separate data for Client B
* **Personal Projects**: Your own website's SEO data

### Project Organization

Organize different projects or websites:

* **E-commerce Site**: Track product page rankings and organic traffic
* **Blog Network**: Monitor multiple blog sites
* **Local Business**: Track Google Business rankings and local SEO

### Team Collaboration

Different teams or departments can have their own workspaces:

* **Content Team**: Focus on content analysis and optimization
* **Link Building Team**: Track backlink campaigns
* **Technical SEO**: Monitor site health and technical metrics

## Important Notes

* Each workspace maintains completely **separate data**
* Switching workspaces will **refresh the current view** to show the new workspace's data
* Workspace settings are **saved locally** and persist between app sessions
* The active workspace is **remembered** when you close and reopen the app
* All API keys and service accounts are **shared across all workspaces**

## Best Practices

1. **Name workspaces clearly**: Use descriptive names like "Client - ABC Corp" or "Project - Summer Campaign"
2. **Add logos**: Upload client logos or project icons to quickly identify workspaces visually
3. **Organize by priority**: Place your most-used workspaces at the top for quick keyboard access
4. **Regular cleanup**: Delete empty workspaces you no longer need to keep your list organized
5. **Move data carefully**: Double-check the target workspace before moving important data