Migration Using Change Sets

This guide explains how to migrate Grids embedded in Lightning App Pages or Record Pages from a Sandbox environment into Production using Change Sets (Outbound and Inbound). It covers the full process; preparation, backup and restore, validation, and deployment so your pages move smoothly.

Before restoring the page in Production, make sure the required Backup & Restore steps are completed to preserve your configurations.

1. Prerequisites

Admin access to both Sandbox and Production.
Sandbox and Production environments must be connected via deployment settings.
Pages must be activated and saved in the Sandbox.

2. Prepare the Pages in Sandbox

Open Setup.
Go to Lightning App Builder.
Confirm your App Page or Record Page is saved and activated.
Test the page in Sandbox to ensure it behaves as expected.

3. Set Up Deployment Connection (Production)

Before you can deploy from Sandbox, ensure Production allows inbound change sets:

In Production, open Setup.
Go to Deployment Settings.
Find your Sandbox and click Edit.
Check Allow Inbound Changes.
Save your changes.

4. Back Up and Restore (Required Before Deployment)

To preserve Matrix/Grid configurations used within the App Page:

In Sandbox

Open the App Page you want to migrate.
Click the More Options menu (the three dots).
Select Backup.
Back up all Grids and Matrices used on the page.

In Production

Go to Wave Admin → Settings → Backup and Restore.
Restore the backup file you created in Sandbox.

Restoring the backup in Production ensures all Grid and Matrix configurations are ready before you deploy the App Page.

5. Create an Outbound Change Set (Sandbox)

In Sandbox, go to Setup.
Search for Outbound Change Sets.
Click New and enter a name and description.
Save the change set.

Add Change Set Components

Click Add under the Change Set Components section.
From the Component Type dropdown, select:
- Lightning Page for App Pages or Record Pages.
- Tab (Only for App Page)
- Lightning Web Component (if you have Row or Grid Action using LWC)
- Aura (if you have Row or Grid Action using Aura)
- Flow (if you have Row or Grid Action using Flow)
Select the relevant page(s) and click Add to Change Set.