> For the complete documentation index, see [llms.txt](https://docs.valorx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.valorx.com/valorx-wave/wave-experience/type-of-grid-in-wave.md).

# Type of Grid in Wave

Wave offers different types of grids to help you interact with Salesforce data efficiently. Each grid type suits a different data management need, while still providing a familiar, Excel-like interface for viewing, editing, and analyzing records.

Grids in Wave fall into four types:

1. ![](/files/Z6HQNFy0wi1s5OIqGYXB) [**Standard Grids**](#standard-grid-salesforce-view)
2. ![](/files/LSvxFvtiyK3zTQg8rjH4) [**Custom Grids**](#custom-grid-my-grids)
3. ![](/files/0WAj74bgjqKQYh9lVpEv) [**Report Grids**](#report-grid)
4. ![](/files/9cn3dtrAm7kTLtWTvRi4) [**Global Grids**](#global-grid)

Each type serves a specific purpose based on how data is displayed, modified, or shared within Valorx Wave.

***

## ![](/files/Z6HQNFy0wi1s5OIqGYXB)  **S**tandard Grid (Salesforce View)

A Standard Grid is generated automatically when you open a Salesforce object's grid in Wave Extension without making any changes. It mirrors the object's view in Salesforce.

#### Key Features:

* Displays all fields and records based on the default Salesforce setup.
* The grid's structure can't be edited through Manage Grid. Opening Manage Grid on a Standard Grid displays: “*This is a Salesforce view, it can't be edited*”.

### Customizing a Standard Grid

How your changes are saved depends on the type of change you make:

#### Rule, Group, Column Group, Mass Modifier, Layout Changes

Modifying a [Rule](/valorx-wave/wave-data-management/managing-grid-data/rule.md), [Group](/valorx-wave/wave-data-management/managing-grid-data/group.md), [Column Group](/valorx-wave/wave-data-management/managing-grid-data/column-group.md), [Mass Modifier](/valorx-wave/wave-data-management/managing-grid-data/mass-modifier.md), or [Layout](/valorx-wave/wave-data-management/managing-grid-data.md#layout) on a Standard Grid is saved directly onto that Standard Grid. It does not create a new Custom Grid.

#### Filter, Sort, or Field Changes

Applying a [filter](/valorx-wave/wave-data-management/managing-grid-data/filter.md) or [sort](/valorx-wave/wave-data-management/managing-grid-data/sort.md), or adding/removing fields, automatically creates a new [Custom Grid](#custom-grid-my-grids). This keeps the original Standard Grid unchanged for everyone else, while giving you a dedicated version to keep customizing. A toast notification confirms the Custom Grid was created.

Once this Custom Grid exists, you can open [Manage Grid](/valorx-wave/wave-data-management/managing-grid-data.md#manage-grid) on it to:

* Rename the grid and add a description.
* Add or remove fields.
* Enable or disable [Global Grid](#global-grid).
* Toggle the Refresh on Save setting.

Your new Custom Grid appears on the Grids screen, marked with the Custom Grid icon.

<figure><img src="/files/NtCQqpS4Ay49ZdQYawzw" alt=""><figcaption><p>Standard/Salesforce View to Custom Grid</p></figcaption></figure>

#### Saving Record Data

* If you modify record data in a Standard Grid, Wave prompts you to confirm whether you want to save those changes back to Salesforce.
* Visibility-related changes (such as sorting, filtering, or field selection) don't affect Salesforce and are saved only in Wave.

{% hint style="info" %}
**Key Difference**

A Custom Grid exists only in Wave and doesn't impact Salesforce grids. However, both Standard Grids and Custom Grids let you edit and save record data back to Salesforce.
{% endhint %}

***

## ![](/files/LSvxFvtiyK3zTQg8rjH4)  Custom Grid (My Grids)

A **Custom Grid** is created when you modify a [**Standard Grid**](#standard-grid-salesforce-view) or design a grid from scratch ([Wave Embedded](/valorx-wave/wave-experience/create-a-new-grid/grid-wizard-in-salesforce.md) / [Wave Browser Extension](/valorx-wave/wave-experience/create-a-new-grid/manage-grid-in-wave-browser-extension.md)), or personalize a [Global Grid](#global-grid).

#### Key Features:

* Unique to the user who created it unless shared globally.

{% hint style="info" %}

#### NOTE

Where a Custom Grid appears depends on the platform. In Wave Extension, Custom Grids are automatically saved under **My Grids** for easy access. In Wave Embedded, there's no My Grids section.  Custom Grid created from a Global Grid instead appears nested under that Global Grid's name in the grid picker, marked with a copy icon.
{% endhint %}

<figure><img src="/files/3MS0yDnN3x6XEDrDhmIV" alt=""><figcaption><p>Custom Grid (My Grids)</p></figcaption></figure>

***

## ![](/files/0WAj74bgjqKQYh9lVpEv)  Report Grid

A **Report Grid** is designed to work with Salesforce Reports. Instead of displaying object records directly, it pulls data from a pre-defined Salesforce report.

#### Key Features:

* Provides a summarized view of data based on Salesforce Reports.
* Useful for analytical and reporting purposes.
* Cannot be modified like a Custom Grid but reflects changes made in the original Salesforce Report.

### Salesforce Report vs. Mapped Report Grid

When you open a Salesforce report in Wave, it becomes a Mapped Report Grid. This mapping happens in just a few clicks.

The Mapped Report Grid opens on the Grids screen, where you can process it like any other grid:

* Changes to record data can be saved back to Salesforce.
* Visibility-related changes (sorting, filtering) remain within Wave only.

<div><figure><img src="/files/K54Ma3frkIGd13Gk0CSm" alt=""><figcaption><p>Salesforce Report</p></figcaption></figure> <figure><img src="/files/wWvrQUGIDlXj6tdOvhua" alt=""><figcaption><p>Wave Report Grid</p></figcaption></figure></div>

### Converting a Mapped Report Grid to a Custom Grid

Mapped Report Grids are editable and offer the same Excel-like experience as other grids. However, some features, like sharing a Report Grid globally, require converting the report into a Custom Grid first.

{% hint style="warning" %}

### IMPORTANT

Global sharing isn't supported for Report Grids directly. Convert the report into a Custom Grid first, then enable Global Grid to share it with other users.
{% endhint %}

To become eligible for conversion, make at least one personalization change to the Mapped Report Grid, such as adding or removing fields, applying a filter or sort, or resizing a column. For the full step-by-step walkthrough, see [Converting a Mapped Report Grid to a Custom Grid](/valorx-wave/reports/reports-overview.md#converting-a-mapped-report-grid-to-a-custom-grid) in the Reports Overview.

***

## ![](/files/9cn3dtrAm7kTLtWTvRi4)  Global Grid

A Global Grid is a reusable grid that can be shared across multiple users within an organization. Only Custom Grids can be set as a Global Grid.

#### Key Features:

* Can be accessed by multiple users with appropriate permissions.
* Provides a consistent view across a team.

{% hint style="info" %}

#### NOTE

A Global Grid is a grid a Designer or Admin has explicitly shared with standard users. Any grid that hasn't been shared this way stays private to its creator. How a Global Grid gets created differs by platform (see below), but once it exists, standard users interact with it the same way on both platforms.
{% endhint %}

### Global Grid in Wave Embedded

In Wave Embedded, a Designer or Admin creates a grid directly using the [Grid Wizard](/valorx-wave/wave-experience/create-a-new-grid/grid-wizard-in-salesforce.md), and it becomes a Global Grid by default.

* By default, the grid is shared with all users.
* The Designer or Admin can restrict this by specifying which users are allowed to access the grid, instead of sharing it with everyone.

<figure><img src="/files/hxC3iTGPWeMU2WNnwpBh" alt=""><figcaption><p>List of Global Grid in Wave Embedded</p></figcaption></figure>

### Global Grid in Wave Browser Extension

In Wave Extension, anyone can create a grid directly using the [Add New](/valorx-wave/wave-experience/create-a-new-grid/manage-grid-in-wave-browser-extension.md#ways-to-start-creating-a-custom-grid) button. The grid isn't Global by default, it stays private to its creator.

* Only a Designer or Admin can mark a Custom Grid as a Global Grid via [Manage Grid](/valorx-wave/wave-data-management/managing-grid-data.md#manage-grid). Standard users don't have this option.
* Until a Designer or Admin does this, the grid stays private under My Grids.&#x20;

<figure><img src="/files/FAXV6vcrH6F3KL2mXnqd" alt=""><figcaption><p>List of Global Grid in Wave Browser Extension</p></figcaption></figure>

### Creating a Custom or Personal Grid from a Global Grid

Designers can empower standard users to manage and share personalized grid views directly from a Global Grid (Main Copy), without designer intervention. This works the same way on both Wave Embedded and Wave Browser Extension.

When a standard user makes their first change to a Global Grid, Wave automatically creates a Custom Grid for that user. They can keep the generated name or rename it before saving. This gives users a personal working copy tailored to their needs, while the original Global Grid configuration stays intact.

<figure><img src="/files/xxmYx8Z6aF6GNFFXenfJ" alt=""><figcaption><p>Custom Grid from a Global Grid</p></figcaption></figure>

#### A Personal or Custom Grid is created when a standard user makes any of these changes to a Global Grid:

* [Filter](/valorx-wave/wave-data-management/managing-grid-data/filter.md), [Rule](/valorx-wave/wave-data-management/managing-grid-data/rule.md), [Group](/valorx-wave/wave-data-management/managing-grid-data/group.md), [Column Group](/valorx-wave/wave-data-management/managing-grid-data/column-group.md), or [Sort](/valorx-wave/wave-data-management/managing-grid-data/sort.md) — adding, removing, or updating any of these conditions.
* [Layout](/valorx-wave/wave-data-management/managing-grid-data.md#layout) — updating the layout configuration.
* [Fields](/valorx-wave/wave-data-management/managing-grid-data.md#add-fields) — adding or removing regular fields, related fields, or related lists.
* [Column customization ](/valorx-wave/wave-data-management/data-control-and-customization.md#freeze-unfreeze-column)— hiding, unhiding, rearranging, resizing, or freezing columns.

<figure><img src="/files/hlWjGCDAL3m7uX5VJZvL" alt=""><figcaption><p>Personalized Grid</p></figcaption></figure>

#### Key Features

* Each user can create unlimted Custom Grids per Global Grid.
* Custom Grids appear nested under their parent Global Grid's name in the grid picker, with quick actions for Share, Rename, Duplicate, and Delete.
* Users with sharing permission can share their Custom Grids with other users directly.
* Custom Grid creation is configured at the Global Grid level, under Manage Access.

### Access Options

Designers control how standard users can interact with and personalize a Global Grid through three access options:

* Allow Creating Custom Grids
* Allow Sharing Custom Grids with All Users
* Make Grid Read-Only

#### When "Allow Creating Custom Grids" is OFF (default)

If a standard user applies a layout change, filter, or rule on the Main Grid, Wave automatically creates a Personal Grid for that user, marked with a Personal badge.

* The Personal Grid is private to that user and isn't visible to anyone else.
* It has no effect on the Main Grid created by the Designer or Admin. The Main Grid stays unchanged for everyone else.
* The user can reset their Personal Grid at any time to return to the original Main Grid view. Once reset, the Personal badge disappears and the grid reverts to the Main Grid.

<figure><img src="/files/hlWjGCDAL3m7uX5VJZvL" alt=""><figcaption></figcaption></figure>

#### When "Allow Creating Custom Grids" is ON

Once the Designer enables this [option](/valorx-wave/wave-admin-and-control/enterprise-control.md#allow-creating-custom-grids), all existing Personal Grids automatically convert into Custom Grids. From here, standard users get full control over their own copy:

* They can rename, share, duplicate, or delete their Custom Grid.
* The Custom Grid remains unknown to other users unless the owner explicitly shares it.
* This has no effect on the Main Grid created by the Designer. Each user's Custom Grid is independent of the Main Grid and of other users' Custom Grids.

<figure><img src="/files/6groeN1EXPr0CU7R3DGU" alt=""><figcaption><p>Custom Global Grid</p></figcaption></figure>

For the complete list of Grid Controls Designers and Admins can configure — Toolbar, Fields, Records, and more — see [Enterprise Control](/valorx-wave/wave-admin-and-control/enterprise-control.md)

### Sharing a Custom Grid Created from a Global Grid

Copy Link lets you generate a secure, shareable link to a Custom Grid. Anyone with the link can access the grid, subject to their existing permissions.

<figure><img src="/files/tRUGrJqJSJH4xqwigdfn" alt=""><figcaption><p>Share Grid</p></figcaption></figure>

#### Generating a Link

The Copy Link section is always visible in the Share Grid dialog. If no link exists yet, the field shows "No link generated yet". Clicking Copy Link generates a link, copies it to your clipboard, and shows a success message. If a link already exists, clicking Copy Link again re-copies the same link.

#### Revoking a Link

Once a link is generated, a Revoke icon appears next to the link field. Clicking it prompts a confirmation before removing the link. Once revoked, the old link stops working, and a new one can be generated at any time.

{% hint style="info" %}
NOTE

Only one active link exists per Custom Grid at any time. Links are secure and don't expose internal identifiers. Email-based sharing is unaffected.
{% endhint %}

### Platform Differences at a Glance

<table><thead><tr><th width="186"></th><th>Wave Embedded</th><th>Wave Extension</th></tr></thead><tbody><tr><td>Standard Grid / Salesforce View</td><td>Doesn't exist</td><td>Standard users can open one directly</td></tr><tr><td>How a Global Grid is created</td><td>Automatic. Any grid a Designer/Admin creates is a Global Grid by default (shared with all users unless restricted)</td><td>Manual. A grid starts private and must be explicitly marked as Global Grid to share</td></tr><tr><td>“My Grids” section</td><td>Doesn't exist</td><td>Where standalone Custom Grids and personalized Standard Grid copies are listed</td></tr><tr><td>Custom Grid from a Global Grid (when allowed)</td><td>Nested under the Global Grid's name in the grid picker, with a copy icon indicating it's allowed</td><td>Same — nested under the parent Global Grid</td></tr><tr><td>Personal Grid (when custom grid creation isn't allowed)</td><td>Same behavior</td><td>Same behavior</td></tr></tbody></table>

***

## **Summary Table**

<table data-full-width="false"><thead><tr><th width="158">Grid Type</th><th width="170">Source Data</th><th width="150.4444580078125">Customizable</th><th>Purpose</th></tr></thead><tbody><tr><td><strong>Standard Grid</strong></td><td>Salesforce Object</td><td>❌ No</td><td>Displays unmodified Salesforce data.</td></tr><tr><td><strong>Custom Grid</strong></td><td>Modified Salesforce Object</td><td>✅ Yes</td><td>Allows field selection, sorting, and filtering.</td></tr><tr><td><strong>Global Grid</strong></td><td>Shared Configuration</td><td>✅ Yes</td><td>Provides a consistent view across multiple users.</td></tr><tr><td><strong>Report Grid</strong></td><td>Salesforce Report</td><td>✅ Yes</td><td>Displays pre-configured report data.</td></tr></tbody></table>

By understanding the different grid types, users can efficiently manage and interact with their data in Valorx Wave. 🚀
