Unify Logo Footer.svg
Platform Tools
Logo
Reviewing a change set and handling conflicts

Reviewing a change set and handling conflicts

Logo

4 mins READ

Seeing what a change set will do before you deploy it, and resolving clashes with existing assets.

Overview

The Review Change Set step shows what applying the change set will do in this environment, asset by asset ("Review assets included in the change set before deploying them"). Each asset is classified so you know the effect:

  • New — it doesn't exist here yet and will be created.

  • Existing — it already exists here (matched by identity) and will be updated.

  • Replaced — it will be mapped to a different existing asset here instead of created (you choose which — see below).

Reviewing this before deploying is how you avoid surprises: you can see exactly what's added, what's overwritten, and what's mapped, and catch anything you didn't intend.

Where: Inbound change set › Review change set

Screenshot 2026-08-31 at 17.34.48 1.png
Screenshot 2026-08-31 at 17.34.48 1.png

How conflicts with existing assets are handled

A "conflict" is really just an Existing asset — something in the change set that already exists in the destination. By default an existing asset is updated to match the incoming version (when deploying you can choose Skip Records instead, which leaves existing assets untouched). For two asset types where you usually don't want a duplicate — connections and AI/LLM models — you can instead replace: map the incoming asset to an existing one in this environment, so everything that referenced it now points at your destination asset. For example, an automation built against a dev connection can be mapped to use the equivalent production connection on import. This is what keeps environment-specific things (credentials, endpoints) correct after promotion.

Where: Inbound change set › review (New / Existing / Replaced)

Mapping (replace) an asset to an existing one

The review step calls out what needs your attention before proceeding:

  • Connections ("Please verify the required connections") — for each incoming connection, pick an existing connection here to replace it with, or add a new one. Existing connections remain unchanged.

  • AI models ("Please verify the required models") — likewise, map an incoming model to an existing one or add a new model.

  • Environment variables ("Please verify the required Environment variables") — variable values are never exported with a change set, so you enter the value each new variable should have in this environment.

Once mapped, the imported assets that depended on the original use your chosen destination asset instead, and the incoming one is marked Replaced rather than created. Use this for anything that should stay environment-specific (a database connection, an API credential, a model deployment) so the promoted automations connect to the right resources in each environment.

Where: Inbound change set › replace / map assets

FAQs

How do I see what went wrong with a failed asset?

If an asset fails to apply, it's marked Failed and the reason is recorded against it — a human-readable error such as a missing dependency or a reference that doesn't resolve in this environment. On the change set's details (after a deploy, successful or failed) a Download Error Report button exports a spreadsheet listing each failed asset and its error, which is handy for fixing the source before sending a corrected change set. Because failures are tracked per asset, the rest of the change set can still have deployed — you fix the specific assets rather than starting over.

Where: Inbound change set › Download Error Report