ConfigBot for ServiceNow - Upgrade Preview
Upgrade Preview for ServiceNow helps teams efficiently analyze and prepare for ServiceNow upgrades by providing a centralized view of configuration changes, potential conflicts, and upgrade impacts before they are applied to the target instance. It enables administrators and developers to review customized configurations against the upgraded version, identify changes introduced by the upgrade, and understand which components may require attention.
Users can seamlessly perform upgrade analysis, comparison, and validation across different versions of ServiceNow configurations. The module helps identify modified, added, or conflicting records and provides visibility into potential upgrade-related issues, allowing teams to assess the impact of customizations and make informed decisions before proceeding with an upgrade.
Designed for proactive upgrade management and risk reduction, Upgrade Preview helps administrators maintain configuration integrity, minimize unexpected issues, and ensure a smoother and more controlled ServiceNow upgrade process. By providing clear insights into configuration differences and potential conflicts, ConfigBot enables teams to prepare, validate, and manage upgrades with greater confidence.
The following article explains how to use the Upgrade Preview module in ConfigBot to analyze upgrade changes, identify potential conflicts, compare configurations, and perform different upgrade-related operations.
Step 1: Log in to ConfigBot
Enter your username and password, then click Submit to access the portal.

Step 2: Access the Upgrade Preview Module
From the Home Screen, Navigate to Impact Analysis and click on the Upgrade Preview module tile.

Configure Upgrade Preview Analysis
Step 1: Create New Iteration and Select Analysis Type:
Click the Gear Icon to create a new iteration and start the analysis process.

The Gear icon provides two options:
- New Analysis: Configure and initiate a new Upgrade Preview analysis.
- Existing Analysis: Select an iteration that has already been created and configured to reuse it.

For this walkthrough, we will create a new iteration to configure and initiate a new Upgrade Preview analysis.

Step 2: Provide Release Title and Select Preview Type:
Upgrade Release Title: Enter the ServiceNow upgrade release title you want to check and preview against your current instance version. If you leave this field empty, ConfigBot analyzes the instance and retrieves the available ServiceNow upgrade release titles, allowing you to identify the upgrade releases available for the selected instance.
Preview Type:
Select one of the following options from the dropdown
- Execute Preview: Starts a new Upgrade Preview analysis in the ServiceNow instance using the specified Upgrade Release Title.
- Check & Execute Preview: Checks whether an Upgrade Preview already exists in the instance for the specified Upgrade Release Title. If an existing preview is found, ConfigBot retrieves its details and populates the report. Otherwise, ConfigBot creates and executes a new Upgrade Preview.

Step 3: Fill in Required Details:
- Enter the Iteration Number
- Select the Workspace or ADD New Workspace
- Enter your Company ID
- Enter Host Address
- Enter Your Username
- Enter your Instance Password
- Add a Description

Step 4: Upgrade Preview Processing
Now Upgrade Preview process is initiated.

After executing the Upgrade Preview, the process typically takes approximately 30 to 180 minutes, depending on the ServiceNow instance and the upgrade process.
During this period, ConfigBot continuously monitors the ServiceNow process and waits for it to complete.
To check the bot's current status, click the History icon.

The logs provide details about the bot's current activity and the progress of the Upgrade Preview process.

Step 5: Report Generation
Once ServiceNow completes the Upgrade Preview process, ConfigBot detects the completion and proceeds to generate the report.

Users can then select the completed iteration to access and review the generated report.
Step 6: Review the Upgrade Preview Report
Navigate to the Upgrade Preview Iterations sections and select the completed Iteration.

Once you select the iteration, you can view the generated Upgrade Preview report.

The report presents the results of the Upgrade Preview analysis, helping administrators review information associated with the selected ServiceNow upgrade release.
The report contains the following sections:
1. Upgrade Lead
- Provides an overview of the Upgrade Preview analysis, including the number of records listed under Predicted Skips to Review, the number of records Auto Reviewed, and the number requiring Manual Review.
- This section also includes a horizontal bar chart that visualizes the distribution of records across the categories defined by ConfigBot.

2. Developer Worklist
The Developer Worklist tab allows users to review the details of records identified during the Upgrade Preview analysis.

This section also supports configuration actions, which are explained in the Automation section later in this article.
The generated report categorizes records to help administrators identify updates that require attention and determine which records need further review.
The report includes the following categories:
- Auto Reviewed: A record is marked as Auto Reviewed when there are no differences between its current and previous versions, it is not configured as a skip record, and no previous version exists for the associated record.
- Needs a Manual Review: A record is marked as Needs a Manual Review when differences are identified between its current and previous versions.
Click a record to view the details associated with the update.

Depending on the record, the following options may be available:
- Compare: Opens the comparison screen in the ServiceNow instance, allowing you to review the differences between the current and previous versions.
- View Skipped Record: Opens the ServiceNow record associated with the skipped update in the Upgrade Preview.
- Compare Values: Displays the previous and current values of the selected record fields within the current view.
Automation (Configure Records using ConfigBot):
Step 1: Select the Records:
In the Developer Worklist tab, select the respective records you want to run automation on.

When you select the record you can see three available actions:
- View Compare → Redirect you to instance to view the differences between the current and previous versions of the record associated with the update.
- Retain Customization → Allows you to retain your customizations for the respective record during the upgrade.
- Revert to Base System → Allows you to revert the respective record to the ServiceNow upgrade release version, removing the existing customization.
For this demonstration, we will perform the Retain Customization operation. After clicking the Retain Customization button, the Push to Instance option becomes available at the top of the workspace.

Click to run the automation.
In the pop-up window
- Enter the user’s password
- And Click on Push to Instance button

Step 3: Check the Status
Iteration is being Processed, you can check logs from Execution history

Step 4: Review the Results
Once the Automation Status changes to Complete, a new card appears displaying the number of records selected for the operation.

You can also review the status of each record after automation by navigating to the Developer Worklist tab.


This workflow enables administrators to identify available ServiceNow upgrade releases, execute an Upgrade Preview analysis, review predicted skips and record changes, and apply the appropriate actions to retain customizations or revert to the base system.
Compare (Compare Multi Instance Upgrade Preview Report):
You can also compare Upgrade Preview analyses across multiple ServiceNow instances by selecting the relevant iterations from the dropdown in the top-left corner of the workspace.
Open the dropdown in the top-left corner of the workspace.
Select the desired iterations corresponding to the ServiceNow instances you want to compare.

Click Compare Instances to initiate the comparison.
After clicking Compare Instances, navigate to the Developer Workspace section. The records will have an additional option called Compare Summary.

Click Compare Summary to view a side-by-side comparison of the selected record across the two ServiceNow instances.

This view helps administrators identify differences in record availability and compare the associated upgrade-related information.
Understanding the comparison results:
- Skipped Record Does Not Exist: Indicates that the record is not triggered for current preview.
- NA: Indicates that the record exists in the instance, but its current version is missing for that particular skipped record.
- No Data in Compare: Indicates that either the current version or the previous version of the record is missing from the instance, so the comparison data is unavailable.
These indicators help administrators identify missing records or versions and understand why comparison details may not be available for a particular record.
Thank You
Updated on: 10/17/2026
Thank you!