> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/xsoar-migration-guide/cortex-xsoar-8-saas-migration/migrate-from-cortex-xsoar-6-to-cortex-xsoar-8-saas-using-the-pre-migration-and-migration-wizard.md).

# Migrate from Cortex XSOAR 6 to Cortex XSOAR 8 SaaS using the pre-migration and migration wizard

This process uses the following wizards to help you migrate your data.

* Pre-migration wizard: Sets up the Cortex XSOAR 8 migration tenant, such as sizing, retention, and development/production environments.

  During the pre-migration wizard process, you can decide whether to migrate incident and indicator data. We recommend not migrating incident and indicator data for a quicker and more efficient migration process. No data will be deleted from Cortex XSOAR 6 when you migrate your data.

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><h3>Note</h3><p>Cortex XSOAR operates an incident retention policy, which keeps incidents for six months. If you decide to migrate incident and indicator data, you can select a retention period in the pre-migration wizard.</p><p>All migrating customers receive an additional six months of retention until the end of the license term, regardless of whether they migrate incident and indicator data. For more information, see <a href="/spaces/gHZkkpS9tCAU2tRJlYSx/pages/pXNJKm32wD9ZCJ2kvkmv">Retention Policy</a>.</p></div>

  After completion, data is synced from Cortex XSOAR 6 to 8.
* Migration wizard: Verifies that your data and content are synced and that your integrations work correctly.

If you want to manually migrate without using the wizards, see [Migrate from Cortex XSOAR 6 to Cortex XSOAR 8 SaaS (Self-Service)](/xsoar-migration-guide/cortex-xsoar-8-saas-migration/migrate-from-cortex-xsoar-6-to-cortex-xsoar-8-saas-self-service.md).

**Before you begin**

* Review the [Migration Prerequisites for Cortex XSOAR 8 SaaS](/xsoar-migration-guide/cortex-xsoar-8-saas-migration/migration-prerequisites-for-cortex-xsoar-8-saas.md).
* After receiving notification by email that your Cortex XSOAR 6 instance will be migrated, you need to provide details of the administrators who will manage the migration. After the migration process starts, you can add or delete these administrators in the Cortex Gateway.
* In Cortex XSOAR 6, review the recommendations by going to Settings → **About** → **Migration**.

**How to migrate using the wizards**

![mt-wizard-migration-flow.png](/files/YRDxziDsGyokPxGFHPjS)

| Step                                                                                                                                                                                                                                                                                                       | Description                                                                                                                                                                                                                                                                           |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Step 1. Activate the Cortex XSOAR 8 tenant](/xsoar-migration-guide/cortex-xsoar-8-saas-migration/migrate-from-cortex-xsoar-6-to-cortex-xsoar-8-saas-using-the-pre-migration-and-migration-wizard/step-1.-activate-the-cortex-xsoar-8-tenant.md)                                                           | In Cortex Gateway, activate the Cortex XSOAR 8 migration tenant.                                                                                                                                                                                                                      |
| [Step 2. Set up the Cortex XSOAR 8 tenant using the pre-migration wizard](/xsoar-migration-guide/cortex-xsoar-8-saas-migration/migrate-from-cortex-xsoar-6-to-cortex-xsoar-8-saas-using-the-pre-migration-and-migration-wizard/step-2.-set-up-the-cortex-xsoar-8-tenant-using-the-pre-migration-wizard.md) | <p>Set up the Cortex XSOAR 8 migration tenant using the pre-migration wizard.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Tip</strong></p><p>If using a development tenant, we recommend setting up this tenant first.</p></div> |
| [Step 3. Run user acceptance tests (UAT) using the migration wizard](/xsoar-migration-guide/cortex-xsoar-8-saas-migration/migrate-from-cortex-xsoar-6-to-cortex-xsoar-8-saas-using-the-pre-migration-and-migration-wizard/step-3.-run-user-acceptance-tests-uat-using-the-migration-wizard.md)             | Run UAT tests using the migration wizard.                                                                                                                                                                                                                                             |
| [Step 4. Select whether to resync data and set the switchover date](/xsoar-migration-guide/cortex-xsoar-8-saas-migration/migrate-from-cortex-xsoar-6-to-cortex-xsoar-8-saas-using-the-pre-migration-and-migration-wizard/step-4.-select-whether-to-resync-data-and-set-the-switchover-date.md)             | Decide whether you want to resync data and set the switchover date, if relevant.                                                                                                                                                                                                      |
| [Post Migration Steps for Cortex XSOAR 6 On-prem to 8 SaaS](/xsoar-migration-guide/cortex-xsoar-8-saas-migration/migrate-from-cortex-xsoar-6-to-cortex-xsoar-8-saas-using-the-pre-migration-and-migration-wizard/post-migration-steps-for-cortex-xsoar-6-on-prem-to-8-saas.md)                             | Validate settings and data. If you have decided not to migrate incident and indicator data, consider moving your incidents and indicators manually.                                                                                                                                   |


---

# 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, and the optional `goal` query parameter:

```
GET https://cortex-docs.paloaltonetworks.com/xsoar-migration-guide/cortex-xsoar-8-saas-migration/migrate-from-cortex-xsoar-6-to-cortex-xsoar-8-saas-using-the-pre-migration-and-migration-wizard.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.