---
sourceDocument: Brazil IT Service Management
sourceDocumentLink: https://www.servicenow.com/docs/r/it-service-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# Migration to ITSM Mobile Agent 5.0.3

# Migration to ITSM Mobile Agent 5.0.3 {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read  
Migrating to ITSM Mobile Agent 5.0.3 updates legacy icon sections, UI parameters, and card views so that the app supports the Next Experience theme and accessibility enhancements.  
This migration includes the following component changes:

* Migration of legacy icon sections to navigation sections. It includes better grouping of icon sections for on-call scheduling and incidents along with color variables for icons.
* Migration of legacy UI parameters to new input form screens. It simplifies the way parameters are defined, enables theming on the input form screen, and supports accessibility enhancements by Mobile Platform.
* Migration of legacy card views to mobile views. It allows using color variables as per theme.
* All styling changes can be done through UI rules instead of UI styles.
* For buttons that perform a positive action, button emphasis has changed from primary to positive.
{#migrate-itsm-mobile-agent-5.0.3__ul_uxj_mys_fwb}  
When you migrate from an earlier version to ITSM Mobile Agent 5.0.3, the following steps are automatically performed:

* When the plugin.upgraded event is triggered for the ITSM Mobile Agent (sn_itsm_mobile_agt) application, the Run clean upgrade for ITSM Mobile Agent script action is run.
* This script action invokes the following upgrade APIs:
  * For legacy icon sections to new navigation sections, the cleanUpgradeIconSections() method from the sn_itsm_mobile_agt.MobileUtahUpgradeEngine script include.
  * For legacy UI parameters to new input form screens, the cleanUpgradeButtonInstance() method from the sn_itsm_mobile_agt.MobileUtahUpgradeEngine script include.
  * For legacy cards to new mobile views, the cleanUpgradeLegacyCards() method from the sn_itsm_mobile_agt.MobileUtahUpgradeEngine script include.
  * The sn_itsm_mobile_agt.MobileIconSectionMigrationConstant map contains key-value pairs. The key is the sys_id of the legacy default configuration. The value is an object with a comma-separated list of metadata for the corresponding new default configuration added during the upgrade.
  {#migrate-itsm-mobile-agent-5.0.3__ul_jlh_vys_fwb}
* After the script action is run and performs all the required actions, it is deactivated so that it isn't run again on future upgrades.
{#migrate-itsm-mobile-agent-5.0.3__ul_mzl_rys_fwb}

## Migration of legacy icon sections to navigation sections {#migrate-itsm-mobile-agent-5.0.3__section_pb1_xzs_fwb}

In this case, the sn_itsm_mobile_agt.MobileIconSectionMigrationConstants script include contains the following key-value pairs:

* Key: sys_id of the legacy default sys_sg_icon_section record.
* Value: Object with a comma-separated list of sys_ids of sys_sg_navigation_section and sys_sg_applet_launcher_m2m_section records.
{#migrate-itsm-mobile-agent-5.0.3__ul_shm_zzs_fwb}  
The Run clean upgrade for ITSM Mobile Agent script action upgrade script runs to perform the following steps for each key in the map:

1. The script checks the following records for customizations.
   * Legacy default sys_sg_icon_section record.
   * Whether the legacy default icon section has at least one more or one fewer sys_sg_applet_launcher_m2m_section record when compared to the new default icon section.
   {#migrate-itsm-mobile-agent-5.0.3__ul_trd_d1t_fwb}
2. Based on customizations, one of the following steps is performed.
   * If any of these records are customized, the script deactivates the new default sys_sg_navigation_section record.
   * If none of these records are customized, the script deactivates the legacy default sys_sg_icon_section record.
   {#migrate-itsm-mobile-agent-5.0.3__ul_wrd_d1t_fwb}
{#migrate-itsm-mobile-agent-5.0.3__ol_av1_d1t_fwb}  
Note:  
* Custom icon sections that are not available by default continue to function but may not support Next Experience theme and accessibility compliance. Customers must migrate them to navigation sections for a better experience.
* For customized default icon sections, manually review any legacy default icon sections that are still active. Move customizations to the new default navigation sections.
* Migrate customized icon sections to the new navigation sections. Without migration, users may experience compatibility issues with the new Next Experience theme and accessibility problems.
{#migrate-itsm-mobile-agent-5.0.3__ul_y35_31t_fwb}

## Migration of UI parameters to input form screen {#migrate-itsm-mobile-agent-5.0.3__section_bc2_k1t_fwb}

In this case, the sn_itsm_mobile_agt.MobileInputFormScreenMigrationConstants script include contains the following key-value pairs:

* Key: sys_id of the legacy default sys_sg_button_instance record.
* Value: Object with comma-separated list of sys_ids of the new default sys_sg_button_instance record and other metadata.
{#migrate-itsm-mobile-agent-5.0.3__ul_cxg_n1t_fwb}  
The Run clean upgrade for ITSM Mobile Agent script action upgrade script then runs to perform the following steps for each key in the map:

1. The script checks the following records for customizations.
   * Legacy default sys_sg_button_instance record.
   * sys_sg_button record associated with the sys_sg_button_instance record.
   * sys_sg_ui_parameter and sys_sg_action_param_map records associated with the sys_sg_button record.
   * sys_sg_write_back_action_item record associated with the sys_sg_button record.
   {#migrate-itsm-mobile-agent-5.0.3__ul_exg_n1t_fwb}
2. Based on customizations, one of the following steps is performed.
   * If any of these records are customized, the script deactivates the new default sys_sg_button_instance record.
   * If none of these records are customized, the script deactivates the legacy default sys_sg_button_instance record.
   {#migrate-itsm-mobile-agent-5.0.3__ul_hxg_n1t_fwb}
{#migrate-itsm-mobile-agent-5.0.3__ol_dxg_n1t_fwb}  
Note:  
* Custom button instance flows (UI Params) that are not available by default continue to function but may not support Next Experience theme and accessibility compliance. Customers must migrate them to input form screens for a better experience.
* For custom button instance flows (UI Params) that are available by default, manually review the active legacy default sys_sg_button_instance records. Move customizations to the new sys_sg_button_instance flow using the `sn_itsm_mobile_agt.MobileInputFormScreenMigrationConstants` map. To configure input form screens on mobile, see [Input form screen](https://www.servicenow.com/docs/access?context=parameter-input-screen&version=brazil&pubname=brazil-mobile&ft:locale=en-US).
* If customized UI parameters are not migrated to the new input form screens, users will have a mixed experience. This experience may not be fully compatible with the Next Experience theme and can lead to accessibility issues.
{#migrate-itsm-mobile-agent-5.0.3__ul_ixg_n1t_fwb}

## Migration of item views to mobile cards {#migrate-itsm-mobile-agent-5.0.3__section_w44_y1t_fwb}

In this case, the sn_itsm_mobile_agt.MobileIconSectionMigrationConstants script include contains the following key-value pairs:

* Key: sys_id of the legacy default sys_sg_item_view record.
* Value: Object with a comma-separated list of sys_ids of sys_sg_form_screen and sys_sg_master_item records where legacy card (that is, item view) is referenced.
{#migrate-itsm-mobile-agent-5.0.3__ul_dvy_z1t_fwb}  
The Run clean upgrade for ITSM Mobile Agent script action upgrade script then runs to perform the following steps for each key in the map:

1. The script checks the following records for customizations.
   * Legacy default sys_sg_item_view record.
   * All sys_sg_ui_style records associated with the sys_sg_item_view record.
   {#migrate-itsm-mobile-agent-5.0.3__ul_fvy_z1t_fwb}
2. If any of the mentioned records are customized, the script reverts the sys_sg_form_screen and sys_sg_master_item records to previous state only if these records are not customized.
{#migrate-itsm-mobile-agent-5.0.3__ol_evy_z1t_fwb}  
Note:  
* Custom item views that are not available by default continue to function but may not support Next Experience theme and accessibility compliance. Customers must migrate them to mobile cards for a better experience.
* For customized item views available by default, manually review the old default flows that are still active. Move any customizations to the new flow. For information about configuring cards on mobile, see [Customize a screen using Mobile Card Builder](https://www.servicenow.com/docs/access?context=mcb-customize-item-view&version=brazil&pubname=brazil-mobile&ft:locale=en-US).
* Migrating customized item views to mobile cards is required. Without migration, users may encounter theme incompatibilities and accessibility issues.
{#migrate-itsm-mobile-agent-5.0.3__ul_hvy_z1t_fwb}