Manage attestations

Published

January 30, 2026

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 fields that accurately reflect 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.

Define the structured fields that submitters fill out as part of the attestation process. Each field becomes a question in the questionnaire and appears as a column in the Responses tab for consolidated reporting.

  1. Under Questionnaires, click Add Field.

  2. Configure the field:

    • field type — Select the input type:
      • Single Line Text
      • Multi Line Text
      • Checkbox
      • Dropdown
      • Number
      • Date
    • field label — Enter the question or prompt shown to submitters
    • description — Optional context about the field
    • help text — Optional guidance displayed to users
    • required field — Toggle to require submitters to complete this field before submission

  3. Click Add Field.

  4. Repeat to add additional fields as needed.

  5. Optional: Reorder fields by dragging them to change the order in which they appear to submitters.

Questionnaire fields are available immediately for new attestation instances. Submitters see structured inputs for each field, and responses are collected consistently across all submissions.

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 attestations dashboard

When an attestation period is active or completed, the Attestations item appears in the left sidebar. This dashboard provides a centralized view for tracking, reviewing, and exporting attestation data.

To access the dashboard:

  1. In the left sidebar, click Attestations.

  2. Use the dropdown at the top to select the attestation period to view. You can choose from active periods or view completed historical periods.

The dashboard organizes information across five tabs:

Before and after toggle for comparing snapshots

Before and after snapshot comparison

The Progress tab displays a swimlane view of all attestation submissions organized by status:

  • Not Started — Submissions awaiting action from submitters.
  • In Progress — Submissions currently being completed.
  • Ready for Review — Submissions awaiting reviewer action.
  • Reviewed — Submissions awaiting approver sign-off.
  • Signed Off — Completed submissions.

Click any submission card to view its details, including the questionnaire responses and associated models.

The Responses tab provides a consolidated view of all questionnaire responses across submissions. Each questionnaire field appears as a column, making it easy to compare responses and identify patterns.

Use this view to:

  • Review all submissions at a glance.
  • Compare responses across different submitters.
  • Export responses for compliance reporting.

The Inventory tab shows a snapshot of all models included in the attestation scope at the time the period started. This provides an organization-wide view of the model inventory state.

Click any model to view its snapshot details in a modal, which displays the model field values captured at that point in time. Click View Live Data to navigate to the current model inventory record.

For completed attestation periods, use the Before and After toggle to compare the model state at the start versus the completion of the period.

The Validation Issues tab shows all validation issues that were open at the time of the snapshot, including:

  • Title and artifact ID
  • Severity and status
  • Associated inventory model
  • Risk area, assignee, and due date

The Artifacts tab displays model artifacts captured in the snapshot, organized by artifact type.

Export attestation data

Export attestation data in CSV or Excel format for external reporting and compliance documentation.

  1. Navigate to the Attestations dashboard.

  2. Select the tab containing the data to export: Progress, Responses, Inventory, Validation Issues, or Artifacts.

  3. Click Export in the upper right.

  4. Choose your preferred format and save the file.

Complete attestation periods

When all submissions in an attestation period have been signed off, the period is automatically marked as complete. Administrators can also manually complete a period before all submissions are finished.

ImportantCompleting a period triggers a final snapshot

When a period is completed, the platform captures a final snapshot of all models and artifacts. This enables before/after comparison in the Inventory tab.

To manually complete an attestation period:

  1. In the left sidebar, click Settings.

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

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

  4. When appears, select Complete Period.

  5. Click Confirm.

After completing a period, no further actions can be taken on any submissions, regardless of their current status.

Delete attestation templates

Remove attestation templates that are no longer needed. When a template is deleted, all related data including schedules, executions, and snapshots is automatically cleaned up.

ImportantDeletion is blocked for active periods

You cannot delete an attestation template if it has any active attestation periods. Complete or cancel all active periods before deleting the template.

  1. In the left sidebar, click Settings.

  2. Under Workspace, select Attestation Templates.

  3. Locate the template to delete and hover over it.

  4. When appears, select Delete.

  5. Click Confirm to delete the template.