# Matrix Overview

The **Matrix** feature in Valorx Wave empowers users to connect and display data from **multiple Salesforce objects** within a single grid. With a familiar, **Excel-like interface**, users can **view and bulk edit data** using intuitive grid controls.

Just like **Excel pivot tables**, Matrix enables:

* **Dynamic column groupings** with one or multiple dimensions
* **Summarization of data** at group and sub-group levels
* Easy exploration of complex datasets in a highly visual layout

Whether you're analyzing sales performance or reviewing customer data, Matrix brings powerful data visualization and manipulation **right into Salesforce**—no spreadsheets required.

Matrix is available in **both Wave Extension** (browser-based using Chrome or Edge) and **Wave Embedded** (directly inside Salesforce), offering consistent configuration and runtime experiences with platform-specific navigation.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FdwqCq3gLvUqPGa7xNbvc%2FMatrix.png?alt=media&#x26;token=801e402c-0a25-49d5-bf98-52fa141c6294" alt=""><figcaption><p>Matrix</p></figcaption></figure>

***

## Key Capabilities

**Multi-Object Support**: Connect and display data from one or more related Salesforce objects.

* **1-Object Matrix**: Forecasting revenue by customer or product.
* **2-Object Matrix**: Sales pipeline scheduling by opportunity and product.
* **3-Object Matrix**: CPQ scenarios, product pricing models, revenue allocation.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F74Pxem9JWwO32wab5xc1%2FMatrix%20Telescoping.gif?alt=media&#x26;token=37ab3f83-480d-48c3-8314-2c6253cc2212" alt=""><figcaption><p>2-Object Matrix</p></figcaption></figure>

**Excel-Like Interface**: Use grid tools like filters, sorting, mass editing, and dynamic measures to handle large volumes of Salesforce data with ease.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F8loKL8qWbqGhF11y7Atw%2FMatrix%20-%20Excel%20like%20interface.gif?alt=media&#x26;token=613edaea-ddc5-45c5-8bec-1f89e3cbf914" alt=""><figcaption></figcaption></figure>

**Feature Highlights**:

* Inline Editing with real-time sync to Salesforce
* Conditional Logic and Column Grouping
* Dynamic Column Grouping and Pivoting
* Telescoping Rows and Summarization
* Mass Modifier Actions
* Lookup Support with Sync Filters
* Custom Column Headers, Styling, and Actions

***

## Matrix User Roles

Matrix supports two roles:

