--- sourceDocument: Australia IT Service Management sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/it-service-management Release : - australia ft:locale : - en-US ft:publication_title : - Australia IT Service Management ft:clusterId : - itsm bundleId : - itsm workflow : - Technology --- # Ribbons migration from ITSM Agent Workspace to Service Operations Workspace for ITSM # Ribbons migration from ITSM Agent Workspace to Service Operations Workspace for ITSM {#ariaid-title1} Release version: Australia Updated March 12, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read Migration of the ribbons from ITSM Agent Workspace to Service Operations Workspace for ITSM includes identifying the required tables, identifying ribbons records for migration, and the migration process. ## Tables used for migration {#ribbons-migration-itsm-aw-sow__section_bwf_tp3_ccc} {#ribbons-migration-itsm-aw-sow__table_o1r_5p3_ccc__entry__2} | Table name | Description | |-|-| | Ribbon Setting \[sys_aw_ribbon_setting\] | Contains all ribbon settings. | | UX Ribbon Configuration \[sys_ux_ribbon_config\] | Contains the ribbon configuration that is mapped to a configurable workspace. The migration utility uses the Service Operations Workspace ribbon configuration. | | Ribbon Configuration Setting \[sys_ux_ribbon_config_setting\] | Contains mapping information between the Ribbon Setting \[sys_aw_ribbon_setting\] and the UX Ribbon Configuration \[sys_ux_ribbon_config\] table records. This information helps define and identify ribbon settings that are applicable for the specified workspace. | [ ] {#ribbons-migration-itsm-aw-sow__table_o1r_5p3_ccc} ## Limitation {#ribbons-migration-itsm-aw-sow__section_ysk_1q3_ccc} * The combined width of the ribbon widgets must be equal to or lower than 12 for the specified table and ribbon configuration. * A record can't be created when: * The ribbon widgets are already configured for the specified table and ribbon configuration. * The width of the ribbon setting that is being mapped with the ribbon configuration plus the widths of the existing ribbon settings that are mapped to the same ribbon configuration is greater than 12. {#ribbons-migration-itsm-aw-sow__ul_v1j_ftg_2cc} {#ribbons-migration-itsm-aw-sow__ul_jlg_dtg_2cc} ## How the migration utility identifies ribbons for migration {#ribbons-migration-itsm-aw-sow__section_npq_hq3_ccc} The migration utility searches all ribbon settings for which workspace is set to ITSM Agent Workspace in the Ribbon Setting \[sys_aw_ribbon_setting\] table. These ribbon settings are candidates for migration. ## How the migration works {#ribbons-migration-itsm-aw-sow__section_irt_kq3_ccc} The Service Operations Workspace migration utility uses the following sequence to migrate ribbons from ITSM Agent Workspace to Service Operations Workspace for ITSM. All these actions are done by the utility. 1. Calculates the total width of existing ribbons that are mapped to Service Operations Workspace Ribbon Config plus ITSM Agent Workspace ribbons that must be migrated. 2. If the sum of widths is greater than 12, disables all existing ribbons that are mapped to the Service Operations Workspace ribbon configuration. Note: All ITSM Agent Workspace ribbons are migrated. The aim of the ITSM Agent Workspace migration utility is to prioritize migrating items from ITSM Agent Workspace to Service Operations Workspace for ITSM and so this trade-off is acceptable. 3. Creates a mapping between filtered ribbon settings and Service Operations Workspace ribbon configuration in the Ribbon Configuration Setting \[sys_ux_ribbon_config_setting\] table. {#ribbons-migration-itsm-aw-sow__ol_xnb_mq3_ccc} * **[Perform post-migration tasks for ribbons](https://servicenow-prod.fluidtopics.net/UrcD5Um7vfir2xnK1bP7PQ)** Verify that the ribbons in Service Operations Workspace (SOW) are consistent with the ribbons in ITSM Agent Workspace and the ribbons are ready for use in SOW. You can update the migrated ribbon settings in SOW based on your requirements. **Related reference** * [Migration of UI actions and layouts from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://servicenow-prod.fluidtopics.net/TG0dTdcaNVmz09a1BHGDVw "Migration from ITSM Agent Workspace to Service Operations Workspace for ITSM includes identifying the required tables, identifying the eligible UI actions and layout records for migrations, and the migration process.") * [Migration of view rules from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://servicenow-prod.fluidtopics.net/auh80L5XsyXmO9LIUql2hQ "Migration of view rules from ITSM Agent Workspace to Service Operations Workspace for ITSM includes identifying the required tables, identifying the view rules for migrations, and the migration process.") * [New record menu items migration from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://servicenow-prod.fluidtopics.net/O0rHJ4_5Gmkr9LoqHREfqA "Migration of the new record menu items from ITSM Agent Workspace to Service Operations Workspace for ITSM includes identifying the required tables, identifying new record menu items for migrations, and the migration process.") * [Migration of highlighted fields in lists and forms from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://servicenow-prod.fluidtopics.net/whYNjUgAzdzDldsh5DHitQ "Migration of the highlighted fields in lists and forms from ITSM Agent Workspace to Service Operations Workspace for ITSM includes identifying the required tables, identifying eligible highlighted field records for migrations, and the migration process.") * [List actions migration from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://servicenow-prod.fluidtopics.net/vPxAgI640M2hXeV6yrTIkg "Migration of the list actions from ITSM Agent Workspace to Service Operations Workspace for ITSM includes identifying the tables and the migration process.") * [List categories and modules migration from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://servicenow-prod.fluidtopics.net/8AyVuNGsZoGkOg_Bk5QtyQ "Migration from ITSM Agent Workspace to Service Operations Workspace (SOW) for ITSM includes identifying the required tables, highlighted field records for migrations, and the migration process.") * [Migration of form headers from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://servicenow-prod.fluidtopics.net/zjk88B4f1GP~gtGJtigbhA "Migration of the form headers from ITSM Agent Workspace to Service Operations Workspace (SOW) include identifying the required tables, eligible form header records for migrations and the migration process. Form headers provide an overview of the record.") * [Migration of search configurations from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://servicenow-prod.fluidtopics.net/dNvwVAHJS5nXWf0cxoDslw "Migration of the search configuration from ITSM Agent Workspace to Service Operations Workspace (SOW) include identifying the eligible form header records and the migration process.") * [Migration of Agent assist from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://servicenow-prod.fluidtopics.net/rO93nSkRs_8unOaTwzCZZA "Migration of the Agent assist from ITSM Agent Workspace to Service Operations Workspace (SOW) include identifying the required tables, eligible form header records for migrations and the migrations process.") * [Migration of Related list declarative actions from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://servicenow-prod.fluidtopics.net/Q4z2YCkLcfE1rPokGE3Cwg "Migration of the related list declarative actions from ITSM Agent Workspace to Service Operations Workspace that includes identifying the tables and the migration process.") * [Migration of field decorators from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://servicenow-prod.fluidtopics.net/CV_AbBGYpgr~ezEp3qXjpw "Migration of the field decorators actions from ITSM Agent Workspace to Service Operations Workspace that includes identifying the tables and the migration process.")