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

# Migrate to Workspaces 2.0

> Move your Zite apps to Workspaces 2.0 without rebuilding your app, data, or access.

## How it works

When you open an app or database that does not yet belong to a Workspaces 2.0 workspace, Zite asks you to migrate it. Your apps, forms, database, and existing access move together, so you do not need to rebuild anything.

<Frame caption="Name your workspace">
  <img src="https://mintcdn.com/zite/0yvEN-CU0A7n6yJ6/help/images/zite/workspace-migration-name.webp?fit=max&auto=format&n=0yvEN-CU0A7n6yJ6&q=85&s=9e06dd8859f505762fc5a616ff1e192b" alt="The workspace migration screen for naming a workspace" width="1079" height="600" data-path="help/images/zite/workspace-migration-name.webp" />
</Frame>

## Apps without a Zite Database

For an app without a Zite Database, choose where to add one:

* **Create a new workspace:** Creates a workspace with its own database. You do not have to use the database right away, but it is ready when you need it.
* **Add to an existing workspace:** Choose a workspace from the list to move the app there. The app uses that workspace's database.

## Classic vs new workspaces

Existing workspaces, now called Classic workspaces, are visual folders for grouping apps, databases, and forms. In Workspaces 2.0, each workspace holds one database, its connected apps and forms, shared logic, and centralized user access.

<Frame caption="Previous Workspaces 2.0 UI">
  <img src="https://mintcdn.com/zite/BkSN2iVSmz2tyV_v/help/images/zite/workspace-migration-overview.webp?fit=max&auto=format&n=BkSN2iVSmz2tyV_v&q=85&s=d941294a91a29af197ed551e18d4cd60" alt="A Zite workspace with a shared database, members and roles, internal apps, and public apps" width="1600" height="900" data-path="help/images/zite/workspace-migration-overview.webp" />
</Frame>

<Note>
  This screenshot shows the previous `Members & roles` label. The button is now called `Users & roles`.
</Note>

## What you get with a new workspace

Each workspace keeps the people, apps, and data for a project together. As it grows, you can add more apps and forms, manage editors, and control access for each app.

<CardGroup cols={2}>
  <Card title="Everything in one place" icon="grid-2" color="#FFC738">
    Quickly manage your database, apps, forms, users, and permissions from one place.
  </Card>

  <Card title="One shared database" icon="database" color="#FFC738">
    Keep the records, tables, and relationships that power your project together.
  </Card>

  <Card title="Connected apps and forms" icon="cube" color="#FFC738">
    Add internal apps, public apps, and forms that all work from the same data.
  </Card>

  <Card title="One agent with the full picture" icon="wand-magic-sparkles" color="#FFC738">
    Let Zite Agent work across the apps and data without needing to switch apps.
  </Card>

  <Card title="Access in one place" icon="users" color="#FFC738">
    Open `Users & roles` to manage editors, app users, and database roles.
  </Card>

  <Card title="Shared logic across apps" icon="code-branch" color="#FFC738">
    Share logic across your apps for better performance and reliability.
  </Card>
</CardGroup>

## Migration questions

<AccordionGroup>
  <Accordion title="What happens if my app does not have a Zite Database?">
    You can either create a new workspace or add the app to an existing workspace.

    * **Create a new workspace:** Zite creates a new Zite Database for the workspace. You do not have to use it, but it is ready if you need it later.
    * **Add to an existing workspace:** The app uses the database that already belongs to that workspace.

    When you create a workspace, name it and select `Done`. Zite adds the database alongside your app.

    When you add an app to an existing workspace, select the workspace from the list, then select `Move`.
  </Accordion>

  <Accordion title="What happens if my app already uses a Zite Database?">
    Zite moves the database and every app that shares it into a new workspace. People with database access become editors, and existing app users keep access to the apps they use.

    Name the workspace, then select `Done` to complete the move.
  </Accordion>

  <Accordion title="Will people keep access to the new workspace?">
    Yes. People who can access the database become editors in the new workspace. Existing app users keep their app access.
  </Accordion>

  <Accordion title="Can a workspace have more than one Zite Database?">
    No. Each workspace has one Zite Database. Add apps and forms to the same workspace when they should work from the same data.
  </Accordion>

  <Accordion title="What if my app uses an external data source?">
    That is fine. When a new workspace is created, Zite adds a Zite Database, but you can keep using your external data source and do not have to use the new database. It will be there if you need it later.
  </Accordion>

  <Accordion title="Can I undo a migration?">
    No. Migration to Workspaces 2.0 is a one-way process, so an app cannot return to the Classic workspace model after migration. However, once migrated, you can move the app between different Workspaces 2.0 workspaces.
  </Accordion>

  <Accordion title="Will everything keep working after migration?">
    Yes. Your app, data, access, and existing setup keep working after the migration. You do not need to rebuild anything.
  </Accordion>
</AccordionGroup>

<p className="zite-related-topics-heading">Related topics</p>

<div className="zite-related-topics">
  <a href="/help/platform/workspaces/overview">Workspaces</a>
  <a href="/help/platform/access/manage-users">Members & users</a>
  <a href="/help/platform/access/overview">Manage app access</a>
</div>
