---
sourceDocument: Brazil Sales Customer Relationship Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/order-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Sales Customer Relationship Management

ft:clusterId :

    - omgmt

bundleId :

    - omgmt

workflow :

    - Customer and Industry


---

# Matrix Loader

# Matrix Loader {#ariaid-title1}

Release version: Brazil  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Matrix Loader

The Matrix Loader is a bulk data management tool designed to streamline configuration management within ServiceNow CPQ environments.
It enables administrators to efficiently create, update, and migrate configuration elements such as fields, field options, rules, layouts, product pickers, and tables through CSV file uploads.
This approach replaces manual, one-by-one configuration, facilitating large-scale implementations, backups, and environment migrations while ensuring data integrity and consistency.
Show full answer Show less  

## Key Features

* **CSV-Based Configuration:** Supports defining configuration elements in CSV files with specific column schemas, allowing column rearrangement as long as headers are maintained correctly.
* **Automated Import Sequencing:** Automatically sorts uploads to respect dependencies (e.g., fields before field options, then rules) for accurate relational data handling.
* **Validation and Error Handling:** Provides detailed error messages for missing columns, invalid references, or naming mismatches to simplify troubleshooting during uploads.
* **Export and Backup:** Allows exporting all configuration entities as CSV files to create reusable backups and audit records without redeployment for table changes.
* **No-Code Automation:** Enables modification of complex configurations and relationships without scripting, accelerating large-scale setup and updates.

## Configuration Types Supported

* **Fields and Field Options:** Manage fields, picklists, and product pickers; ideal for bulk adding product options.
* **Rules:** Define business logic, calculations, and conditional visibility for blueprints.
* **Layouts:** Control user experience by arranging field placements and groupings.
* **Tables:** Manage data sets used for lookups and dynamic logic, such as pricing or reference data.
* **Product Pickers:** Define product selection fields and behaviors for bulk accessory or component uploads.

## How It Works

1. Prepare configuration data in spreadsheet tools and export as CSV files.
2. Access the Matrix Loader from the Admin navigation pane.
3. Optionally export sample CSV templates for reference.
4. Upload CSV files by drag and drop; the loader auto-detects file types.
5. Validate that upload types are correctly identified.
6. Import files; the loader processes uploads in the necessary sequence, resolving dependencies automatically.
7. Review success and error notifications and verify changes in Admin pages.

## Practical Use Cases

* Bulk onboarding of configuration elements for new product lines.
* Migration of configuration data between sandbox and production environments.
* Mass updates of field types, rules, or default values across multiple blueprints.
* Regular backups and restores of configuration data to maintain recoverability.

## Benefits for ServiceNow Customers

* **Efficiency:** Expedites large-scale data setup by enabling batch uploads.
* **Consistency:** Ensures uniform configurations across environments via reusable CSV definitions.
* **Traceability:** Provides versioned CSV records for auditing and rollback purposes.
* **Migration Support:** Simplifies transferring configurations between environments.
* **Error Management:** Validates uploads before applying changes to avoid configuration errors.  
Learn how the Matrix Loader accelerates configuration management by simplifying large-scale data creation, updates, and migrations across your ServiceNow CPQ environments.
The Matrix Loader is a bulk data management utility that enables administrators to efficiently add, edit, and migrate configuration elements such as fields, field options, rules, layouts, product pickers, and tables. Instead of
creating elements one by one in the Admin interface, the Matrix Loader lets you define configurations in CSV files---making it ideal for scaling complex implementations, backing up configurations, and moving data between test and
production environments.

The Matrix Loader ensures data integrity and consistency by automatically validating dependencies (for example, between fields and field options) and uploading elements in the correct order. Administrators can also use the Matrix
Loader to export CSV templates and sample files, providing a quick reference for valid column structures, accepted values, and upload formats.

## Key concepts {#matrix_loader_table_of_contents__section_dhc_pmv_2hc}

