# Space migration

<figure><img src="https://437457296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MN4F4-qybg8XDATvios%2Fuploads%2FJ2VdmV53YKgiCTdJ03LC%2Fspace_info_migrate.png?alt=media&#x26;token=f615cd8f-6ce2-4242-93bc-c35dc07fa56f" alt=""><figcaption></figcaption></figure>

### Availability

The Space Migration option is available only if:

* You are the Owner of the private space
* You are a Billing Owner in at least one organization

If these conditions are met, the migration option will be visible in the Space Info page.

### How Space Migration Works

#### 1. Start Migration

When you click the Migrate Space button:

* A modal dialog is displayed
* You can select the target organization from a list of organizations where you have billing ownership

#### 2. Download Current Space Access (Optional)

<figure><img src="https://437457296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MN4F4-qybg8XDATvios%2Fuploads%2FhwJ9KaGK2Xws67vF0ARf%2Fspace_info_migrate_download_users.png?alt=media&#x26;token=b4954153-ecdd-48f2-b2fd-db4ed6a55221" alt=""><figcaption></figcaption></figure>

Before confirming the migration, you can download the current access configuration of the space.

* This downloads a CSV file
* The file contains:
  * email
  * role (default and custom)
* One row per user who currently has access to the space

This is useful as a reference, since space-level access settings will not be preserved after migration.

<figure><img src="https://437457296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MN4F4-qybg8XDATvios%2Fuploads%2FU2kEZIGac5AdjC1voKz9%2Fspace_info_download_users_detail.png?alt=media&#x26;token=282de505-bffa-46c4-b9eb-e741c8f21ff2" alt=""><figcaption></figcaption></figure>

#### 3. Confirm Migration

{% hint style="warning" %}
Access permissions are not migrated
{% endhint %}

Once confirmed:

* The space is moved under the selected organization
* All rules and configurations remain unchanged
* All space access settings are removed

<figure><img src="https://437457296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MN4F4-qybg8XDATvios%2Fuploads%2Fn5Pa7cHMjeX5hdSPYKRg%2Fspace_info_migrate_confirm.png?alt=media&#x26;token=f2163e0f-b0f6-4f69-8ab3-be7cd8c50c27" alt=""><figcaption></figcaption></figure>

### After Migration

#### Access Configuration

* Access to the space must be reconfigured at the organization level
* Permissions are managed using the organization’s access controls

#### Redirection

After the migration is completed:

* You are automatically redirected to the organization
* The system opens the space detail page
* You can immediately set access permissions for the migrated space

<figure><img src="https://437457296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MN4F4-qybg8XDATvios%2Fuploads%2FVDnKBlYi95OY2C3pFQX4%2Fspace_migrate_success.png?alt=media&#x26;token=2fd839ed-09bb-4844-9102-fe0c4ee144c1" alt=""><figcaption></figcaption></figure>
