> For the complete documentation index, see [llms.txt](https://docs.agentnoon.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.agentnoon.com/scenarios/advanced-actions/scenario-to-main-org.md).

# 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="/files/iGz4iu8bd5mXfbNRQZCK" alt=""><figcaption></figcaption></figure>

3. Select the approved scenario from the list

<figure><img src="/files/JWhVQ5ZPh1RtTWfPODxK" alt=""><figcaption></figcaption></figure>

4. Click **Next**

**Select fields to merge:**

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

<figure><img src="/files/yZ2o1oLxGZKwgILG19ru" 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="/files/qVMsajVW92XipMqWkyCC" alt=""><figcaption></figcaption></figure>

6. Click **Merge to Main**

<figure><img src="/files/kD5XoOGgkwW4hjuy0Por" 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](/scenarios/approvals.md)
* [Scenario Merging](/scenarios/advanced-actions/merging.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.agentnoon.com/scenarios/advanced-actions/scenario-to-main-org.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
