> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gominerva.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Repeated Alert Suppression Guide

> How to configure repeated alert suppression for monitored profiles and ongoing screening.

export const StorybookFrame = ({storyId, title, version = "20260419-1", height, zoom = 0.7, preferLocalPreview = false}) => {
  const HOSTED_STORYBOOK_BASE_URL = "https://minerva-storybook.s3.ca-central-1.amazonaws.com/iframe.html";
  const isLocalDocsPreview = typeof window !== "undefined" && ["localhost", "127.0.0.1"].includes(window.location.hostname);
  const storybookBaseUrl = preferLocalPreview && isLocalDocsPreview ? "http://localhost:6006/iframe.html" : HOSTED_STORYBOOK_BASE_URL;
  const params = new URLSearchParams({
    id: storyId,
    viewMode: "story",
    singleStory: "true",
    shortcuts: "false",
    toolbar: "0",
    nav: "0",
    panel: "0"
  });
  params.set("v", version);
  const src = `${storybookBaseUrl}?${params.toString()}`;
  const unscaledHeight = `${Math.ceil(height / zoom)}px`;
  const unscaledWidth = `${100 / zoom}%`;
  return <div style={{
    width: "100%"
  }}>
      <div style={{
    height: `${height}px`,
    overflow: "hidden",
    border: "1px solid #e2e8f0",
    borderRadius: "12px",
    backgroundColor: "#ffffff",
    display: "flex",
    justifyContent: "center",
    alignItems: "flex-start"
  }}>
        <iframe src={src} title={title} loading="lazy" style={{
    width: unscaledWidth,
    height: unscaledHeight,
    transform: `scale(${zoom})`,
    border: "0",
    display: "block",
    transformOrigin: "top center",
    flexShrink: 0
  }} allowFullScreen></iframe>
      </div>
    </div>;
};

Repeated alert suppression helps your team reduce repeated sanctions, PEP, and adverse media noise for profiles that stay on ongoing monitoring.

**Access:** Requires the <strong>Admin</strong> role or above. In the
sidebar, go to <strong>Administration</strong> >

<strong>Configuration</strong>, then open
<strong>Repeated Alert Suppression</strong> under
<strong>Screening Behaviours</strong>.

Use this guide when you need to:

* understand how repeated monitoring alerts are grouped for the same profile
* choose between the built-in suppression presets
* create or maintain workspace presets for your operating model
* tune the matching rules that control when repeated alerts stay visible or are suppressed
* review change confirmations, deployment history, and rollback options

<Info>
  Repeated alert suppression is a <strong>Screening</strong> feature. It depends
  on <a href="/minerva-profiles">profiles</a>, because profiles preserve the
  monitored subject across the initial onboarding screen and every later
  screening run.
</Info>

<Info>
  <strong>Balanced</strong> is the default repeated alert suppression
  configuration for every organization. No action is required to turn on
  Balanced: it is already enabled by default unless your organization has
  explicitly changed the repeated alert suppression settings.
</Info>

## Before You Begin

* confirm your screening is managed in Minerva with <strong>profiles</strong>, not only as one-off searches through the API
* confirm the profiles are actively part of your ongoing monitoring workflow with monitored statuses
* confirm you have access to organization-level Screening configuration with role Admin or above
* review the <a href="/screening-guide">Screening Guide</a> if you need a refresher on profile and alert review workflows

## How Repeated Alert Suppression Works

Repeated alert suppression is designed for repeated monitoring on the same profile.

At a high level, Minerva:

1. uses the profile as the persistent reference for the screened subject
2. compares a new monitoring result to prior matched results for that same profile
3. evaluates the configured rules for name, date of birth, location, adverse media article similarity, and source changes
4. decides whether the new result should stay visible as a fresh alert or be treated as repeat noise

This means repeated alert suppression is most useful after the initial onboarding or first screening event. Once a profile exists, Minerva can compare later screening results against that profile's existing monitoring history.

<Tip>
  Repeated alert suppression does not replace analyst review. It is meant to
  reduce repeated noise for the same monitored subject while keeping materially
  different or newly significant results visible.
