Backup & Restore

Save your Grids and Matrices — and bring them back exactly as they were, any time.

Overview

The Backup and Restore feature lets you save a complete snapshot of your Grids and Matrices including all their settings, fields, filters, rules, and more. You can then restore that snapshot to the same org or a completely different one.

This is useful for:

• Moving grids between production and sandbox environments

• Recovering a grid after accidental changes

• Setting up the same grid configuration in a new org

• Keeping an archive of your grid setups before making major changes

How to Access Backup & Restore

Wave Embedded

Inside Salesforce → Wave Admin tab → Backup & Restore

Wave Extension

Click the User Profile icon → Settings → Backup & Restore

Who Can Use Backup & Restore

Role	What They Can Backup	What They Can Restore
Admin	Grids and Matrices	Full Access
Designer	Grids and Matrices	Full Access
Standard User	Grids only (not Matrices)	Grids Only

Standard Users and Global Grids

When a Standard User restores a Global Grid, it is automatically converted to a Custom Grid for that user.

Supported File Types

Backup and Restore uses two file formats:

Item	What It Does
.wave	An encrypted file containing the complete details of a single Grid or Matrix. This is the primary backup format.
.zip	A package containing multiple .wave files. Used for backing up or restoring several Grids or Matrices at once. Note: the .zip itself is not encrypted.

Backup File Format

Each .wave file includes the Grid or Matrix name and timestamp: <GridOrMatrixName> - <Timestamp>.wave

Example: CustomScheduleItemGrid - 13-Nov-2025 8.28.16 AM.wave

What's Included in a Backup

A backup file captures everything about a Grid or Matrix and not just its structure, but all the configuration details that make it work exactly as you've set it up:

Item	What It Does
Fields	All fields, including attachments and formula fields
Filters	All applied filters and filter logic
Rules & Conditional Logic	All conditional formatting and business rules
Sorting	Column sort order and direction
Grouping	Row grouping hierarchy and column grouping structure
Layout Structure	Column widths, order, and layout configuration
Related Lists	Related and nested related list panels
Row & Grid Actions	All row-level and grid-level action buttons
Custom Settings	Any other custom preferences or configurations
Global Grids/Matrices	Backed up as configured by the admin (IPC grids are excluded)

How to Back Up a Grid or Matrix

Follow these steps to create a local backup:

1

Go to Settings > Backup & Restore

Click the User Profile icon and select Settings, then choose Backup & Restore from the menu.

2

Click Backup Locally

This opens the backup selection screen.

3

Select the Grids or Matrices to back up

Check one or more items from the list. You can back up multiple items at once.

4

Click Backup Now

The backup file is generated and downloaded to your computer automatically

Backup Locally

If you select multiple items, the download will be a .zip file containing individual .wave files for each Grid or Matrix.

---

How to Restore a Grid or Matrix

Follow these steps to restore from a backup file:

1

Go to Settings > Backup & Restore

Click the User Profile icon and select Settings, then choose Backup & Restore.

2

Click Restore

This opens the restore upload screen.

3

Upload your file(s)

Upload a .wave file for a single Grid/Matrix, or a .zip file for multiple.

4

Click Restore Now

The system validates each file before proceeding. It checks for file integrity, encryption, schema version compatibility, and whether the Grid or Matrix already exists in the target org.

5

Handle duplicates (if any)

If the system detects a Grid or Matrix with the same name already in the org, you'll be asked to choose one of three options:

Option	What Happens
Create New Copy	Imports the backup as a new Grid/Matrix with a "_Copy1" suffix added to the name. The original is not affected.
Overwrite	Replaces the existing Grid or Matrix with the backup version. The existing version is permanently overwritten.
Skip	Skips this particular file and continues restoring the remaining files in the upload.

6

Click Apply

Confirms your selection for duplicate handling and starts the restore.

7

Monitor progress

A progress bar shows the status of the restore. Once complete, a summary confirms which Grids and Matrices were successfully restored.

Restore file

Important Notes

New Grids Default to All Users Access

When restoring a grid that does not already exist in the target org, the system automatically sets the grid access to All Users, regardless of the access configuration in the backup. This ensures that the restoring user can immediately view and access the grid. If the grid already exists in the target org, the restore process retains the existing access configuration.

Cancel Is Disabled During Restore

Once a restore is in progress, the Cancel button is disabled to prevent partial or incomplete operations. Wait for the restore to finish.

Bulk Restore Supported

You can upload multiple .wave files or a single .zip file containing many grids — the system will process them all in one go.

IPCs Are Not Included

Inter Personal Copy (IPC) grids are excluded from both backups and restores. Global Grids and Matrices are backed up and restored as configured by the admin.

Backup and Restore a grid