Perform post-migration tasks for UI actions and layouts

  • Release version: Australia
  • Updated March 12, 2026
  • 2 minutes to read
  • Verify that the UI actions and layouts in Service Operations Workspace (SOW) are consistent with UI actions and layouts in ITSM Agent Workspace (ITSM AW) and are ready for use in SOW. You can update the migrated UI actions and layouts settings in SOW based on your requirements.

    Before you begin

    When performing the migration, you must have selected the UI actions and layouts option for ITSM Agent Workspace features. For example, the UI actions and layouts option for Incident Management. For information about the migration process, see Migrate from ITSM Agent Workspace to Service Operations Workspace for ITSM.

    Role required: admin

    About this task

    At the end of the migration process, a confirmation message specifies if the migration is successful or not. You can review the migration information and perform the post-migration steps to ensure successful migration of your configuration or customization.

    Procedure

    1. If the migration is successful, perform the following steps.
      1. Open SOW for ITSM and ITSM Agent Workspace instances.
        • To open SOW, navigate to All > Workspace Experience > Workspaces > Service Operations Workspace.
        • To open ITSM Agent Workspace, enter <instance-name>.service-now/workspace in the web browser.
      2. Open a record in SOW that is corresponding to a table for which UI actions and layouts are migrated.
        For example: If you want to verify the UI actions and layouts migration status for an incident, navigate to List > Incident > All and then select any incident record.
      3. Review the UI actions and the layout that are migrated from ITSM Agent Workspace to SOW.
      4. If you want to rearrange the order of the UI actions layout, navigate to All > sys_ux_form_action_layout.list
      5. Search and select the table for which the UI actions and layout order must be changed.
        For example, Incident.
      6. Edit the record.
      7. Check whether the sys_ux_form_action_layout record is unified for the specified table.
        If the sys_ux_form_action_layout record is unified, Unify action button is not visible. If the sys_ux_form_action_layout record is not unified, select the Unify action option to unify the record. After the UI actions are unified, all the UI actions are displayed under UX Form Action Layout Items related list.
      8. On the UX Form Action Layout Items related list, change the order of the UI actions as required to rearrange the layout on the record of the targeted table.
    2. If the migration fails, perform the following steps.
      1. On the migration completion page in SOW Admin Center, select View migration details.
      2. Select the Go to system logs icon (Error) icon.
      3. Review the logs to determine which items failed during migration.
      4. For each failed item, identify which step has failed and perform the steps mentioned in the How the migration works section.