Test Class Mapping

Create an org test matrix

1

Navigate to Salesforce → Insights → Test Class Mappings → + New Org Test Matrix

2

Select Salesforce Org, enter a Name

3

Configure key toggles (see table below)

4

Click Save

Toggle	Behavior
Disable Autoinclude for unmapped classes	Only explicitly mapped test classes execute. Does not affect manual pipeline runs.
Mandate test class mapping (Auto Include)	Pipeline fails if any Apex class in the package has no mapping. Bypassed if package contains only config (no Apex).

To activate the mandate rule in a pipeline, set Unit Test Type to Auto Include Tests in pipeline config or PR Validation Repository Rules policy.

Add component mappings

1

Click Manage Mapping → Add Component Mappings

2

Select Apex classes to map, click Next Step

3

Choose test classes via Manual Selection, Suggested Mapping (AI-based naming/dependency analysis), or type to Add Manually

4

Review in Confirmation step and save

Bulk mapping via CSV

1

Click Manage Mapping → Create Suggested Mapping — system analyzes metadata and downloads a CSV

2

Review/edit CSV columns: Component Type, Component Name, Test Classes, Actio

3

Action values: (blank) = add/modify, override = replace, delete = remove mapping

4

Re-upload via Upload Mapping → Validate → Proceed