> ## 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.

# Screening Frequencies Guide

> How to configure ongoing monitoring cadence caps, workspace defaults, and profile group overrides.

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>;
};

Screening frequencies control how often ongoing monitoring runs for Sanctions, PEP, and News on monitored profiles. Use this configuration when different profile populations need different monitoring cadences while staying within organization-level limits.

**Access:** Requires the <strong>Admin</strong> role or above. In the sidebar, go to <strong>Administration</strong> > <strong>Configuration</strong>, then open <strong>Screening frequencies</strong> under <strong>Screening behaviours</strong>.

Use this guide when you need to:

* review the maximum allowed monitoring cadence for each feed
* set workspace-level default cadences
* apply profile group-specific monitoring overrides
* understand how group priority affects monitoring
* review, audit, or roll back frequency changes

<Info>
  Screening frequencies apply to <strong>ongoing monitoring</strong> for
  profiles. They do not change one-off searches, manual API requests, or initial
  profile creation behavior unless those workflows explicitly use ongoing
  monitoring.
</Info>

## How Cadence Resolution Works

Minerva resolves monitoring frequencies in this order:

1. <strong>Organization Caps</strong> define the highest allowed frequency for
   each feed across all workspaces and profile groups.
2. <strong>Workspace settings</strong> define the default cadence for profiles
   in the selected workspace.
3. <strong>Profile group settings</strong> can override the workspace cadence
   for profiles assigned to that group.
4. If a profile belongs to multiple groups, the highest-priority active group wins.
5. If the winning group does not set a feed override, that feed inherits the workspace setting.

<Warning>
  A workspace or profile group cannot be configured to screen more frequently
  than the organization cap for that feed.
</Warning>

## Main Configuration Page

The Screening frequencies page has three sections: Organization Caps, Workspace settings, and Profile group settings.

<StorybookFrame storyId="pages-tenant-config-screening-frequencies--default" title="Screening Frequencies Configuration Page" height={1120} version="20260530-profile-groups" />

### Organization Caps

Organization Caps are the highest frequencies allowed across all workspaces and profile groups.

If your organization does not have explicit caps configured, Minerva uses these defaults:

| Feed                       | Default cap |
| -------------------------- | ----------- |
| <strong>Sanctions</strong> | Daily       |
| <strong>PEP</strong>       | Monthly     |
| <strong>News</strong>      | Monthly     |

These caps are shown for context on the page. They protect tenant-level controls by preventing a workspace or group from silently increasing monitoring beyond what the organization allows.

### Workspace Settings

Workspace settings are the default monitoring cadences for profiles in the selected workspace when no profile group override applies.

Use workspace settings for the baseline population. For example, Live might use Daily Sanctions and Monthly PEP/News, while Calibration can test less frequent monitoring before the settings are promoted or copied into production workflows.

### Profile Group Settings

Profile group settings override workspace defaults for a selected active group. This lets you run tighter or looser monitoring for a customer segment without changing every profile in the workspace.

<StorybookFrame storyId="pages-tenant-config-screening-frequencies--profile-group-overrides" title="Profile Group Screening Frequency Overrides" height={1240} version="20260530-profile-groups" />

Use the profile group selector to switch between groups. The selector keeps long group lists out of the page layout while still allowing each group to carry its own cadence settings.

## Cadence Options

Available cadence options depend on the feed and the organization cap.

| Cadence                       | Meaning                                                                     |
| ----------------------------- | --------------------------------------------------------------------------- |
| <strong>Daily</strong>        | Monitor once per day when the profile is due.                               |
| <strong>Deltas</strong>       | Monitor on supported Sanctions source deltas. Available only for Sanctions. |
| <strong>Weekly</strong>       | Monitor weekly when the profile is due.                                     |
| <strong>Monthly</strong>      | Monitor monthly when the profile is due.                                    |
| <strong>Quarterly</strong>    | Monitor quarterly when the profile is due.                                  |
| <strong>Semiannually</strong> | Monitor twice per year when the profile is due.                             |
| <strong>Annually</strong>     | Monitor once per year when the profile is due.                              |
| <strong>Never</strong>        | Do not run that feed through scheduled ongoing monitoring.                  |

The UI hides or disables options that would exceed the organization cap. For example, if the PEP cap is Monthly, PEP cannot be set to Daily or Weekly at the workspace or profile group level.

## Example Use Cases

| Use case                   | Workspace default                          | Profile group override                                                                                                     |
| -------------------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| Enhanced due diligence     | Sanctions Daily, PEP Monthly, News Monthly | Keep the Enhanced diligence group at the maximum allowed cadence.                                                          |
| Lower-risk retail          | Sanctions Daily, PEP Monthly, News Monthly | Set Retail standard monitoring to Sanctions Weekly, PEP Quarterly, News Quarterly if policy allows.                        |
| Sanctions delta monitoring | Sanctions Daily                            | Set a targeted Sanctions group to Deltas when source-delta processing is the intended operating model.                     |
| Product-driven review      | Standard workspace defaults                | Give Cross-border commercial a tighter Sanctions cadence than the baseline retail population.                              |
| Exit or dormant review     | Standard workspace defaults                | Set selected feeds to Never only when your monitoring policy allows a dormant or exit population to stop scheduled checks. |

<Tip>
  Start with workspace defaults, then add group overrides only for segments that
  have a clear policy reason. Too many overrides make monitoring harder to
  audit.
</Tip>

## Reviewing And Confirming Changes

When you change workspace or profile group frequencies, Minerva shows the standard pending changes bar. Click <strong>Review changes</strong> to inspect the exact deltas before saving.

The review dialog summarizes:

* workspace cadence changes
* profile group cadence changes
* which feeds changed
* the prior and new cadence for each changed feed
* an optional change description for audit history

Use change descriptions to capture the policy reason, such as a risk segmentation rollout, review-volume adjustment, source-delta pilot, or calibration result.

## History And Rollback

The page includes the standard configuration history drawer and history page. Use history to:

* review who changed monitoring cadences and when
* compare prior and current frequency deployments
* preview a historical deployment before rollback
* record rollback as a new audited change

Rollback restores the saved workspace and profile group frequency snapshot when the referenced groups still exist.

## Related Guides

* [Profile Groups Guide](/profile-groups-guide)
* [Profile Groups Concept](/concepts/profile-groups)
* [Screening Guide](/screening-guide)
* [Workspaces Guide](/workspaces-guide)