</Tip>

## Main Configuration Page

The Repeated Alert Suppression page combines four ideas in one place:

* the global on or off state for suppression
* the built-in or organization preset that acts as the baseline
* the advanced rule controls that tune repeat-detection behavior
* the change-review and history tools used to deploy, audit, and roll back updates

<StorybookFrame storyId="pages-tenant-config-alert-suppression--default" title="Repeated Alert Suppression Configuration Page" height={960} />

### Preset and Suppression State

At the top of the page, Minerva shows:

* <strong>Repeated Alert Suppression Enabled</strong>: turns live suppression on
  or off for the organization
* <strong>Ruleset preset</strong>: selects the preset that provides the current
  baseline
* <strong>Current display state</strong>: shows whether the current draft still
  matches a saved preset or has drifted to <strong>Custom</strong>

If you start from a built-in or organization preset and then tune individual controls, the display state can switch to <strong>Custom</strong> even while the draft remains anchored to the original preset for comparison.

For most organizations, this section will already show <strong>Repeated Alert
Suppression Enabled</strong> with <strong>Built-in: Balanced</strong> selected,
because Balanced is the shipped default configuration.

### Workspace Presets

In addition to the built-in presets, each workspace can maintain its own reusable presets.

Workspace presets let you:

* save a custom draft as a reusable preset
* rename a preset and update its description
* overwrite a preset with the current draft values
* delete a preset from the library without deleting the live repeated alert suppression configuration

Use preset names and descriptions to capture the operational context, such as:

* the risk posture the preset supports
* the business unit or review workflow it was designed for
* the reason the preset exists

## Built-In Presets

Minerva includes three built-in presets. Built-in presets stay fixed.

<strong>Balanced</strong> is the default preset and is already enabled for all
organizations unless an administrator has changed the configuration. Use the
other presets only when you have a clear reason to move away from that default
baseline.

### Conservative

Use <strong>Conservative</strong> when your team prefers broader analyst visibility and wants to suppress only the clearest repeats.

Key behavior:

* uses stricter name and location matching so only stronger repeats are grouped
* keeps date-of-birth matching tight and still expects exact month and day when both are present
* requires more corroborating identity evidence before suppression is allowed
* keeps name-only repeat behavior narrow, with a more limited focus on <strong>PEP</strong> noise
* keeps adverse media more sensitive by treating <strong>any new article</strong> as alert-worthy and requiring a shared location when both records include one

### Balanced

Use <strong>Balanced</strong> when you want the default Minerva posture for repeated sanctions, PEP, and adverse media monitoring noise.

Key behavior:

* uses moderate name and location matching designed to reduce repeated monitoring noise without grouping too aggressively
* keeps date-of-birth checks tight when that information is present
* requires meaningful corroborating identity evidence before suppression
* applies name-only repeat behavior across <strong>Sanctions</strong>, <strong>PEP</strong>, and <strong>News</strong>
* keeps adverse media visible when an article appears materially different, while suppressing closer repeat coverage

### Aggressive

Use <strong>Aggressive</strong> when recurring monitoring results create significant repeat noise and you want broader suppression.

Key behavior:

* uses broader name and location matching so more recurring noise is grouped as repeat activity
* allows more date-of-birth flexibility than the other built-in presets
* still expects corroborating identity evidence, but is more willing to suppress repeated noise once that evidence is present
* applies broader name-only repeat behavior across <strong>Sanctions</strong>, <strong>PEP</strong>, and <strong>News</strong>
* treats adverse media most aggressively by suppressing additional article churn after the same subject has already been established

### Shared Defaults Across The Built-In Presets

All three built-in presets start with:

* a recent-history lookback window for repeat comparison
* <strong>Sanctions new-source alert</strong> turned off
* <strong>PEP new-source alert</strong> turned off

Turn on the new-source alerts only when you want Minerva to re-surface same-identity sanctions or PEP matches after genuinely new source labels appear.

## Understanding Algorithms And Scores

Most similarity rules use a normalized score from <strong>0.00</strong> to <strong>1.00</strong>.

