Add and manage artifacts

Published

May 26, 2026

Add artifacts at the record or documentation section level, update your artifacts to include proposed remediation plans and supporting documentation, or delete artifacts that no longer need to be tracked.


Prerequisites

Add artifacts on documentation

  1. In the left sidebar, click Inventory.

  2. Select a record or find your record by applying a filter or searching for it.5

  3. In the left sidebar that appears for your record, click Documents and select the Latest tab.6

  4. Click on a Development type file.7

  5. On your record’s documentation page, click Add Artifact.

  6. Select the artifact type8 you want to add:

    • Validation Issue
    • Policy Exception
    • Limitation

  7. On the modal that opens, provide information for your artifact.

  8. When you are done, click Add {Artifact Type} where {Artifact Type} is the artifact type you want to add to submit the artifact.

    Once created, you can then add supporting documentation to your artifact.9

Add artifacts on validation reports

While assessing a record’s compliance,10 you can add artifacts as you complete your validation report:

  1. In the left sidebar, click Inventory.

  2. Select a record or find your record by applying a filter or searching for it.11

  3. In the left sidebar that appears for your record, click Documents and select the Latest tab.12

  4. Click on a Validation type file.13

    Expand any subsection of the validation report you have attached evidence for to autogenerate validation issues or manually link artifacts to your report:

ImportantAI suggestions require review!

Always review AI-generated validation issues before approving them. The suggestions are based on patterns in your risk assessment notes and may need adjustment to accurately reflect your findings.

Use AI to automatically suggest validation issues based on the gaps identified in your assessment:14

14 This feature requires AI capabilities to be enabled for your organization — contact an administrator if you cannot access the Suggest Validation Issues interface.

  1. In the Artifacts section under your evidence, click Suggest Validation Issues.

  2. Click Suggest Validation Issues to have ​ValidMind analyze your risk assessment notes along with the guideline context and identify any gaps that warrant validation issues.

  3. Review the suggested validation issues. Each suggestion includes:

    • A proposed title and description outlining the issue
    • A preliminary severity level based on the identified gap
    • A proposed remediation plan

    Click See more on each suggested issue to expand for more details.

  4. Approve, reject, or regenerate the suggested validation issues:

    Under each individual issue:

    • Click Approve to create the validation issue and link it to your report.
    • Click Reject to reject the suggestion if it doesn’t apply.

    Click Suggest Validation Issues # and select:

    • Approve All to approve all suggested issues at once.
    • Reject All to reject all suggested issues at once.

    Click Suggest Validation Issues # and select Regenerate Issues.

  1. After approving a validation issue, you can further customize it by clicking on the issue to edit fields such as owner, due date, and status.

  1. Under your evidence, click Artifacts to expand the artifacts panel.

  2. Click Link Artifact and select the artifact type15 you want to add:

    • Validation Issue
    • Policy Exception
    • Limitation

  3. On the Link Artifact to Report modal that opens:

    • Select from the list of available artifacts.
    • Click Add {Artifact Type} where {Artifact Type} is the artifact type you want to add to create a new artifact,16 then select the new artifact from the list.

  4. Click Update Linked Artifacts.

    Confirm that the newly linked artifacts shown under Artifacts is accurate.

    16 
  1. Click Add {Artifact Type} where {Artifact Type} is the artifact type you want to add to create a new artifact.
  2. Enter the details for your artifact.
  3. Click Add {Artifact Type} to submit the artifact.

Update artifacts

As artifacts get resolved or require other changes during the validation process, you can update them:

  1. Locate the artifact you want to update.17

  2. Click on a field to make changes.

    You can also add comments to an artifact.

Most updates are applied immediately but you must click Save to make changes to the artifact title, description, proposed remediation plan, and attachments effective.

Track artifact resolution

As you prepare your validation report, review open or past due artifacts, close resolved ones, or add a mitigation plan:

  1. In the left sidebar, click Inventory.

  2. Select a record or find your record by applying a filter or searching for it.18

  1. In the left sidebar that appears for your record, click Validation Issues to view a list of validation issues associated with that record.

  2. Go through the open validation issues one-by-one:

    • If the validation issue has been addressed —

      • Add any final comments to assess how the issue was resolved.
      • Under status, select Closed.

    • If part or all of the validation issue remains to be addressed —

      • Assess if the issue identified by the validation issue prevents the record from being approved.
      • If a remediation plan is required, enter the details in the Proposed Remediation Plan section of the validation issue.

  3. Track open issues until all validation issues are resolved or a remediation plan is in place for post-approval issues.

  1. In the left sidebar that appears for your record, click Artifacts to view lists of other artifact types associated with that record.

  2. Select an artifact type19 for a list of that artifact type:

    • Policy Exception
    • Limitation

  3. Go through the open artifacts one-by-one:

    • If the artifact has been addressed —

      • Add any final comments to assess how the issue was resolved.
      • Under status, select Closed.

    • If part or all of the artifact remains to be addressed —

      • Assess if the issue identified by the artifact prevents the record from being approved.
      • Add comments indicating next required steps.

  4. Track open artifacts until all artifacts are resolved or plans are in place for post-approval issues.

Manage attachments on artifacts

After an artifact is created, you’re able to add supporting documentation to it.

Uploaded files must be less than 50 MB each in size.

  1. On the artifacts detail page, click on the attachments header.

  1. Click Select Files to add a file.

    • Add a note to the file by clicking on the menu, then select Add Note.
    • Update a note by making your changes in the existing text field.

  2. Click Save to submit the upload.

    An animated gif demonstrating how to add attachment notes

    Adding attachment notes
  1. On the artifacts detail page, click on the attachments header.

  1. Locate the file you want to remove, and click on the menu.

    • Select Delete File to remove the file. Click Yes, Delete File to confirm permanent deletion of that file.
    • Select Remove Notes to delete any notes. Removal of notes is saved automatically.

  2. Click Save to apply the deletion.

    After you save, the attachment or notes will be removed permanently.

    An animated gif demonstrating how to delete attachment notes and attachments

    Deleting attachment notes and attachments

Delete artifacts

ImportantArtifact deletion is permanent.
  • While artifact deletion will be logged under your Activity,20 deleted artifacts cannot be retrieved.
  • Deleting an artifact will also remove it from any validation reports21 it was previously attached to.

If you logged an artifact in error or otherwise no longer need to track that artifact, you can delete it:

  1. Locate the artifact you want to delete.22

  2. On the artifact’s detail page, click Delete {Artifact Type}23 in the right sidebar.

  3. Click Yes, Delete {Artifact Type} to confirm permanent deletion of that artifact.