---
updatedAt: 2026-10-12T07:39:36.000Z
agentTools:
  projectIndex: https://docs.sumsub.com/llms.txt
---

# Manage rules

Manage rules effectively.

This page covers the operations available for managing transaction monitoring rules in the Dashboard: installing rules from the library, activating or deactivating them, testing rules without affecting live transactions, publishing rules from Sandbox to Production, muting repeated alerts, deleting and restoring rules, duplicating existing rules, and reviewing version history.

# Install rules

To install rules from the rules library:

1. In the Dashboard, open the [Rules library](https://cockpit.sumsub.com/checkus#/kyt/rulesManager/rulesLibrary) page.
2. Find the rule bundle that contains the rules you need.
3. On the right of the rule name, select **Install rule**.

> To install all rules in the bundle, click **Install bundle**. To install specific rules, select them in the table and click **Install selected rules**.

<Image src="https://files.readme.io/106516deb5a367569f44b179c985ea5eb1fb7ccd93290eba99b096c48d8a5a7b-image.png" framed={true} />

<Callout icon="📘" theme="info">
  ### Note

  - Built-in pre-scoring rules are read-only and cannot be edited.
  - All rules that you install remain in Test mode until you [activate them](https://docs.sumsub.com/sumsub/docs/manage-rules#activate-and-deactivate-rules). Test mode allows rules to be [tested](https://docs.sumsub.com/sumsub/docs/tm-testing) without affecting the transaction final score or status.
</Callout>

## Group rules by use case

When use cases are enabled for your account, the **Rules library** groups rules by use case instead of by bundle. For each use case:

* The group header shows the use-case name and an X of Y rules installed counter.
* If you have the **Manage KYT rules** <Anchor target="_blank" href="doc:user-roles#permissions">permission</Anchor>, an **Install use case** button installs every remaining rule in that use case at once.
* Once every rule in a use case is installed, the header shows an Installed status instead of the button.
* Groups with more than three rules are collapsed to the first three.&#x20;

A **Use cases** column and a multi-select **Use cases** filter are also available in both the **Rules library** and **Installed rules** tables.

# Activate and deactivate rules

To activate and deactivate rules:

1. In the Dashboard, open the [Installed rules](https://cockpit.sumsub.com/checkus#/kyt/rulesManager/rulesList) page.
2. Find the rules that you want to activate or deactivate, and in the **Status** column, select **Active** — to use the selected rule during monitoring or **Inactive** — to cease the rule usage.

Alternatively, you can select rules in the table, and at the bottom of the page, click **Activate rule** or **Deactivate rule**.

<Image src="https://files.readme.io/e6066dc4cd3506b451e691c6d6fb856f0a721b6252ae6119328b781b95f9f2fc-image.png" framed={true} />

# Rules in Test mode

Test mode allows you to test the risk matrix or check how the newly created rule or condition would affect your transactions without impacting the transaction status or risk score. Test results are displayed in real time, allowing you to easily calibrate your risk policy or rules.

To enable test mode:

1. In the Dashboard, open the [Installed rules](https://cockpit.sumsub.com/checkus#/kyt/rulesManager/rulesList) page.
2. Find the rules that you want to test, and in the **Status** column, select **Test mode**.

For more information about testing, see [this article](https://docs.sumsub.com/sumsub/docs/tm-testing).

<Image src="https://files.readme.io/c598a26ff38122330be364fa56b38d3e23355d3990c3d78b0caa0402f27444d9-image.png" framed={true} />

# Copy rules from Sandbox to Production

Rules can be created, configured, and tested in Sandbox or Test mode without affecting Production.&#x20;

To make a configured rule live, you must copy it to Production. Click **Publish to production&#x20;**&#x61;t the bottom of the screen, and the rule will be created in Production in Test mode.

If a rule with the same name already exists in Production, the published rule will be added as a new copy, for example, **My Rule \[1]**.

<Callout icon="📘" theme="info">
  ### Note

  The **Publish to production** button is displayed in Sandbox mode only. It is also not available for sandbox-only license keys, which have no Production environment.
</Callout>

# Mute rules for selected period

In some AML scenarios, only the first rule alert matters, as it marks the point of concern. Muting rules allows you to suppress repeated rule alerts for the same applicant and prevent risk score accumulation.&#x20;

You can mute a rule at the transaction level and at the rule settings level.

Rule-level muting works automatically for any applicant when the target rule is triggered for the first time after muting is set up. It prevents alerts on all subsequent matches for the selected applicant.

Transaction-level muting silences rule alerts for a specific applicant for the first transaction that triggered the rule and all subsequent transactions initiated by this applicant directly from a matched transaction with optional data filters.

In both cases the information about the triggered rules is still <Anchor target="_blank" href="doc:review-aml-cases">added to a case.</Anchor>

## Rule-level muting

To mute a rule at the rule settings level:

1. In the Dashboard, navigate to the [Installed rules](https://cockpit.sumsub.com/checkus/kyt/rulesManager/rulesList) page or [Rules library](https://cockpit.sumsub.com/checkus/kyt/rulesManager/rulesLibrary), open the rule you want to mute, and click **Edit rule** in the upper-right corner of the screen.
2. In the **Configurations&#x20;**&#x73;ection on the right select the **Mute** box.
3. Adjust the mute period.
4. Save your changes.

<Image src="https://files.readme.io/052f88ac85f16600c0172930595a261172d1a707aa1c2d8c786123ea6ba1c2c0-Screenshot_2026-06-09_at_4.13.18_PM.png" framed={true} />

## Transaction-level muting

To mute a rule at the transaction level:

1. In the Dashboard, navigate to the [Transactions](https://cockpit.sumsub.com/checkus/kyt/txns) page and open a transaction.
2. Scroll down to the **Matched rules** section and at the bottom click the bell icon.

<Image src="https://files.readme.io/7f9fea668a4937ed510ff905bae3e0af72da907d5b4a1049e8d427d381155e87-image.png" framed={true} />

3. Specify the mute end date or mute period.

![](https://files.readme.io/cfbf57fafc8aac73b94fe619ea1ba6f0815abc6a75455eeefcd9f071524ae111-image.png)

4. If you want to limit the mute by counterparty, transaction creation date, or any other parameter, pick the needed expression from the **Expressions** drop-down list.

![](https://files.readme.io/e243b8090fc146d1ea916d76fb60ec30e7c27380578e979a1ee8ec286f8db057-image.png)

5. Click **Mute**.

> You can find all the muted rules in the **Transactions** section of the applicant profile.

<Callout icon="📘" theme="info">
  ### Note

  The muted rules will still be triggered for transactions that meet specified conditions.
</Callout>

# **Delete** rules along with their revisions

Declutter your Dashboard by removing rules you no longer use:

1. In the Dashboard, open the [Installed rules](https://cockpit.sumsub.com/checkus#/kyt/rulesManager/rulesList) page.
2. Find the rules that you want to remove, and from the menu on the right, select **Delete rule**.

Alternatively, you can select rules in the table, and at the bottom of the page, click **Delete rule(s)**.

<Image src="https://files.readme.io/2a80b8f84eee64516bb067c6826ec941e0c257d73b899db7c51d611db758e6cc-image.png" framed={true} />

# Restore occasionally deleted rules

After deletion, a rule remains in the system as archived for 30 days. In case a rule was deleted occasionally, or you decide to continue using this rule, you can easily restore it within this period.

To restore an archived rule:

1. In the Dashboard, navigate to [Archived Rules](https://cockpit.sumsub.com/checkus/kyt/rulesManager/archivedRules).
2. Select the rule you want to restore.
3. Click on the revert changes icon and confirm your choice.

After this, the rule will be returned to the installed rules list.

<Callout icon="🚧" theme="warn">
  ### Important

  After 30 days, all deleted rules are removed permanently and cannot be restored.
</Callout>

<Image src="https://files.readme.io/095d6bc8ed87881b91d126a1e3843f8272ff4cf0e8d25b69267a35d6cb974f0b-Revert.png" align="center" framed={true} />

# Duplicate existing rules

Make an exact copy of any of your existing rules in case you want to create a new rule and add some changes:

1. In the Dashboard, open the [Installed rules](https://cockpit.sumsub.com/checkus#/kyt/rulesManager/rulesList) page.
2. Find the rules that you want to duplicate, and from the menu on the right, select **Duplicate**.

<Image src="https://files.readme.io/c383e517cb010615ce09b1f5092aaf4c7372a8c82d7a4846935f1c1c5d2d1231-image.png" framed={true} />

# Review version history

Each update that you make to the existing rules is saved as an independent revision so that you can get back to any of the previous rule states:

1. In the Dashboard, open the [Installed rules](https://cockpit.sumsub.com/checkus#/kyt/rulesManager/rulesList) page.
2. Open the rule for which you want to see the revision history.
3. In the top-right corner, select **Version history**.

<Image src="https://files.readme.io/0cf838d4c74f379737fe801a096ae1f50155ed4bfde867846e2879d0a4deefbc-Version_history.png" align="center" framed={true} />