Homepage deprecation help tool
Summarize
Summary of Homepage deprecation help tool
The Homepage deprecation help tool in ServiceNow's Zurich release helps you identify, convert, retire, and restore homepages by consolidating all homepages in one place. It is designed to facilitate the migration from traditional homepages to responsive dashboards, improving user experience and system consistency.
Show less
To use this tool effectively, administrators must first:
- Set the system property com.glideapp.home.deprecatehomepages to true to disable creation of new homepages and make dashboards the default landing pages.
- Populate the homepage migration status table to track homepage statuses.
Note that menu items and URLs linking to homepages will continue to point to them until updated.
Key Features
- Homepage deprecation dashboard: Provides centralized access with four tabs for managing homepages:
- Overview: Start the deprecation process and monitor homepage status reports including counts of deprecated, converted, retired, and restored homepages.
- Personal homepages: Lists homepages owned by inactive or locked-out users, enabling targeted retirement or conversion.
- Menus and Favorites: Shows homepages linked to menus (requiring menu reconfiguration) and those marked as favorites (requiring user communication to update favorites).
- Usage: Identifies homepages not viewed in the last 30 days, which are candidates for retirement.
- Reports and visualizations: Reports include single-score counts and bar charts showing homepage assignments to users and groups, with interactive links to detailed homepage lists.
- Migration actions: Convert homepages to dashboards, retire unused or personal homepages, and restore retired homepages as dashboards as needed.
Practical Considerations for ServiceNow Customers
- Disabling new homepage creation ensures users transition to dashboards, but existing menus and URLs must be manually updated to avoid broken navigation.
- Use the tool’s reports and tabs to prioritize homepages for migration based on usage, ownership, and presence in menus or favorites.
- Communicate with users about favorites updates when homepages are converted to dashboards to maintain their personalized experience.
- Retiring homepages owned by inactive users helps clean up the instance and improve performance.
Use the Homepage deprecation help tool to find all of your homepages in one place and convert them to dashboards, retire them, and restore retired homepages as dashboards.
To access the Homepage deprecation dashboard, navigate to .
- Disable the creation of new homepages: Set the system property com.glideapp.home.deprecate_homepages to true.Important:When set to true, this property disables the creation of new homepages and sets the default start page or landing page to Dashboards. Menu items and URLs that open homepages will continue to point to those homepages. Otherwise, homepages are unavailable and should be migrated using this tool.
- Populate the homepage migration status table.
- Overview
- The overview enables you to start the deprecation process and view the general status of the homepages on your instance.
- Personal homepages
- A list of all the homepages that are owned by individuals who are inactive or locked out of the instance. Personal homepages are different than Global homepages, which are accessible to all users.
- Menus and Favorites
- Lists of homepages that appear on configured menus and homepages that are marked as favorites by users. In the first case, you must reconfigure the menu item to point to the converted dashboard. In the second case, you must alert users to mark the new converted dashboard as a favorite.
- Usage
- A list of all the homepages that have not been viewed in the last 30 days.
Overview tab
The Overview tab includes links for getting started and several reports that enable you to choose homepages that need attention.
In the How to start section, admins have links to disable creation of new homepages and to populate the homepage migration status table.
| Report | Type | Description |
|---|---|---|
| Homepages not deprecated |
|
Number of homepages that you have not converted or retired. Select this report to see the associated homepages on the Homepage migration status table. |
| Converted homepages |
|
Number of homepages that you’ve converted to responsive dashboards. Select this report to see the associated homepages on the Homepage migration status table. |
| Retired homepages |
|
Number of homepages that you’ve retired. Select this report to see the associated homepages on the Homepage migration status table. |
| Restored homepages |
|
Number of retired dashboards that you’ve restored as responsive dashboards. Select this report to see the associated homepages on the Homepage migration status table. |
| Assigned to users |
|
Homepages that are assigned to users. The bar labeled empty accounts for homepages that don’t have any assigned users. Select any bar in this report to see the associated homepages on the Homepage migration status table. |
| Assigned to groups |
|
Homepages that are assigned to groups. The bar labeled empty accounts for homepages that don’t have any assigned groups. Select any bar in this report to see the associated homepages on the Homepage migration status table. |
| All converted homepages from app and other actions |
|
All dashboards that have been converted from homepages, whether in the help tool, or by other means. |
Personal homepages
This tab shows a list of the homepages whose owners are inactive or otherwise locked out. These homepages may be good candidates for retirement. Select the link to open a filtered list containing only the personal homepages to retire or convert them.
Menus and Favorites
- Homepages connected to menus
- Shows the homepages that are connected to menus in the filter navigator. When you convert or retire these homepages, you must point the menu item to the converted dashboard or remove the menu item.
- Homepages connected to favorites
- Shows homepages that users identify as a favorite. When you convert or retire these homepages, tell them that they should mark the converted dashboard as a favorite.
- Menus and Modules connected to Homepages
- Shows homepages that appear in the filter navigator as either menu items or modules. Edit the menu and module items to open the converted dashboard. Remove menu or module items that open retired homepages.
Usage
The Usage tab shows a list of all homepages not viewed in the last 30 days. These homepages may be good candidates for retirement.