Validate that tabs are moved to a target dashboard

task brazil Updated Sep 10, 2026 2 min read validate-dashboard-tabs-moved.md
Raw file servicenow.com

When you move a dashboard with an update set, validate that the tabs are moved to the target instance and are populated.

Before you begin

Role required: admin.

About this task

Moving dashboards from one instance to another requires associating the sys_id values of dashboard tabs with the sys_id values of the associated portal pages. This task explains how to find these values and map them to each other if there are problems with moving the dashboard. Perform this task after you Move a Core UI dashboard with an update set.

Procedure

  1. In the target instance, navigate to the dashboard you have just moved.

  2. Select the context menu icon ([Omitted image "icon-context-p.png"] Alt text:) and select Dashboard Properties.

  3. For each tab in the tab form, verify that the required field Page (sys_portal_page reference) is there.

    If every tab has an associated portal page, then the dashboard was successfully moved.

  4. If the portal page in the target instance is missing in any of the tab forms, perform these steps:

    1. Select the context menu icon ([Omitted image "icon-context-p.png"] Alt text:) in the Tab form and select Copy sys_id.

    2. In the filter navigator of the source instance, enter pa_tabs.list.

    3. Filter the list to show only the tab with the sys_id you copied in substep a.

    4. Select the name of the tab to open its form.

    5. Select the information icon ([Omitted image "IconInformation.png"] Alt text:) of the Page value for that tab.

    6. On the Portal Page, select the context menu icon ([Omitted image "icon-context-p.png"] Alt text:) and select Copy sys_id.

      Paste this value into the text editor.[Omitted image "copy-sys-id.png"] Alt text: Copy sys_id

      This value is the sys_id for the portal page. It is different than the sys_id for the associated tab that you have already used. These values are used together to map the tab to the portal page.

    7. Select the search icon ([Omitted image "List_SearchIcon.png"] Alt text:) associated with the Page field.

    8. In the pop-up window, filter on the portal page sys_id and select the returned query result.

    9. Select Update in the Tab form to save your changes.

  5. Ensure that all of the objects used in the dashboard, such as widgets, data visualizations, and content blocks are migrated to the target instance.

    The associated portal page should be visible in the target instance.

  6. If you can't find the portal page in the target, perform the following:

    1. Follow Step 4 a-f to obtain the sys_id of the portal page on the source instance.

    2. In the source instance, navigate to Homepage Admin > Pages.

    3. Filter the list to show only the portal page with the sys_id you copied.

    4. Right-click the record and select Unload Portal Page.[Omitted image "unload-portal-page.png"] Alt text: Portal page record context menu with the item Unload portal page selected.

    5. Move the update set to another instance using standard update set functionality.

      For more information, see Retrieve an update set.

Search documentation
Search document titles and file paths on the brazil branch