Manage attestations

Published

December 23, 2025

Enable attestation participants to step through the attestation process required by your organization.

flowchart LR
    A["**Add attestation template**"] --> B["**Complete required sections**"]
    B --> C["**Optional: Test or manage**"]

The steps required to set up attestation

Setting up attestations involves adding an attestation template and completing the required sections: attestation periods, attestation participants, and questionnaire template. Optionally, you can also set the inventory scope, add attestation fields, start attestation schedules to test the process, and edit or cancel attestation periods.

Prerequisites

Add attestation templates

  1. In the left sidebar, click Settings.

  2. Under Workspace, select Attestation Templates.

  3. Click Add Attestation Template.

  4. Enter a name and description for the attestation template.

  5. Click Add Attestation Template.

  6. Complete the required sections as described below.

To edit an existing attestation template:

  1. In the left sidebar, click Settings.

  2. Under Workspace, select Attestation Templates and then click an attestation template to edit.

NoneTips
  • Avoid overlap — Only one attestation period can be active at a time.
  • Schedule individually — You cannot schedule recurring attestation periods.

Attestation periods reflect the time zone of the user setting up attestation and they trigger in the time zone of the submitter.

NoneStakeholder versus role
  • Submitter — A model stakeholder assigned directly to a model
  • Reviewer — A role responsible for reviewing attestations within their assigned groups
  • Approver — A role responsible for approving attestations within their assigned groups

Attestation submissions are organized by owner and group. This approach ensures reviewers and approvers have appropriate permissions for models in their groups.

NoneTip

Work with your model risk management team to create a template that accurately reflects your organization’s attestation requirements.

How do I create meaningful attestation questionnaires?

Attestation periods are typically scheduled quarterly or annually and should be configured to align with regulatory or internal review cycles:

  1. Click Add Attestation Period.

  2. Enter a name for the attestation period, such as Quarterly attestation.

  3. Set the start date for the attestation period.

  4. Set the end date when the attestation period ends.

  5. Optional: Toggle email reminders to send reminders to Submitters, Reviewers, and Approvers:

    • days before end — How many days before the end date to send the reminder.
    • subject — The email subject line.
    • body — The email body with dynamic variables.

    Available template variables: {Recipient Name}, {Attestation Name}, {Reminder Reason}, {Start Date}, {End Date}, {Schedule Name}, {Status Text}.

  6. Click Add Period.

When the attestation period begins, the system triggers the process automatically. Attestation participants are then notified via a banner on their dashboard prompting them to complete their attestation tasks.

Assign users and roles responsible for this attestation. Each participant type has a specific responsibility in the attestation workflow:

  1. Under Attestation Participants, select the submitter from the model stakeholders dropdown:

    • Model Owner
    • Model Developer
    • Model Validator

  2. Select the reviewer from the roles dropdown.

  3. Select the approver from the roles dropdown.

  4. Click Save.

Define which models are included in the attestation process. By default, all models are included. Use filters to narrow the scope based on model fields, stages, or custom attributes.

  1. Under Inventory Scope, click Add Rule to add a filter condition.

Filtering supports simple and complex conditions using AND or OR logic with nested groups. You can filter on both the default fields created by ​ValidMind and custom fields created by your organization.

Rules

Rules define individual conditions to filter by, such as the business unit or owner.

To add a rule:

  1. Click click Add Rule to add a filter condition.

    A filter rule contains three components:

    A new filter row with three components

Field selector
Dropdown to choose the field type to filter by.
Operator selector
Dropdown to select the comparison operator.
Value editor
Input area that varies based on the selected field type.
  1. From the field selector dropdown, select one of:
  1. From the operator dropdown, select one of:
    Available operators update based on the field selector
Operator selector options
Text fields Date fields Number fields Boolean fields Multi-select fields
equals equals equals equals in
not equals not equals not equals not equals not in
contains before greater than is empty contains
begins with after less than is not empty is empty
ends with between between is not empty
is empty is empty is empty
is not empty is not empty is not empty
  1. From the value editor, enter or select a value based on the field type:
    Value input changes based on field selector
