Baseline CMDB
Baseline CMDB provides capabilities that help you understand and control the changes that have been made to your configuration items (CIs) in the CMDB.
Note: Starting with the Brazil release, Baseline CMDB is being prepared for future deprecation. It will be hidden and no longer activated on new instances but will continue to be supported. Unified Map provides the latest experience for this functionality. For more information, refer to the Application/Plugin Deprecation Process [KB05484748] article in the Now Support Knowledge Base.
-
You can create a baseline, which is a snapshot of your configuration items in the CMDB. You can review the changes that have been made to that configuration item since a previous baseline. Multiple baselines may be created and the system tracks the changes that have been made per baseline.
Creating a baseline captures the attributes of the CI and all first-level relationships for the CI. Any changes to the base CI or to any related CIs are captured and displayed. Newly created CIs aren't automatically added to a baseline.
-
Associate a configuration item with a task, a change or change task, and to propose changes to the CI after the change is complete. You can record changes, and these changes aren't applied to the CI immediately but are delayed until the change is complete.
When the change is complete, you can choose to apply the proposed changes which makes all changes previously proposed and associates the changes with the task.
For information about planning and implementing a baseline CMDB, see the CMDB Baseline life-cycle best practices and Diff Formatter troubleshooting [KB0829681] knowledge base article.
Create a CMDB baseline
You can create a baseline for a CI to track updates to the CI over time.
Before you begin
Role required: ecmdb_admin, and sn_cmdb_editor or itil
Procedure
-
Navigate to All > Configuration > Baselines > Baselines.
-
Click New.
-
Enter a Name for the baseline.
By default, the cmdb_ci table is selected so that the record creates the baseline for all configuration items in the system.
-
To limit the baseline to specific CIs, select a different Table or choose Conditions that a CI must meet for it to have a baseline entry.
For example, you might create a baseline for the Database table with the condition [Location] [is] [<configured location>].
-
Click Submit.
The creation of a baseline is time consuming and occurs in the background. A message at the top of the record list notifies you that your baseline has been scheduled and you will receive an email when the process is complete.
Display baseline differences
You can see the changes that have been made to a CI or any first level related CIs by configuring the CI form layout to display the CMDB Baseline diff field. This field is labeled Baseline differences on the form.
Before you begin
Role required: sn_cmdb_editor or itil
About this task
Changes are displayed only for the cmdb_ci table and child tables. You can change the com.cmdb.baseline.max_changes system property to limit the number of relationships and changes that appear in a baseline diff section on a CI form (set to 100 by default).
Procedure
-
Open a CI record.
-
Select the baseline you want to see for this CI from the choice list.
The field displays the details of any changes that were made to the current record for the selected baseline, or indicates that no changes were made.
-
To add a relationship to the CI, click the green plus icon in the Related Items toolbar.
The new relationship appears below the toolbar. For more information about the Related Items toolbar and how to control the display, see CI relations formatter.
-
Update a related CI and see the changes displayed as Basic attribute changes in the current CI record.
What to do next
To improve performance and prevent memory issues when showing large amounts of baseline differences data on CI forms, complete the following steps:
- Set the system property com.cmdb.baseline.entry.attachment to true.
- Manually run once the CMDB Baseline convert XML to attachment fix script. For information about running a fix script, see .
Related topics
Properties for baseline CMDB
Use the baseline CMDB properties to configure how many changes and relationships for a CI can appear in the baseline diff for the CI.
These properties are available for baseline CMDB. To view and edit these properties, the sn_cmdb_admin or admin role is required.
|
Property |
Description |
|---|---|
|
Maximum number of changes and relationships for a CI that can appear in the baseline diff for the CI. com.cmdb.baseline.max_changes |
|
|
com.cmdb.baseline.entry.attachment |
Lets you manually run the CMDB Baseline convert XML to attachment fix script. Setting this property to true and then running the CMDB Baseline convert XML to attachment fix script, enables improved performance when showing large amounts of baseline differences data on CI forms. When false, the CMDB Baseline Diff component uses legacy methods which might fail to load large amounts of baseline differences data.
|
---
title: Baseline CMDB
description: Baseline CMDB provides capabilities that help you understand and control the changes that have been made to your configuration items \(CIs\) in the CMDB.You can create a baseline for a CI to track updates to the CI over time.You can see the changes that have been made to a CI or any first level related CIs by configuring the CI form layout to display the CMDB Baseline diff field. This field is labeled Baseline differences on the form.Use the baseline CMDB properties to configure how many changes and relationships for a CI can appear in the baseline diff for the CI.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/servicenow-platform/configuration-management-database-cmdb/c\_BaselineCMDB.html
release: australia
product: Configuration Management Database \(CMDB\)
classification: configuration-management-database-cmdb
topic_type: concept
last_updated: "2026-09-10"
reading_time_minutes: 4
breadcrumb: [Configuration Management Database \(CMDB\), Configuration Management, Extend ServiceNow AI Platform capabilities]
---
# Baseline CMDB
Baseline CMDB provides capabilities that help you understand and control the changes that have been made to your configuration items \(CIs\) in the CMDB.
**Note:** Starting with the Brazil release, Baseline CMDB is being prepared for future deprecation. It will be hidden and no longer activated on new instances but will continue to be supported. [Unified Map](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/unified-map/unified-map-landing-page.md) provides the latest experience for this functionality. For more information, refer to the [Application/Plugin Deprecation Process \[KB05484748\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0867184) article in the Now Support Knowledge Base.
- You can create a baseline, which is a snapshot of your configuration items in the CMDB. You can review the changes that have been made to that configuration item since a previous baseline. Multiple baselines may be created and the system tracks the changes that have been made per baseline.
Creating a baseline captures the attributes of the CI and all first-level relationships for the CI. Any changes to the base CI or to any related CIs are captured and displayed. Newly created CIs aren't automatically added to a baseline.
- Associate a configuration item with a task, a change or change task, and to propose changes to the CI after the change is complete. You can record changes, and these changes aren't applied to the CI immediately but are delayed until the change is complete.
When the change is complete, you can choose to apply the proposed changes which makes all changes previously proposed and associates the changes with the task.
For information about planning and implementing a baseline CMDB, see the [CMDB Baseline life-cycle best practices and Diff Formatter troubleshooting \[KB0829681\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0829681) knowledge base article.
## Create a CMDB baseline
You can create a baseline for a CI to track updates to the CI over time.
### Before you begin
Role required: ecmdb\_admin, and sn\_cmdb\_editor or itil
### Procedure
1. Navigate to **All** > **Configuration** > **Baselines** > **Baselines**.
2. Click **New**.
3. Enter a **Name** for the baseline.
By default, the cmdb\_ci table is selected so that the record creates the baseline for all configuration items in the system.
4. To limit the baseline to specific CIs, select a different **Table** or choose **Conditions** that a CI must meet for it to have a baseline entry.
For example, you might create a baseline for the Database table with the condition **\[Location\] \[is\] \[<configured location>\].**
5. Click **Submit**.
The creation of a baseline is time consuming and occurs in the background. A message at the top of the record list notifies you that your baseline has been scheduled and you will receive an email when the process is complete.
## Display baseline differences
You can see the changes that have been made to a CI or any first level related CIs by configuring the CI form layout to display the CMDB Baseline diff field. This field is labeled Baseline differences on the form.
### Before you begin
Role required: sn\_cmdb\_editor or itil
### About this task
Changes are displayed only for the cmdb\_ci table and child tables. You can change the **com.cmdb.baseline.max\_changes** system property to limit the number of relationships and changes that appear in a baseline diff section on a CI form \(set to 100 by default\).
### Procedure
1. Open a CI record.
2. Select the baseline you want to see for this CI from the choice list.
The field displays the details of any changes that were made to the current record for the selected baseline, or indicates that no changes were made.
3. To add a relationship to the CI, click the green plus icon in the **Related Items** toolbar.
The new relationship appears below the toolbar. For more information about the Related Items toolbar and how to control the display, see [CI relations formatter](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/configuration-management-database-cmdb/c_CIRelationsFormatterNG.md).
4. Update a related CI and see the changes displayed as **Basic attribute changes** in the current CI record.
### What to do next
To improve performance and prevent memory issues when showing large amounts of baseline differences data on CI forms, complete the following steps:
1. Set the system property **com.cmdb.baseline.entry.attachment** to true.
2. Manually run once the **CMDB Baseline convert XML to attachment** fix script. For information about running a fix script, see .
**Related topics**
[Timeline of CI changes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-security/c_HistoryTimeline.md)
## Properties for baseline CMDB
Use the baseline CMDB properties to configure how many changes and relationships for a CI can appear in the baseline diff for the CI.
These properties are available for baseline CMDB. To view and edit these properties, the sn\_cmdb\_admin or admin role is required.
<table id="table_uwy_fwz_mhb"><thead><tr><th>
Property
</th><th>
Description
</th></tr></thead><tbody><tr><td>
Maximum number of changes and relationships for a CI that can appear in the baseline diff for the CI.
com.cmdb.baseline.max\_changes
</td><td>
- Type: integer
- Default value: 100
- Location: **Configuration** > **CMDB Properties** > **Baseline Properties**
</td></tr><tr><td>
com.cmdb.baseline.entry.attachment
</td><td>
Lets you manually run the **CMDB Baseline convert XML to attachment** fix script. Setting this property to true and then running the **CMDB Baseline convert XML to attachment** fix script, enables improved performance when showing large amounts of baseline differences data on CI forms.
When false, the CMDB Baseline Diff component uses legacy methods which might fail to load large amounts of baseline differences data.
- Type: true \| false
- Default value: false
- Location: [Add to System Properties \[sys\_properties\]](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/t_AddAPropertyUsingSysPropsList.md) table.
- Learn more: [Baseline CMDB](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/configuration-management-database-cmdb/c_BaselineCMDB.md)
</td></tr></tbody>
</table>| title | Baseline CMDB |
| description | Baseline CMDB provides capabilities that help you understand and control the changes that have been made to your configuration items \(CIs\) in the CMDB.You can create a baseline for a CI to track updates to the CI over time.You can see the changes that have been made to a CI or any first level related CIs by configuring the CI form layout to display the CMDB Baseline diff field. This field is labeled Baseline differences on the form.Use the baseline CMDB properties to configure how many changes and relationships for a CI can appear in the baseline diff for the CI. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/servicenow-platform/configuration-management-database-cmdb/c\_BaselineCMDB.html |
| release | australia |
| product | Configuration Management Database \(CMDB\) |
| classification | configuration-management-database-cmdb |
| topic_type | concept |
| last_updated | 2026-09-10 |
| reading_time_minutes | 4 |
| breadcrumb | Configuration Management Database \(CMDB\)Configuration ManagementExtend ServiceNow AI Platform capabilities |