* **Designer**: Can create, configure, and publish Matrices.
* **Standard User**: Can view and interact with published Matrices in runtime.
* Learn more about roles and permissions \[[here](https://docs.valorx.com/valorx-wave/settings/settings-screen#user-roles-admin-user-and-standard-user)].

> 🔐 *Field-level visibility and editability are defined at the configuration level and governed by user permissions.*

***

## Platform Availability

| Feature              | Wave Extension (Browser)           | Wave Embedded (Salesforce)                          |
| -------------------- | ---------------------------------- | --------------------------------------------------- |
| Matrix Configuration | ✅ Via **Create New Matrix** button | ✅ Via **Add New → Matrix** or **Matrix Wizard** tab |
| Matrix Runtime       | ✅ Yes                              | ✅ Yes                                               |
| Matrix Home Screen   | ✅ Available                        | ❌ Not Available                                     |
| Matrix Launcher      | ✅ Available                        | ❌ Not Available                                     |

***

## Visual Guidance by Platform

To support users in both **Wave Browser Extension** and **Wave Embedded**, this section offers clear visual references to key Matrix components. Although both platforms share the same core UI, the **access points**, **workspace behavior**, and **available features** may differ. Each screenshot provided is clearly labeled by platform, with annotations where differences exist.

### Matrix Configuration Screenshots (Wave Browser Extension & Wave Embedded)

The **Matrix Configuration** page (also known as the Matrix Wizard) is identical across both platforms in terms of UI structure and layout. However, the method for accessing it varies:

* **Wave Extension**\
  Users can simply click **Create New Matrix** on the main dashboard. This immediately launches the Matrix Wizard—there is no separate Matrix tab.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FRYCpYfbtI5Yt45qcY1oH%2FWave%20Extension%20-%20New%20Matrix.gif?alt=media&#x26;token=585df4a1-99d3-45c9-adb8-5a93a7da5353" alt=""><figcaption><p>Wave Browser Extension - Create New Matrix</p></figcaption></figure>

* **Wave Embedded**\
  Users can:
  * Click **Add New** and select **Matrix**, or
  * Navigate directly to the **Matrix Wizard** tab within the Salesforce interface.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F60tQ0nLnbF2F1nDN8mDk%2FWave%20Embedded%20-%20New%20Matrix.gif?alt=media&#x26;token=9bb9713f-0ba2-48a5-95ab-6a918ebf1bb8" alt=""><figcaption><p>Wave Embedded - Add New Matrix</p></figcaption></figure>

***

### Matrix Runtime Screenshots (Wave Browser Extension & Wave Embedded)

The **Matrix Runtime interface**—where users interact with live data—is **functionally identical** across both platforms: **Wave Browser Extension** and **Wave Embedded**.

There are **no visual or functional differences** in the Matrix Runtime itself. The **only difference lies in how users launch the runtime**:

* **Wave Extension:** Click **Run** on the Matrix Card<br>

  <figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FeEAoCTdibEbvtRkfsbDa%2FWave%20Extension%20-%20Matrix%20Runtime.gif?alt=media&#x26;token=af84d19d-8ec8-4809-a226-c41c5d868bba" alt=""><figcaption><p>Wave Browser Extension - Runtime</p></figcaption></figure>

* **Wave Embedded:** Click **Surf the Matrix** on the Matrix Card<br>

  <figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FiBs36St9EcE5Lho0ePk6%2FWave%20Embedded%20-%20Matrix%20Runtime.gif?alt=media&#x26;token=05747200-ee61-4cec-9e23-f7fd1959f302" alt=""><figcaption><p>Wave Embedded - Matrix Runtime</p></figcaption></figure>

{% hint style="info" %}
***Note:** Both platforms use the same **Matrix Configuration** and **Matrix Runtime** components. However, Matrix in Wave Embedded is still evolving. While the configuration and runtime flows are nearly identical to Wave Extension, some advanced features may not yet be available.*
{% endhint %}

***

### Matrix Launcher / Matrix Screen (Wave Extension Only)

These features are **available only in Wave Extension** and are designed to enhance flexibility and quick access within the browser extension experience.

* **Matrix Screen:** A dashboard-style screen displaying all saved matrices. From here, users can easily open, edit, duplicate, or delete matrices.

  <figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FrWMkxHXnv3zECgHPXNVp%2FWE%20-%20Matrix%20Screen.png?alt=media&#x26;token=8e64b8e3-dc94-4a02-94fc-1eb632863dd5" alt=""><figcaption><p>Matrix Screen - Wave Extension</p></figcaption></figure>
* **Matrix Launcher:** A productivity feature that allows users to access matrices directly from Salesforce pages. Clicking the button opens the matrix in Wave Extension, enabling faster workflow launches without navigating through the full interface.

***

## Explore More

{% content-ref url="matrix-screen" %}
[matrix-screen](https://docs.valorx.com/valorx-wave/matrix/matrix-screen)
{% endcontent-ref %}

{% content-ref url="matrix-configuration" %}
[matrix-configuration](https://docs.valorx.com/valorx-wave/matrix/matrix-configuration)
{% endcontent-ref %}

{% content-ref url="matrix-runtime" %}
[matrix-runtime](https://docs.valorx.com/valorx-wave/matrix/matrix-runtime)
{% endcontent-ref %}

{% content-ref url="matrix-launcher" %}
[matrix-launcher](https://docs.valorx.com/valorx-wave/matrix/matrix-launcher)
{% endcontent-ref %}