Text
Text input or text area for longer content
Date
Date picker
Number
Number input or range slider
Boolean
Checkbox
Select/multi-select
Dropdown with search
Entity fields
Dropdown with search for users or models

  1. (Optional) Add more rules by following the same steps.

  2. Click Apply Filters.

Groups

Groups combine multiple rules that are evaluated together and can be nested one level deep. You use groups for more complex filters, such as Condition A AND (Condition B OR Condition C).

To add a group:

  1. Click Add Group to create a nested group of conditions.

  2. Follow the same steps as in Rules to add one or several conditions to the group.

  3. Click Apply Filters.

A rule AND a group of OR rules

Example: Use case is Attrition/Churn Management AND (Business Unit is Commerical Banking OR Business Unit is Retail Banking)

Combinators

Combinators define how multiple rules or groups are logically combined when matching conditions. By default, multiple rules are combined with AND logic, meaning all conditions must match.

Supported combinators:

  • AND — All conditions must match
  • OR — At least one condition must match

To change the combinator:

  1. Click the AND or OR button between rules or groups to change how conditions are combined.

  2. Click Apply Filters.

The AND and OR combinators

Why can’t I use both AND and OR top-level combinators?

Combinators must evaluate logically for the filter to be applied:

  Show items matching Condition A AND Condition B OR Condition C
  Show items matching Condition A AND (Condition B OR Condition C)

To achive more complex filters, use groups.

View active filters

After applying filters, active filter conditions appear as individual chips next to the label Filtered by:.

  • Field names
  • Operators
  • Values

Remove active filters

Click the icon on any filter chip to remove that specific filter condition. The remaining filters are automatically reapplied.

Examples

Available values depend on your organization’s custom configuration

Show models where Model Inventory Field: Risk Level is High (requires that you have a custom select field called Risk Level):

  1. On the Inventory page, click Filter.

  2. Click Add Rule:

    • Field = Model Inventory Field: Risk Level
    • Operator = equals
    • Value = High

  3. Click Apply Filters.

Show models that are Model Stage: In Production AND in Business Unit: Risk Management:

  1. On the Inventory page, click Filter.

  2. On the Select Your Filters dialog that opens, click Add Rule:

    • Field = Model Stage
    • Operator = in
    • Value = In Production

  3. Add another rule:

    • Field = Business Unit
    • Operator = in
    • Value = Risk Management

  4. Click Apply Filters.

Show models that are (Model Stage: In Production AND in Business Unit: Risk Management) OR (Model Stage: In Production AND in Use: Attrition/Churn Management):

  1. On the Inventory page, click Filter.

  2. Click Add Rule to add your rules:

    1. First rule:
      • Field = Model Stage
      • Operator = in
      • Value = In Production
    2. Second rule:
      • Field = Business Unit
      • Operator = in
      • Value = Risk Management

  3. Click Add Group to create a new group:

    1. Change combinator to OR (between the two groups).

    2. In the new group, click Add Rule to add:

      1. First rule:
        • Field = Model Stage
        • Operator = in
        • Value = In Production
      2. Second rule:
        • Field = Use
        • Operator = in
        • Value = Attrition/Churn Management

  4. Click Apply Filters.

Show models where (Model Stage: Active OR In Periodic Review) AND (Risk Level: High OR Medium) AND Owner: John Doe:

  1. On the Inventory page, click Filter.

  2. Click Add Group to add your groups:

    1. First group:
      • Field = Model Stage
      • Operator = in
      • Value = In Production, In Periodic Review
    2. Second group:
      • Field = Model Inventory Field: Risk Level
      • Operator = equals
      • Value = High, Medium

  3. Add Rule to add a rule:

    • Field = Owner
    • Operator = in
    • Value = John Doe

  4. Ensure all groups and rules use AND combinator.

  5. Click Apply Filters.

