Manage artifact types

Prepare to track the progress and resolution of artifacts by customizing artifact types and their associated statuses available to be logged on models in your inventory.

Artifact types

By default, the ValidMind Platform provides three native artifact types:

Validation Issue

Problems discovered during model validation that reflect errors, inconsistencies, or gaps in data, methodology, implementation, or documentation that need to be addressed before the model is considered reliable.

Policy Exception

When a model or part of its development or usage does not comply with internal policies, regulatory requirements, or governance standards, but an explicit approval or waiver is granted to allow it under controlled conditions.

Model Limitation

Inherent weaknesses or constraints of the model itself that cannot be fully resolved; definitions under which the model’s results should be interpreted with caution.

NoneCan I create custom artifact types?

Yes, you can create custom artifact types to track categories of observations beyond the defaults. Common examples include:

Change management

Track requested changes to models, their approval status, and implementation timeline. Useful when model updates require formal change control processes.

Audit findings

Capture observations from internal or external audits that require follow-up. Separating these from validation issues helps distinguish regulatory audit trails from routine validation work.

Enhancement requests

Log suggested improvements that don’t rise to the level of a validation issue. Helps capture ideas for future model iterations without cluttering the validation issue backlog.

Custom artifact types support the same features as default types, including statuses, fields, permissions, workflow triggers, and analytics exports.

Prerequisites

• You are logged in to ValidMind.
• You are a Customer Admin or assigned another role with sufficient permissions to perform the tasks in this guide.¹

¹ Manage permissions

Add artifact types

1. In the left sidebar, click Settings.

2. Under Artifacts, select Artifact Types.

3. Click Add Artifact Type.

4. Enter in a name and an optional description for your artifact type.

5. Click Create to create your new artifact type.

6. Click on your newly created artifact type to edit its details and permissions.

7. Enter in the artifact type’s details:

   • fields — Select the default artifact fields that should appear on this type of artifact.²
   • model fields display³ — Select which upstream model inventory fields⁴ to display as read-only under the Model Information section on artifacts of this type.
   • artifact statuses — Configure the statuses available to this artifact type.⁵

8. Select the artifact type’s permissions:

   • create permissions — Model stakeholder types or user roles⁶ that can create this type of artifact.
   • update permissions — Model stakeholder types or user roles that can update existing artifacts of this type.

² 

NoneOnly default fields are available to be selected in this view.

To further customize fields displayed on artifact types, refer to: Manage artifact fields

³ 
• Drag-and-drop fields to reorder them.
• Click Save Model Fields Configuration to apply changes.

⁴ Edit model inventory fields

⁵ Manage artifact type statuses

⁶ 
• Manage model stakeholder types
• Manage roles

Edit artifact types

1. In the left sidebar, click Settings.

2. Under Artifacts, select Artifact Types.

3. Click the existing artifact type you want to edit.

4. Make your desired changes to the artifact type’s details:

   • name
   • description
   • fields — Select the default artifact fields that should appear on this type of artifact.⁷
   • model fields display⁸ — Select which upstream model inventory fields⁹ to display as read-only under the Model Information section on artifacts of this type.
   • artifact statuses — Configure the statuses available to this artifact type.¹⁰

5. Make your desired changes to the artifact type’s permissions:

   • create permissions — Model stakeholder types or user roles¹¹ that can create this type of artifact.
   • update permissions — Model stakeholder types or user roles that can update existing artifacts of this type.

⁷ 

NoneOnly default fields are available to be selected in this view.

To further customize fields displayed on artifact types, refer to: Manage artifact fields

⁸ 
• Drag-and-drop fields to reorder them.
• Click Save Model Fields Configuration to apply changes.

⁹ Edit model inventory fields

¹⁰ Manage artifact type statuses

¹¹ 
• Manage model stakeholder types
• Manage roles

Manage artifact type statuses

Closed and Open are default stages, meaning they cannot be modified or removed.

1. In the left sidebar, click Settings.

2. Under Artifacts, select Artifact Types.

3. Click the existing artifact type you want to edit,¹² or create a new artifact type¹³ to add, edit, or delete artifact statuses.

¹² Edit artifact types

¹³ Add artifact types

Add artifact statuses

1. Click Add Status.

2. Enter in a name and assign a color to your artifact status.

3. When you are done, click Add Status to create your new status.

Edit or delete artifact statuses

1. Hover over the artifact status you’d like to modify.

2. When the appears, click on it and select:

   • Edit Details to change the name or color of the status, then click Update Status to apply your changes.
   • Delete Status to remove the status. After you confirm, the status will be deleted.

ImportantArtifact status deletion is permanent and cannot be undone.

Artifact statuses cannot be deleted if in use on an artifact. Ensure that the status you’re deleting is not associated with any artifacts before proceeding.

Archive and delete artifact types

ImportantDeletion of artifact types is permanent.

• Native (default) artifact types cannot be deleted, only archived.¹⁴ When archiving a native artifact type, existing artifacts of that type will be hidden and no new artifacts of that type can be created.
• When archiving a custom artifact type, existing artifacts of that type will remain viewable, but no new artifacts of that type can be created.

¹⁴ Artifact types

1. In the left sidebar, click Settings.

2. Under Artifacts, select Artifact Types.

3. Hover over the artifact type you want to archive or delete.

4. When the appears, click Archive Artifact Type under the Actions column.

5. After you confirm, the artifact type will be archived. Once archived, custom artifact types can be deleted permanently or restored for use:

Delete artifact types

Only artifact types with no active artifact records can be deleted.

1. Hover over the artifact type you want to delete.
2. When the appears, click Delete under the Actions column.
3. After you confirm, the artifact type will be deleted permanently.

Restore artifact types

1. Hover over the artifact type you want to restore.
2. When the appears, click Restore under the Actions column.
3. After you confirm, the artifact type will be restored.