Create a CMDB remediation rule
A CMDB remediation rule is associated with a task that was created for a failed CMDB health test. A CMDB remediation rule is applied automatically or manually to execute a remediation workflow that can, for example, delete stale CIs.
Before you begin
You must first create and publish a remediation workflow that addresses the CI issue, stored in the Workflow [wf_workflow] table. The workflow can be a regular workflow or an Orchestration workflow, and must adhere to the following requirements:
- The table in the workflow must match the task type in the remediation rule.
- The workflow isn't configured with any filter conditions by setting If condition matches to
None, so that the filters of the CMDB remediation rule will apply.
For more information about using Classic Workflows, see .
Role required: sn_cmdb_admin or itil_admin (on top of sn_cmdb_editor or itil)
Procedure
-
Navigate to All > Configuration > CMDB Remediations.
-
Select New and then fill out the CMDB Remediation Rule form.
|
Field |
Description |
|---|---|
|
Name |
Remediation name. |
|
Task type |
Type of CMDB health-related tasks to apply the remediation to. |
|
Task filter |
Filters tasks to apply remediation to. Also applies dot-walking on CI fields so that remediation is applied to tasks associated with matching CIs. |
|
Execution |
|
|
Active |
Allowing the workflow to run. |
|
Workflow |
The CMDB remediation workflow (regular or Orchestration) that will execute automatically or manually, depending on the Execution setting. You can click the Lookup using list icon, and then click New to create a new workflow. |
Result
If Execution is set to Automatic, then the business rule Run remediations for CMDBHealth task applies the remediation workflow to CIs that match the Task filter. If Execution is set to Manual, then you can manually apply the remediation workflow defined in the rule.
- Apply CMDB remediation
Manually initiate a workflow to remediate a CI that failed a CMDB health test. For example, you can remediate CIs that are orphan or stale.
Parent Topic:CMDB Health
Related topics
CMDB Health experience in CMDB Workspace and in Service Graph Workspace
CMDB Health process tracking and troubleshooting
[bundle-platux.c_DotWalking]
--- title: Create a CMDB remediation rule description: A CMDB remediation rule is associated with a task that was created for a failed CMDB health test. A CMDB remediation rule is applied automatically or manually to execute a remediation workflow that can, for example, delete stale CIs. locale: en-US canonical_url: https://www.servicenow.com/docs/r/servicenow-platform/configuration-management-database-cmdb/t\_CreateCMDBRemediationRule.html release: brazil product: Configuration Management Database \(CMDB\) classification: configuration-management-database-cmdb topic_type: task last_updated: "2026-09-10" reading_time_minutes: 2 breadcrumb: [CMDB Health, Configuration Management Database \(CMDB\), Configuration Management, Extend ServiceNow AI Platform capabilities] --- # Create a CMDB remediation rule A CMDB remediation rule is associated with a task that was created for a failed CMDB health test. A CMDB remediation rule is applied automatically or manually to execute a remediation workflow that can, for example, delete stale CIs. ## Before you begin You must first create and publish a remediation workflow that addresses the CI issue, stored in the Workflow \[wf\_workflow\] table. The workflow can be a regular workflow or an Orchestration workflow, and must adhere to the following requirements: - The table in the workflow must match the task type in the remediation rule. - The workflow isn't configured with any filter conditions by setting **If condition matches** to `None`, so that the filters of the CMDB remediation rule will apply. For more information about using Classic Workflows, see . Role required: sn\_cmdb\_admin or itil\_admin \(on top of sn\_cmdb\_editor or itil\) ## Procedure 1. Navigate to **All** > **Configuration** > **CMDB Remediations**. 2. Select **New** and then fill out the CMDB Remediation Rule form. <table id="table_xfq_njn_q5"><thead><tr><th> Field </th><th> Description </th></tr></thead><tbody><tr><td> Name </td><td> Remediation name. </td></tr><tr><td> Task type </td><td> Type of CMDB health-related tasks to apply the remediation to. </td></tr><tr><td> Task filter </td><td> Filters tasks to apply remediation to. Also applies dot-walking on CI fields so that remediation is applied to tasks associated with matching CIs. </td></tr><tr><td> Execution </td><td> - Manual: Remediation is applied manually. - Automatic: The workflow is applied once, upon the creation of a task that matches the **Task type** and **Task filter**. </td></tr><tr><td> Active </td><td> Allowing the workflow to run. </td></tr><tr><td> Workflow </td><td> The CMDB remediation workflow \(regular or Orchestration\) that will execute automatically or manually, depending on the **Execution** setting. You can click the **Lookup using list** icon, and then click **New** to create a new workflow. </td></tr></tbody> </table>3. Select **Submit**. ## Result If **Execution** is set to Automatic, then the business rule **Run remediations for CMDBHealth task** applies the remediation workflow to CIs that match the Task filter. If **Execution** is set to Manual, then you can manually apply the remediation workflow defined in the rule. - **[Apply CMDB remediation](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/servicenow-platform/configuration-management-database-cmdb/t_ApplyCMDBRemediation.md)** Manually initiate a workflow to remediate a CI that failed a CMDB health test. For example, you can remediate CIs that are orphan or stale. **Parent Topic:**[CMDB Health](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/servicenow-platform/configuration-management-database-cmdb/c_CMDBHealth.md) **Related topics** [Exploring CMDB Health]() [CMDB Health experience in CMDB Workspace and in Service Graph Workspace]() [View CMDB Health Dashboard]() [View relationships health]() [View CI health]() [CMDB Health process tracking and troubleshooting]() [CMDB Health reference]() [bundle-platux.c_DotWalking]
| title | Create a CMDB remediation rule |
| description | A CMDB remediation rule is associated with a task that was created for a failed CMDB health test. A CMDB remediation rule is applied automatically or manually to execute a remediation workflow that can, for example, delete stale CIs. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/servicenow-platform/configuration-management-database-cmdb/t\_CreateCMDBRemediationRule.html |
| release | brazil |
| product | Configuration Management Database \(CMDB\) |
| classification | configuration-management-database-cmdb |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 2 |
| breadcrumb | CMDB HealthConfiguration Management Database \(CMDB\)Configuration ManagementExtend ServiceNow AI Platform capabilities |