* a score closer to <strong>1.00</strong> means the two values look more similar
* a higher threshold is usually <strong>stricter</strong>, so fewer borderline repeats will be suppressed
* a lower threshold is usually <strong>broader</strong>, so more repeated noise may be grouped together

### Algorithm Guidance

| Algorithm                      | What it does                                 | When to use it                                                                                                                      |
| ------------------------------ | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| <strong>Exact</strong>         | Requires the text to match exactly.          | Use it when the source data is already standardized and even small spelling or formatting differences should keep results separate. |
| <strong>Cosine bigram</strong> | Compares overlapping two-character patterns. | Use it for a balanced fuzzy match on names or article text that may vary slightly between sources.                                  |
| <strong>Token jaccard</strong> | Compares overlap between whole-word tokens.  | Use it when word order or phrasing often changes, especially for multi-part locations.                                              |

### How To Think About Higher And Lower Values

* <strong>Similarity thresholds</strong>: higher means stricter matching and
  usually fewer suppressions
* <strong>History window</strong>: higher means Minerva looks farther back and
  can suppress more recurring noise
* <strong>Date-of-birth year window</strong>: higher means more year drift is
  tolerated
* <strong>Minimum corroborating signals</strong>: higher means stronger identity
  evidence is required before suppression
* <strong>Minimum matching locations</strong>: higher means more location
  corroboration is required
* <strong>New-source minimums</strong>: higher means more new sources must
  appear before a fresh sanctions or PEP alert is shown

## Rule-By-Rule Controls

### History Window

Use <strong>Previous searches to scan</strong> to control how far back Minerva looks for prior matched monitoring results.

* range: <strong>1 to 10</strong> previous searches
* higher values usually suppress more recurring alerts
* lower values keep older prior results from influencing the decision

### Name Similarity

Use the <strong>Algorithm</strong> and <strong>Similarity threshold</strong> controls to decide how closely a new result name or alias must resemble a prior one before Minerva treats it as the same repeat.

* threshold range: <strong>0.00 to 1.00</strong>
* higher threshold: stricter name matching
* lower threshold: broader name grouping

### Date Of Birth

Use these controls when date-of-birth evidence matters to your review process:

* <strong>Allowed DOB window (+/- years)</strong>: range
  <strong>0 to 10</strong>
* <strong>Require exact month/day when both are present</strong>: adds a
  stricter check whenever both records include month and day detail

Use tighter settings when date of birth is usually complete and reliable. Use looser settings only when the data sources often carry partial or slightly inconsistent DOB information.

### Location Similarity

Use the location controls when geography helps distinguish repeated results for the same subject.

* <strong>Algorithm</strong>
* <strong>Location similarity threshold</strong>: range
  <strong>0.00 to 1.00</strong>
* <strong>Minimum matching locations</strong>: range <strong>1 to 5</strong>

Raise the threshold or the minimum count when you want more geographic corroboration before suppression.

### Strong Identity

Use <strong>Minimum corroborating signals</strong> to control how many strong identity signals must align before Minerva allows suppression.

* range: <strong>1 to 3</strong> corroborating signals
* higher values make suppression more conservative
* lower values make suppression easier to trigger

### Name-Only Repeat

Use this rule when you want Minerva to suppress repeated name-only noise even when date of birth or location evidence is limited.

Controls:

* <strong>Name-only repeat threshold</strong>: range
  <strong>0.00 to 1.00</strong>
* <strong>Feeds</strong>: choose from <strong>Sanctions</strong>,
  <strong>PEP</strong>, and <strong>News</strong>

If no feeds are selected, Minerva will not apply the name-only repeat rule until at least one feed is chosen.

### Adverse Media

Adverse media has the richest set of controls because Minerva needs to decide both whether the subject looks like the same person or organization and whether the article looks like the same story.

Controls:

* <strong>Article treatment</strong>
* <strong>Subject algorithm</strong>
* <strong>Subject similarity threshold</strong>
* <strong>Article algorithm</strong>
* <strong>Article similarity threshold</strong>
* <strong>Require a shared location when both records include one</strong>

