Migrate from ITSM Agent Workspace to Service Operations Workspace for ITSM

---
title: Migrate from ITSM Agent Workspace to Service Operations Workspace for ITSM
description: Through a set of simple steps, quickly migrate your ITSM Agent Workspace features including configurations and customizations to Service Operations Workspace for ITSM.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/it-service-management/service-operations-workspace/migrate-itsm-agent-workspace-to-sow.html
release: australia
product: Service Operations Workspace
classification: service-operations-workspace
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 5
breadcrumb: [Migration from ITSM Agent Workspace to Service Operations Workspace for ITSM, Configuring Service Operations Workspace for ITSM, Service Operations Workspace for ITSM, IT Service Management]
---

# Migrate from ITSM Agent Workspace to Service Operations Workspace for ITSM

Through a set of simple steps, quickly migrate your ITSM Agent Workspace features including configurations and customizations to Service Operations Workspace for ITSM.

## Before you begin

Ensure that the scope is set to Service Operations Workspace Core.

Role required: admin

## Procedure

1.  Navigate to **All** > **Service Operations Workspace Admin Center** > **Overview** > **Initial Setup** > **Migrate from ITSM Agent Workspace to SOW** if you're upgrading from AW 2.0 or higher.

    If you're installing the latest migration utility, navigate to **All** > **Service Operations Workspace** > **Migrate from ITSM Agent Workspace to SOW**.

2.  On the Migration from ITSM Agent Workspace to SOW page, perform the following steps.

    1.  If required, create a basic authentication configuration with existing or new user credentials by selecting **Create basic authentication configurations**.

        **Important:**

        -   This configuration must contain the credentials of the user who is logged in and has the admin role.
        -   Only after you create the basic authentication configuration, create an update set to record any changes that are made to Service Operations Workspace for ITSM in your non-production instance during the migration. See [Create and select an update set as the current set](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/application-development/create-select-update-set.md).
    2.  From the **Select a basic auth configuration** drop-down, select the required configuration.

    3.  Select **Test the configuration**.

    4.  Review the mentioned guidelines.

    5.  Select **Start migration**.

    **Note:** In case your previous migration task is partially complete, you can select **Continue migration** on this page to resume the migration process.

3.  On the Features to migrate from Agent Workspace page, for each feature, select the configurations and customizations to migrate.

    For information about configurations and customizations that can be migrated, see [Migration of ITSM Agent workspace configurations to SOW for ITSM](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/configurations-and-customizations-from-itsm-aw-sow-itsm.md).

4.  Select **Next**.

5.  From the Migration confirmation page, review the selected features and select **Confirm the migration**.

    The migration can be fully or partially successful.

    -   Full successful migration: All configurations and customizations of selected features are successfully migrated to Service Operations Workspace for ITSM and captured in the specified update sets in the non-production instance.
    -   Partial migration: All successfully migrated configurations and customizations of selected features are captured in the specified update sets in Service Operations Workspace for ITSM in the non-production instance.
6.  Select **View migration details** to review the migration information.


## What to do next

Complete the post-migration tasks for each configuration or customization that you have migrated. For more information, see the following topics.

-   [Perform post-migration tasks for UI actions and layouts](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/verify-migration-status-ui-actions-layouts.md)
-   [Perform post-migration tasks for ribbons](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/verify-migration-status-ribbons.md)
-   [Perform post-migration tasks for view rules](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/verify-migration-status-view-rules.md)
-   [Perform post-migration tasks for new records](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/verify-migration-status-new-records.md)
-   [Perform post-migration tasks for highlighted fields in list and forms](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/verify-migration-status-highlighted-fields-lists-forms.md)
-   [Perform post-migration tasks for list actions](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/verify-migration-status-list-actions.md)
-   [Perform post-migration tasks for list categories and modules](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/verify-migration-status-list-categories-modules.md)
-   [Perform post-migration tasks for form headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/verify-migration-status-form-headers-sow.md)
-   [Perform post-migration tasks for search configurations](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/verify-migration-status-search-config.md)
-   [Perform post-migration tasks for Agent assist configuration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/verify-migration-status-agent-assist.md)
-   [Perform post-migration tasks for related list declarative form actions](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/verify-migration-status-related-actions-aw-sow.md)
-   [Perform post-migration tasks for field decorators form actions](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/verify-migration-status-field-declarative-actions-aw-sow.md)

-   **[Migration of ITSM Agent workspace configurations to SOW for ITSM](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/configurations-and-customizations-from-itsm-aw-sow-itsm.md)**  
You can migrate several configurations and customizations related to ITSM Agent Workspace features to SOW for ITSM.

**Parent Topic:**[Migration from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/service-operations-workspace/migration-from-itsm-aw-sow.md)