# Scenario to Main Org Merge

Merge an approved scenario into Main Org to make planned changes the new organizational baseline.

**Note:** Scenario to Main org Merge is only used for accounts with no automated integration setup.

**Before you start:**

* Only approved scenarios can be merged
* Only admins can perform this operation
* Merges are permanent

## How to Merge

1. Navigate to **Main Org**
2. Open toolbar > **Data Management** > **Merge Approved Scenarios to Main**

<figure><img src="https://2094208261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCZc46qaaBbVmMuYXPfgz%2Fuploads%2FDc9Sj35ZjgXTbNTJCGF5%2Fimage.png?alt=media&#x26;token=486ea920-8fd6-41a1-a2f4-283daebdbb81" alt=""><figcaption></figcaption></figure>

3. Select the approved scenario from the list

<figure><img src="https://2094208261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCZc46qaaBbVmMuYXPfgz%2Fuploads%2F8UfLr32bSbpVrTdq9kHz%2Fimage.png?alt=media&#x26;token=75560a90-96db-4d4e-aef2-c080351e1c7d" alt=""><figcaption></figcaption></figure>

4. Click **Next**

**Select fields to merge:**

* Select All (recommended) — all scenario changes apply to Main Org

<figure><img src="https://2094208261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCZc46qaaBbVmMuYXPfgz%2Fuploads%2F5nUJyIYq2w4vMtxUDaS0%2Fimage.png?alt=media&#x26;token=6fb77602-7642-4158-91ec-b2c1bcfe2f02" alt=""><figcaption></figcaption></figure>

* Selective fields — only chosen fields update (e.g., Department only); useful when a scenario only modeled one type of change

**Include New Positions:**

* Check to bring new positions created in the scenario into Main Org
* Uncheck if new positions were hypothetical only

5. Review conflicts — when the same position was edited in both the scenario and Main Org since the scenario was created, a conflict appears. Click **"Use Scenario Values for All Conflicts"** — approved scenarios should be treated as the source of truth.

<figure><img src="https://2094208261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCZc46qaaBbVmMuYXPfgz%2Fuploads%2FcIJ1fOaHbEJVZ2ePErKd%2Fimage.png?alt=media&#x26;token=e62a8430-fd54-4ca9-9847-d56456308b40" alt=""><figcaption></figcaption></figure>

6. Click **Merge to Main**

<figure><img src="https://2094208261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCZc46qaaBbVmMuYXPfgz%2Fuploads%2F4uHWE7zDpJvc2MpyQWzC%2Fimage.png?alt=media&#x26;token=96880c46-0852-4290-8790-9e2b9d017095" alt=""><figcaption></figcaption></figure>

7. Wait for completion, then verify changes in Main Org

## Full Org vs. Partial Org Scenarios

The merge process is the same for both. A Partial Org scenario only affects positions within its scope — the rest of Main Org is untouched.

## Before Merging

* Verify the scenario is fully approved
* Review the scenario one more time — open it and check the OpEx Panel for complete impact
* Communicate to affected teams that changes are going live
* Choose your timing — merge during low-activity periods and coordinate with team announcements

## After Merging

* Browse Main Org to confirm changes applied (new positions, reporting changes, modifications)
* Notify stakeholders that changes are live and share the updated org chart if needed
* Archive the scenario or keep it for historical reference

## Troubleshooting

| Problem                               | Solution                                                                                          |
| ------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Scenario doesn't appear in merge list | Verify scenario status = "Approved"; check admin permissions; refresh the page                    |
| New positions didn't merge            | "Include New Positions" was unchecked — create a new scenario with just those positions and merge |
| Some changes didn't apply             | Check which fields were selected; verify conflicts were resolved with scenario values             |
| Merge is taking a long time           | Wait — large orgs with many changes take longer; don't refresh the page                           |

## Related Articles

* [Scenario Approvals](https://docs.agentnoon.com/scenarios/approvals)
* [Scenario Merging](https://docs.agentnoon.com/scenarios/advanced-actions/merging)