* CSV structure: Each configuration type has a specific column schema. Administrators can rearrange columns as long as headers remain correct.
* Import order: The loader auto-sorts uploads logically (for example, fields → field options → rules).
* Validation and error handling: Errors during upload usually result from missing required columns, invalid references, or mismatched names. The Matrix Loader displays error messages to help correct them quickly.
* Export and backup: All configuration entities can be exported from the Admin interface to create reusable CSV backups.
* No redeployment for tables: Updates to managed tables take effect immediately. However, rules referencing those tables require redeployment if modified.
{#matrix_loader_table_of_contents__ul_qs2_qmv_2hc}

## Key benefits {#matrix_loader_table_of_contents__section_vfy_1mv_2hc}

The Matrix Loader eliminates the repetitive and time-consuming steps involved in large-scale setup or updates. It provides several key advantages:
{#matrix_loader_table_of_contents__table_hhb_f1g_3cc__entry__2}

| Benefit | Description |
|-|-|
| Efficiency | Upload hundreds of fields, rules, or tables in one batch instead of creating them manually. |
| Consistency | Maintain consistent configurations across environments with reusable CSV definitions. |
| Traceability | Use exported CSV files as a versioned record of environment data for audits or rollback. |
| Migration support | Seamlessly migrate configurations from sandbox to production environments. |
| Error handling | Validate and confirm successful uploads before committing changes. |
| No-code automation | Modify configurations and relationships without scripting. |
[Table 1. Benefits of the Matrix Loader]

{#matrix_loader_table_of_contents__table_hhb_f1g_3cc}

## Matrix Loader configuration types {#matrix_loader_table_of_contents__section_bdx_bmv_2hc}

The Matrix Loader supports multiple configuration types, each designed to streamline a specific aspect of the ServiceNow CPQ setup:
{#matrix_loader_table_of_contents__table_n5r_gmv_2hc__entry__3}

| Upload Type | Purpose | Example Use Case |
|-|-|-|
| Fields and field options | Create and manage fields, picklists, and product pickers. | Add 200 product options to a field at once. |
| Rules | Define business logic, calculations, and conditional visibility. | Upload all visibility and determination rules for a blueprint. |
| Layouts | Design user experiences by defining field placement and grouping. | Update layout structure across multiple blueprints. |
| Tables | Manage data sets used for lookups and dynamic logic. | Import pricing data or reference mappings. |
| Product pickers | Define product selection fields and their behaviors. | Bulk upload accessory or component data. |
[Table 2. Matrix loader configuration types]

{#matrix_loader_table_of_contents__table_n5r_gmv_2hc}

## How the Matrix Loader works {#matrix_loader_table_of_contents__section_zll_kmv_2hc}

The Matrix Loader performs uploads in a controlled sequence to maintain relational accuracy between configuration elements. Here's how the process works:

1. Prepare data files: Define configuration elements in spreadsheet tools such as Google Sheets or Microsoft Excel, and export each sheet as a CSV file.
2. Access the Matrix Loader: in the left Admin navigation pane, click Matrix Loader.
3. Export sample templates (optional): Download sample CSVs for fields, field options, rules, or tables to use as reference templates.
4. Upload files: Drag and drop one or more CSV files. The Matrix Loader automatically detects file types based on filename keywords.
5. Validate mappings: Confirm that the Matrix Loader correctly identified each upload type (for example, fields vs. rules).
6. Import and verify: Click Import. The Matrix Loader runs each upload in the correct sequence. Review success or error notifications in the Notification Center.
7. Confirm configuration: Verify new and updated items on the relevant Admin pages (such as fields or rules).
{#matrix_loader_table_of_contents__ol_dvh_mmv_2hc}  
Note:  
The Matrix Loader automatically performs dependency resolution---for example, ensuring that fields upload before field options or that rule dependencies are validated.

## Example use cases {#matrix_loader_table_of_contents__section_rbt_qmv_2hc}

* Bulk onboarding: Create hundreds of picklists, rules, and layout mappings for a new product line in minutes.
* Environment migration: Move configuration data from sandbox to production using standardized CSV exports.
* Mass update: Change field types, rule actions, or default values across multiple blueprints simultaneously.
* Backup and restore: Export CSVs regularly to maintain a recoverable version of your configuration.
{#matrix_loader_table_of_contents__ul_izg_rmv_2hc}
**Related concepts**   

* [Configure the Matrix Loader](https://servicenow-prod.fluidtopics.net/kRQN5xOB8TsNqFHIgYdyig "Use the Matrix Loader to efficiently add, edit, and migrate fields, field options, rules, and layouts in ServiceNow CPQ. Upload CSV files, validate configurations, and streamline bulk updates or environment migrations with error-handling and verification support.")
* [Matrix Loader CSV fields and field options upload and export](https://servicenow-prod.fluidtopics.net/UQnC6AE12_QzzlaH2P5hdQ "Use the Matrix Loader to bulk create, edit, and export fields, field options, and product pickers in ServiceNow CPQ. Define data in CSV files with supported columns and formats, then upload or download them for faster configuration management and environment migration.")  
**Related tasks**   

* [Matrix Loader: CSV table upload](https://servicenow-prod.fluidtopics.net/gU4BC27cEhvb5g7~y1Sutw "Use the Matrix Loader to import and manage table data in ServiceNow CPQ. Define table schemas, prepare matching CSV files, and upload them to populate or update tables for use in rules, lookups, and configurations, with no redeployment required for data updates.")  
**Related reference**   

* [Matrix Loader: CSV rules upload](https://servicenow-prod.fluidtopics.net/LQtXXT~Ko5CObLEYQCoStQ "Use the Matrix Loader to bulk create, edit, and export rules in ServiceNow CPQ. Define rule conditions, actions, and logic in a CSV file to streamline configuration management and automate large-scale updates.")

