# Managing Grid Data

The grid offers an **Excel-like experience**, providing powerful tools to help you efficiently organize, filter, and update your Salesforce data. Easily refine your view, highlight key records, apply bulk updates, and customize the layout to match your workflow.

This section covers essential grid features, including:

* ![](https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F7dFhgAnO1cut1Ahlp4eJ%2FRefresh%20Icon.png?alt=media\&token=ba0c12e7-795d-4a71-ac6d-42263047d845) [**Refresh**](#refresh) – Update the grid to reflect the latest data.
* ![](https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FIvnuqxxWx9zOlFxEJY73%2FSearch%20Record.png?alt=media\&token=8c4d63b5-33c3-42e4-b70c-ea41cd4e5a46)[ **Search**](#search) – Quickly find specific records.
* ![](https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F7a4N8aPyfEchx2QGci1u%2FSort%20icon.png?alt=media\&token=4752ec45-e631-456a-8ea8-71bfc2120031) [**Sort**](#sort) – Arrange data in ascending or descending order.
* ![](https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2Foqw2SCsyAG22GrLMjvo1%2FLayout%20icon.png?alt=media\&token=34522486-fb18-4868-a8db-5917990ea796) [**Layout**](#layout) – Customize the grid’s appearance.
* ![](https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F7yiNjGnQcwqUCLfPI112%2FMore%20Options%20Icon.png?alt=media\&token=2ceeeae6-133e-4a46-88f3-ce23e653c2b3) [**More Options**](#more-options) – Access additional actions.
* ![](https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FzqoCJApO8Yplk0k6Qki1%2FShare%20Icon.png?alt=media\&token=9ef2e66a-7753-4ee1-8bd3-f3cf8e526f64) [**Share**](#share) – Share – *(Deprecated) This feature is no longer supported.*

***

## ![](https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F7dFhgAnO1cut1Ahlp4eJ%2FRefresh%20Icon.png?alt=media\&token=ba0c12e7-795d-4a71-ac6d-42263047d845) Refresh

The **Refresh Button** ensures users are always working with the most up-to-date data by reloading the grid and pulling the latest records from Salesforce.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F2mLNA0b3Uxr7135wtTVB%2FRefresh.gif?alt=media&#x26;token=3d80a288-cc21-44fe-8125-28c342b6021d" alt=""><figcaption><p>Refresh grid</p></figcaption></figure>

***Note:** If you attempt to refresh grids with unsaved changes, a **Refresh** confirmation pop-up will appear, prompting you to either save your changes or proceed without saving.*

***

## ![](https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FIvnuqxxWx9zOlFxEJY73%2FSearch%20Record.png?alt=media\&token=8c4d63b5-33c3-42e4-b70c-ea41cd4e5a46) Search

Quickly locate records using the **Search** field. This feature allows you to search across both the Grids screen and Salesforce.

1. Enter a keyword in the **Search** field.
2. Matching results from Salesforce and grid rows will be displayed.
3. Click the **Close (X) icon** to clear the search and return to the full Grid view.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2Fp0uMhYylDRqWydZJPRL7%2FSearch.gif?alt=media&#x26;token=ddbaf0ee-eb49-470b-8605-ba5e68f45ac1" alt=""><figcaption><p>Search</p></figcaption></figure>

***

## ![](https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F7a4N8aPyfEchx2QGci1u%2FSort%20icon.png?alt=media\&token=4752ec45-e631-456a-8ea8-71bfc2120031) Sort

The **Sort** feature helps you arrange records in a meaningful order, making it easier to analyze data effectively.

### Applying Sorting

Follow these steps to sort records:

1. Click **Sort**, then click **+ Add a sort**.
2. Select the column you want to sort from the **Column** drop-down.
3. Choose the sorting order from the **Order** drop-down.

The grid updates instantly, displaying records based on your sorting selection.

### Sorting Order Options

Sorting behavior varies depending on the column type:

* **Text Columns** (e.g., Account Name) → Sort alphabetically (A to Z or Z to A).
* **Date Columns** (e.g., Created Date) → Sort chronologically (Older to Newer or Newer to Older).

### Managing Sorting

* Click the ![](https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FUjEHecM0Xt41VmyqsAS4%2FDustbin.png?alt=media\&token=608cea91-3ec5-4deb-b1d0-8d42b92bfd8c) icon to remove a sorting rule.
* Active sorting is indicated by the number of sorting parameters applied. To revert to the original grid view, remove all sorting parameters.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F9RxvZpfv8kapqHi29oh0%2FSort.gif?alt=media&#x26;token=2aa44033-2d38-4ecc-973a-bdeb3815ff0a" alt=""><figcaption><p>Sort</p></figcaption></figure>

**Notes:** When you use the **Sort** option from the toolbar, Wave sends a request to Salesforce to retrieve the records in the desired order. This ensures that **all available records**—including those not yet loaded in the grid are sorted accurately.

Curious why sorting results may differ from Header Sort? See [Sorting Overview](https://docs.valorx.com/valorx-wave/wave-data-management/managing-grid-data/sort).

***

## ![](https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2Foqw2SCsyAG22GrLMjvo1%2FLayout%20icon.png?alt=media\&token=34522486-fb18-4868-a8db-5917990ea796) Layout

The **Layout** feature allows you to adjust column field lengths based on your preferences. This is especially useful when working with records that contain lengthy data.

### Adjusting Column Field Length

Follow these steps to customize the layout:

1. Click **Layout**.
2. Select the desired column field length:
   * **Short**
   * **Medium**
   * **Tall**
   * **Extra Tall**

### Auto-Sizing Columns

* Enable **Auto Size Columns** to automatically adjust column widths based on the data length.
* Auto-sizing works in combination with any selected column field length.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FVWd5MDEW7ENuzFEb3pUK%2FLayout.gif?alt=media&#x26;token=4625c289-5790-42f7-a1c9-ca0b9b4d6079" alt=""><figcaption><p>Layout</p></figcaption></figure>

***

## ![](https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F7yiNjGnQcwqUCLfPI112%2FMore%20Options%20Icon.png?alt=media\&token=2ceeeae6-133e-4a46-88f3-ce23e653c2b3) More Options

The **More Options** feature provides multiple functionalities in a single place for efficient grid management.

#### Available Actions in More Options

* **Add to Favorites / Remove from Favorites** – Mark a grid as a favorite for quick access.
* **Manage Grid** – Rename the grid and add a description.
* **Duplicate** – Create a copy of the grid.
* **Delete Grid** – Remove the grid permanently.
* **Backup Grid** – Backup the grid.
* **Export Data** – Download grid data in Excel or CSV format.

### Manage Grid

The **Manage Grid** screen allows you to update key settings for your custom grid. It's where you can make changes to the grid's structure, name, sharing options, and more—all in one place.

#### What You’ll See on the Manage Grid Screen:

* **Object Name**\
  Displays the object associated with this grid. This field is read-only.
* **Grid Name**\
  You can rename the grid here to reflect its purpose more clearly.
* **Fields**\
  Shows the total number of fields currently used in the grid.
  * Click this section to open the field list.
  * Add or remove fields as needed to tailor the data shown in your grid.
* [**Global Grid**](#global-grids-manage-acces)\
  Toggle this option **on** to make the grid a Global Grid (available to all users or specific users, depending on access settings).
  * Toggle **off** to keep the grid private or custom.
* [**Refresh on Save**](#refresh-on-save)\
  Enable this option if you want the grid to automatically refresh every time it’s saved.
  * Disable it if you want to save without refreshing the data immediately.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F6Wexe527ZTEgsoUbjbFy%2FManage%20Grid%20Screen.png?alt=media&#x26;token=a8d603ee-b1d8-43b5-9cd3-d1a5dda7a4fc" alt=""><figcaption><p>Manage Grid</p></figcaption></figure>

### Global Grids (Manage Access)

Global Grids allow you to share a **Custom Grid** with all users or specific users across your organization.&#x20;

The **Manage Access** feature is available only when a Custom Grid is set as a **Global Grid**. By default, setting a grid to Global shares it with all users.

> **Note:** Only **Admins** and **Designers** can enable the **Global Grid** option. **Standard Users** will not see this setting.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F42dIsLhl7EIyGlGpYi8m%2FGrid%20Control%20Access.gif?alt=media&#x26;token=746e85e4-24b4-4abf-9b53-5c733e4824ec" alt=""><figcaption><p>Global Grid Manage Access</p></figcaption></figure>

To configure access settings, click the **Manage Access** button. The Manage Access screen will display the **Object Name** and **Grid Name**, along with two tabs:

**1. Users Tab**

This tab allows you to define who can access the grid.

* **Allow All Users**\
  Grant access to all users—no further action required.
* **Select Specific Users**\
  Restrict access to selected users only.

> 🔔 If **Allow All Users** is selected, all users will automatically be granted access.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F38wlFgUvcaIzGwCZ0kuE%2FUsers%20Tab.png?alt=media&#x26;token=738878a0-2411-46ec-96d3-42e007e57c92" alt=""><figcaption><p>Users Tab</p></figcaption></figure>

**✅ To assign access to specific users:**

1. Select **Select Specific Users**.
2. Click the **Add More** button.
3. In the **Select Users** window:
   * Use the search bar or scroll to find users.
   * Select the users you want to grant access to.
   * Click **Assign** to save.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FUCKSWG3OUJHZX03cbf7h%2FAssign%20User%20Global%20Grid.gif?alt=media&#x26;token=0885c142-a8fa-44bc-82ed-dd4033356fd4" alt=""><figcaption></figcaption></figure>

**2. Grid Control Tab**

This tab allows Admins or Designers to control how Standard Users interact with the grid.

**Field Permissions:**

* Allow adding and removing fields
* Allow rearranging fields

**Record Permissions:**

* Allow adding records and cloning records
* Allow deleting records

**Filters**

* ✅ Allow editing filters – Let users modify the filters applied to the grid

**Display Options**

* ✅ Allow conditional formatting – Allow or restrict users from applying visual formatting
* ✅ Allow editing Column Grouping – Let users group data by specific columns
* ✅ Allow adding Related Lists – Control whether users can add related lists to the grid
* ✅ Allow Freeze/Unfreeze Columns – Enable users to lock or unlock columns for easier scrolling
* ✅ Allow editing sort – Disable this option to prevent users from sorting data

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FErhwJODisUsBjG5T2ao2%2Fimage.png?alt=media&#x26;token=70d43109-1cbe-41a3-b335-5945fb7b03a9" alt=""><figcaption><p>Grid Control</p></figcaption></figure>

This section ensures that users can personalize and control their grids based on their needs.

### Refresh on Save

When Auto Refresh is enabled, the entire row updates after a successful save, ensuring all fields, including read-only fields, reflect the latest data.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2Fl2uqrsbw0LPf53ahlqVN%2FRefresh%20on%20Save.gif?alt=media&#x26;token=0a94ac83-5d50-4419-985e-d77d29272910" alt=""><figcaption><p>Example of data refresh after saving</p></figcaption></figure>

### Duplicate

The **Duplicate Grid** feature allows users to create a copy of an existing grid. This new grid will have the same structure and data as the original, and you can make any necessary adjustments to the copied grid without affecting the original.

#### Global Grids

* **If assigned to specific users**:\
  A pop-up titled **Duplicate Grid Name** appears with the following options:
  * **Duplicate Global Grid with users**
  * **Duplicate Global Grid without users**
* **If assigned to all users**:\
  The **Manage Grid** pop-up opens directly, skipping the duplicate options screen.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FIiDKe74bzeKRHAOkutp5%2FDuplicate%20global%20grid.gif?alt=media&#x26;token=30bf2747-3ac8-447f-b7df-e4999c379692" alt=""><figcaption><p>Duplicate a global grid</p></figcaption></figure>

#### Custom, Report, and Salesforce View Grids

* A pop-up titled **Duplicate Grid** appears.
* The grid name is auto-filled as `Grid Name Copy`.
* The **Manage Grid** pop-up opens immediately for further configuration.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FhaOZZJxoEh97kjjXAyio%2FDuplicate%20custom%20grid.gif?alt=media&#x26;token=7b6dbcac-7c87-42ff-82b0-3c22817bc3a9" alt=""><figcaption><p>Duplicate a custom grid</p></figcaption></figure>

### Backup Grid

The **Backup Grid** feature lets you save your grid details as a backup file, so you can easily restore it later.

**How to Back Up a Grid**

1. Click the **More Options (⋯)** icon on your Grid.
2. Select **Backup Grid**.
3. The backup file will be generated and downloaded automatically.

The backup includes your grid’s settings such as fields, filters, sorting, grouping, layouts, and related lists.\
Each file is saved in **encrypted .wave** format.

> **Note:** Global Grids are backed up exactly as set by the admin (IPCs excluded).

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F26gpDxBYamKsxUkDJ3FA%2FBackup%20from%20Grid.gif?alt=media&#x26;token=c3c96832-af32-466e-a80b-07a49effcce7" alt=""><figcaption><p>Backup Grid</p></figcaption></figure>

### Export Data

The **Export Data** feature allows you to download grid data in **Excel or CSV format**, making it easy to share and analyze.

#### How to Export Data

1. Click **More Options** in the **Toolbar** and select **Export Data**.
2. The **Export Data** window appears. Here, you can:
   * Provide a **file name**.
   * Select the export file format: **Excel** or **CSV**.
   * Choose between:
     * **Visible Records** – Exports only the records displayed on the grid.
     * **All Records** – Exports all records available in the grid.
3. Click **Export** to download the file.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FNPIiiLlBKbOmr4hc58Pa%2FExport%20Data.gif?alt=media&#x26;token=a41574c4-3cf2-43f0-a65b-9d4a39788c04" alt=""><figcaption><p>Export Data</p></figcaption></figure>

**Note:**&#x20;

* The **All Records** option is unavailable when the **Grouping** function is applied to the grid.
* Wave **Free Users** can export up to **40,000 records per month**. Once the limit is reached, exports won’t be allowed until the next monthly cycle resets.

***

## Deprecated

**This feature is no longer supported.**

### ![](https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FzqoCJApO8Yplk0k6Qki1%2FShare%20Icon.png?alt=media\&token=9ef2e66a-7753-4ee1-8bd3-f3cf8e526f64) Share

The **Share** feature allows you to share a **Standard Grid, Custom Grid, or Mapped Report Grid** with team members, enabling seamless collaboration.

#### How to Share a Grid

1. Open the grid you want to share.
2. Click the **Share** icon.
3. The **Manage your grid** pop-up appears. You can update the **Grid Name** and add a **Grid Description** if needed.
4. Assign grid permissions:
   * **Can edit** – Allows users to make changes.
   * **Can view** – Restricts users to view-only access.
5. Enter the **name or email** of the team member(s) you want to share the grid with.
6. Click **Share**.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FhzuoGfLnbqEhwktlDtgU%2FSharing.gif?alt=media&#x26;token=a61f5d94-371c-48d7-83b5-95bd450aad1c" alt=""><figcaption></figcaption></figure>

#### Managing Shared Access

* Click the **Share** icon again to view sharing details.
* To stop sharing: Click **Stop Sharing**.
* To remove access for a specific user: Click the **Delete** icon next to their name.<br>

  <figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F0ZXnN6NJiW0Vd5BTDz2J%2FRemove%20Sharing.gif?alt=media&#x26;token=26beb478-a1ba-49c1-84c6-2411eda0f138" alt=""><figcaption><p>Remove sharing access</p></figcaption></figure>

The **Share** feature allows you to share a **Standard Grid, Custom Grid, or Mapped Report Grid** with team members, enabling seamless collaboration.

***