Show models implemented between January 1, 2025 and January 31, 2025:

  1. On the Inventory page, click Filter.

  2. Add Rule:

    • Field = Implementation Date
    • Operator = between.
    1. Enter start date — January 1, 2025
    2. Enter end date — January 31, 2025

  3. Click Apply Filters.

Show models owned by a specific user that have .pdf attachments:

  1. On the Inventory page, click Filter.

  2. Click Add Rule:

    • Field = Owner
    • Operator = in
    • Value = Select the user from dropdown.

  3. Add another rule:

    • Field = Attachments
    • Operator = file name contains
    • Value = .pdf.

  4. Ensure the combinator between rules is set to AND.

  5. Click Apply Filters.

  1. Click Save.

  2. Optional: Click See Models to preview which models match your filter criteria.

How do I filter for groups?

To filter for groups, you first need to define these user groups in your organization’s settings. Then filter using the Group field in the inventory scope.

A screenshot of the inventory scope editor showing the process of adding a filter condition to filter for Group A, Group B, and Group C.

Filtering for user groups

By default, attestations include the model name. Add additional model inventory fields as needed:

  1. Under Relevant Attestation Fields, drag model inventory fields between columns:

    • Model Inventory Fields — Available fields from the model inventory
    • Relevant Attestation Fields — Selected fields to display in model snapshots

  2. Optional: Reorder the fields to change how they display in the attestation.

Attestation questionnaires should confirm that key controls, governance processes, and documentation requirements have been followed.

  1. Under Questionnaire Template, click the template area to edit. You can add rich text fields such as:

    • Instructions
    • Links to guidelines
    • Checkboxes
    • Lists
    • Other custom elements

    An animation of the questionnaire template editor showing the process of adding a question about documentation of compliance to the template with the instructions to confirm that required documentation, such as model documentation, validation reports, and change logs, has been completed.

    A screenshot of the questionnaire template editor

  2. After you complete your edits, click Save.

The attestation questionnaire is now ready to be used in future attestation instances, to be completed by submitters, reviewed by reviewers, and signed off by approvers.

Test attestation schedules

ImportantNot normally required

These steps are optional and not required to set up attestation — perform only under the direction of ValidMind.

For testing purposes only, you can trigger the attestation process:

  1. In the left sidebar, click Settings.

  2. Under Workspace, select Attestation Templates and then click the attestation template to test.

  3. Under Attestation Periods, hover over an attestation period.

  4. When appears, select Start Now.

  5. Click Confirm.

After starting the schedule, attestation participants are notified via My Inbox that the attestation is ready to be completed.

Edit attestation periods

  1. In the left sidebar, click Settings.

  2. Under Workspace, select Attestation Templates and then click the attestation template to edit.

  3. Under Attestation Periods, hover over an attestation period.

  4. When appears, select Edit.

  5. Make your desired changes to the following:

    • name
    • start date
    • end date

  6. Click Save Period.

Edits to an attestation period will be effective for future occurrences but do not affect previous or in-progress attestation periods.

Cancel attestation periods

ImportantCanceling an attestation period is permanent

This action cannot be undone. The history of previous attestation periods is unaffected by this action.

  1. In the left sidebar, click Settings.

  2. Under Workspace, select Attestation Templates and then click the attestation template to manage.

  3. Under Attestation Periods, hover over an attestation period.

  4. When appears, select Cancel Period.

  5. Click Confirm to cancel the period.

View details

View the status and progress of attestation instances for an active attestation period.

Attestation details view

Attestation details view

To access attestation details:

  • From the banner when an attestation period is active: Click View Details.
  • Under Attestation Periods, hover over an attestation period and when appears, select View Details.

The details view shows:

  • Progress chart — Attestations by status: Not Started, In Progress, Ready For Review, Reviewed, Signed Off
  • Total attestations — The count of all attestation instances
  • Search — Filter by group, owner, reviewer, or approver
  • Attestation table — Columns for Group, Owner, Reviewer, Approver, Status, and Last Updated

Each combination of group and owner creates a separate attestation instance. This allows multiple attestations to run simultaneously, with each submitter responsible for their own group’s attestation.