Error Reference

Base system update conflict: customization overlaps with upgrade change

Base system update conflict: customization overlaps with upgrade change

Where this appears

This error appears in the upgrade log during ServiceNow instance upgrades when the system attempts to update a base system record that has been customized. The upgrade process automatically skips the conflicting update and records the conflict for manual administrator review and resolution.

Sourdough
Chrome Extension

Debugging this in a real instance?

Sourdough lets you trace "Base system update conflict: customization overlaps with upgrade change" through system logs, script errors, and API health in the ServiceNow tab you are already using.

Add to Chrome

Free to install. Pro $5/month after a 14-day no-card trial.
Pro requires the ServiceNow admin role. Upgrade inside the extension.

Overview
Tasks
CMDB
API
Metrics
Monitor
Internals
Instance:sourdoughdev·Version:Yokohama
Instance StateONLINE
System StatusFully Operational
Session Timeout90 minutes
Logged-In Sessions2 (20 active)
Build Nameyokohama-12-18-2024_p1
IP Address10.159.128.43
Instance HealthHealth Score: 90%
🔥 5dSourdough (Chrome Plugin)Dark Mode

Cause

Modified out-of-box fields, business rules, or script includes that conflict with new upgrade changes to the same records. (high likelihood)

Customized UI policies, client scripts, or ACLs on base system tables that overlap with upgrade modifications. (high likelihood)

Direct modifications to base system workflows, notification rules, or scheduled jobs that are being updated in the new release. (medium likelihood)

Custom dictionary overrides or table extensions that conflict with base system schema changes in the upgrade. (medium likelihood)

Modified system properties or application configurations that are being changed by the upgrade package. (low likelihood)

Fix

Step 1: Navigate to System Definition > Upgrade History and locate the specific upgrade conflict record to identify the affected table and record.

Step 2: Review the conflict details in the upgrade log to understand what base system changes were skipped and what customizations are causing the overlap.

Step 3: Navigate to System Definition > Update Sets > Retrieved Update Sets to examine the skipped update set and compare the intended changes with current customizations.

Step 4: Create a backup update set containing your current customizations before making any changes to preserve your modifications.

Step 5: Evaluate whether your customization is still necessary or can be replaced by the new base system functionality provided in the upgrade.

Step 6: If customization is still needed, manually merge the base system changes with your customizations by creating a new version that incorporates both sets of changes.

Step 7: Test the merged solution thoroughly in a sub-production instance before applying to production to ensure both upgrade improvements and custom functionality work correctly.

Step 8: Document the resolution in the upgrade conflict record and mark it as resolved to maintain a clear audit trail for future upgrades.

Test Your Knowledge

Quick 3-question quiz. See how your ServiceNow skills stack up.

Question 1 of 3Performance

A list view on a table with millions of records is slow. Best fix?

Select an answer to continue