# 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. 

{% hint style="warning" %}
Before restoring the page in Production, make sure the required Backup & Restore steps are completed to preserve your configurations.
{% endhint %}

***

### 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

1. Open **Setup**.
2. Go to **Lightning App Builder**.
3. Confirm your **App Page** or **Record Page** is saved and activated.
4. 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:

1. In **Production**, open **Setup**.
2. Go to **Deployment Settings**.
3. Find your **Sandbox** and click **Edit**.
4. Check **Allow Inbound Changes**.
5. Save your changes.

<figure><img src="/files/wKBUGhjGgdzq6OpC6uFa" alt=""><figcaption><p>Set Up Deployment Connection</p></figcaption></figure>

***

### 4. Back Up and Restore (Required Before Deployment)

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

**In Sandbox**

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

**In Production**

1. Go to **Wave Admin → Settings → Backup and Restore**.
2. 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.

<figure><img src="/files/gMt57YguXn57dLvwS9Co" alt=""><figcaption><p>Backup and Restore the Grids</p></figcaption></figure>

***

### 5. Create an Outbound Change Set (Sandbox)

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

<figure><img src="/files/L5cgOwQXWnEebDcqcv9d" alt=""><figcaption><p>Create Outbound Change Sets</p></figcaption></figure>

#### Add Change Set Components

1. Click **Add** under the *Change Set Components* section.
2. 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)
3. Select the relevant page(s) and click **Add to Change Set**.

<figure><img src="/files/OafGs9M2KcpS0RdmfS95" alt=""><figcaption><p>Add Change Set Components</p></figcaption></figure>

#### Add Profiles

1. Click **Add Profiles**
2. Choose the profiles.
3. Save your updates.

<figure><img src="/files/fuk7qakYOP1CTaECJM0S" alt=""><figcaption><p>Add Profiles</p></figcaption></figure>

#### Upload the Change Set

1. Click **Upload**.
2. Select the target Production org.
3. Confirm the upload.

<figure><img src="/files/bEsom0b6alCR6QT6Gy0Y" alt=""><figcaption><p>Upload The Change Sets</p></figcaption></figure>

***

### 6. Deploy the Change Set in Production (Inbound)

1. Log in to **Production**.
2. Go to **Setup** → **Inbound Change Sets**.
3. Locate the change set you uploaded.
4. Click **Validate** to preview deployment results (Optional).&#x20;
5. After successful validation, click **Deploy**.

<figure><img src="/files/jpLQa3PyUMRUzbiyPPQg" alt=""><figcaption><p>Deploy the Change Sets</p></figcaption></figure>

***

### 7. Post‑Deployment

Once the Change Sets is deployed, you can make the App Page available in the **Sales app.**

***

### 8. Troubleshooting

#### &#x20;Page not visible in Production

* Ensure the page is activated.
* Check app and profile assignments.

#### Missing components

* Repackage dependencies in a new change set.

#### Deployment errors

* Review the validation error message.
* Fix missing fields, components, or permission issues.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.valorx.com/valorx-wave/surf-the-wave/migrate-grid-in-wave-embedded/migration-using-change-sets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.