Article treatment options:

* <strong>Any new articles alert</strong>: use this when every new adverse media
  article should still appear for review
* <strong>Only dissimilar articles alert</strong>: use this when near-duplicate
  coverage should usually be suppressed but materially different stories should
  remain visible
* <strong>No new articles alert</strong>: use this only when repeated article
  churn should be heavily suppressed after Minerva has already established the
  same subject

### Sanctions New-Source Alert

Use this control when the same monitored identity should alert again only if additional sanctions source labels appear.

* status toggle: on or off
* <strong>Minimum new sanctions sources</strong>: range <strong>1 to 10</strong>

### PEP New-Source Alert

Use this control when the same monitored identity should alert again only if additional PEP source labels appear.

* status toggle: on or off
* <strong>Minimum new PEP sources</strong>: range <strong>1 to 10</strong>

## Reviewing And Confirming Changes

When you click <strong>Review changes</strong>, Minerva does not save immediately. Instead, it shows a grouped confirmation view that helps you verify what is about to change.

The review dialog shows:

* the number of changes and sections affected
* a grouped summary for each rule family
* the current value and the new value side by side
* a short tone label such as <strong>Will update</strong>, <strong>Will enable</strong>, or <strong>Will disable</strong>
* an optional <strong>Change Description</strong> field

Use the change description to capture the business reason for the update. That description is then available later in configuration history.

<StorybookFrame storyId="components-tenant-config-alert-suppression-save-review-dialog--default" title="Repeated Alert Suppression Save Review Dialog" height={780} />

## Deployment History And Rollback

The Repeated Alert Suppression page includes a quick <strong>History</strong> drawer so you can preview recent deployments without leaving the configuration page.

Use the drawer to:

* see the current live deployment first
* review older deployments as rollback candidates
* preview an older deployment in the current page before committing to it
* jump to the full audit history page

<StorybookFrame storyId="components-tenant-config-alert-suppression-history-drawer--default" title="Repeated Alert Suppression Quick History Drawer" height={560} />

### How Rollback Works

Rollback is a controlled restore flow, not a destructive undo.

When you select an older deployment:

1. Minerva previews that historical configuration in the current page
2. the page remains in preview mode until you cancel or continue
3. if you continue, Minerva shows the grouped rollback review before anything is applied
4. when you confirm, Minerva writes a <strong>new rollback history entry</strong> and makes that restored configuration live

Important behavior:

* rolling back does not delete prior history entries
* the rollback itself becomes part of the audit trail
* Minerva will block a rollback when the selected history entry already matches the current live configuration

## Full Audit History Table

Use the full history page when you need the complete audit record, not just the recent quick-compare list.

The table includes:

* <strong>Changed</strong>: when the configuration was saved or rolled back
* <strong>Action</strong>: whether the event was an update or a rollback
* <strong>Summary</strong>: the key rule or preset changes from that deployment
* <strong>Changed by</strong>: the user who performed the action
* <strong>Actions</strong>: rollback entry points for older deployments

You can also:

* filter by actor name or email
* filter by <strong>All changes</strong>, <strong>Updates</strong>, or <strong>Rollbacks</strong>
* sort by changed time, action, or actor
* page through the full history set

<StorybookFrame storyId="pages-tenant-config-alert-suppression-history--default" title="Repeated Alert Suppression Full History Page" height={660} />

## Recommended Tuning Approach

If you are configuring repeated alert suppression for the first time:

1. begin by reviewing the existing <strong>Balanced</strong> baseline, since it is already enabled by default
2. change one rule family at a time so the effect is easier to understand
3. add a clear change description whenever you save
4. use history and rollback if a tuning pass proves too broad or too strict

This usually produces a cleaner operating model than moving directly to the most aggressive settings.

## Related Guides

* <a href="/screening-guide">Screening Guide</a>
* <a href="/minerva-profiles">Profiles</a>
* <a href="/workspaces-guide">Workspaces Guide</a>
* <a href="/bulk-actions-guide">Bulk Actions Guide</a>
