---
title: "Object Transporter migration workflow: pre-check, first…"
description: "OX runs error check, first-50 prerequisites, pre-migration diff, then migrate. Choose Merge vs Override for security policies; run Tenant Compare after."
url: https://kiweely.com/guides/workday-object-transporter-migration-workflow
---

# Object Transporter migration workflow: pre-check, first 50, merge vs override

Object Transporter blocks on source errors, then lists missing prerequisites—only the first 50 at a time. Clear Reference IDs or map instances, review the Pre-Migration Diff, pick Merge or Override for security policies, migrate, then use the Post-Migration Report or Tenant Compare.

-   **Checked** against Workday on November 18
-   Applies to **Workday Object Transporter, Customer Central**
-   3 min read
-   Published November 18
-   By Kiweely

Object Transporter (**OX**) moves configuration through a fixed sequence: **error check → prerequisites (first 50) → Pre-Migration Diff → migrate**. Skipping the diff or guessing past a missing Reference ID is how you overwrite the wrong target instance. After the move, use the **Post-Migration Report** (kept **two years**) or **Run Tenant Compare**.

You can start from **Migrate with Object Transporter** / **Migrate Configuration Extract** on the source tenant (Workday redirects to Customer Central) or from the **Configuration Catalog** / **Tenant Dashboard** tasks for catalog packages into Implementation or Sandbox.

## Stage 1 — Error check

Blocking source problems land on **View Errors** with fix guidance. Nothing else matters until this page is clear. Retry only after the structural errors are gone.

## Stage 2 — Prerequisites (the first-50 trap)

**Pre-Migration Check** / **Pre-Check Migration** flags a prerequisite when the target has:

-   No corresponding instance
-   A missing Reference ID
-   A mismatched Reference ID

**You must resolve the first 50 rows before Workday reveals more.** Plan rescan time into every cutover rehearsal.

| Column signal | Decision |
| --- | --- |
|  **Non Mappable = Yes** | Sign in to the target: create the instance with a matching Reference ID, or fix the ID on an existing instance. |
|  **Map Instance** available | Map to a compatible target Reference ID inside the workflow (tailored loading), then **Apply Mapping**. |
| Empty / no action | Leave it. |

After target-side edits or mapping, click **Rescan Target**. After source-side edits, click **Retry Migration**. Align Reference IDs across both tenants as you go—OX identity is the Reference ID, not the display name.

OX migrates top-level objects and their dependent **configuration**, not transactional or reference data. Workday’s own example: migrate a custom report and its calculated field; the **location** the field uses stays a prerequisite you create or map on the target.

## Stage 3 — Pre-Migration Diff and security behavior

When prerequisites clear, open **View Pre-Migration Diff**. Tabs:

| Tab | Meaning |
| --- | --- |
|  **All Instances** | Full scope (single instance = one top-level plus dependents). |
|  **Modified** (orange) | Exists on both sides, different. Non-security instances are overwritten by source. Security policies **merge by default**. |
|  **New** (blue) | Added to the target. |
|  **No Change** (gray) | Identical—no migration needed. |
|  **Excluded** | Top-level instances you removed from this run. |

Use **View Dependencies**, **View Attribute Diff**, and **Manage Modified Instances** before you commit. Excluding a top-level instance also excludes its dependencies for this migration (shared dependents of another in-scope type may still move). Saved exclusions are not undoable—start a new migration to reverse them. Diffs for abandoned runs remain about **30 days**.

If the package includes modified domain or business process security policies, open **Edit Migration Behavior**:

| Option | Use when |
| --- | --- |
|  **Merge (Recommended)** | Additive. Protects target-specific groups/roles. Routine Preview/Sandbox → Production updates. |
|  **Override** | Source is authoritative; initial deployment or intentional full replace of those policies. |
|  **Manual Selection** | Mixed package: Merge some policies, Override others. |

Migrations of **security groups and their business process security policy permissions are always additive**. OX will not remove existing group assignments on the target; a security administrator must remove them manually if that is the design.

Set **effective dates** with **Set Effective Date Strategy** when instances carry dates (default **01/01/1900** or a chosen date; refine by implementation type or instance). You can change dates after migration.

## Stage 4 — Migrate, then prove it

**Proceed with Migration** → **Start Migration**. OX always moves the **current** tenanted version of an object—not a frozen snapshot from the day you added it to a package.

Then:

1.  Open the **Post-Migration Report** summary (available **two years**).
2.  Optionally **Run Tenant Compare** from that page to save a structured source/target comparison.
3.  For reports you migrated, validate them and check alerts/downstream processes—Workday calls this out explicitly for report migrations.

Catalog content you refined in Sandbox only goes to Production after Customer Central Production access is set up. Treat every Production OX as the same four-stage workflow with Merge as the default security choice unless you intentionally Override.

## Frequently asked questions

### Why does OX only show 50 prerequisites?

Workday lists the first 50 missing prerequisites. You must resolve that batch before it identifies and displays additional issues. Use Rescan Target after target fixes or mapping; Retry Migration after source fixes.

### Should I Merge or Override security policies?

Merge (recommended default) adds permission-holding components without removing target groups or roles—safest for routine Sandbox-to-Production updates. Override replaces the target policy with the source. Security group assignments to business process security policies are always additive either way; removals stay manual.

### Does OX migrate locations and other reference data?

No. It migrates configuration objects and their dependent configuration (for example a custom report and its calculated field) but not transactional or reference data. A location used by a field shows up as a missing prerequisite, not as migrated content.

## Sources checked

-   [Migrate Configuration Catalog Content with Object Transporter](https://doc.workday.com/admin-guide/en-us/manage-workday/tenant-configuration/implementation-tools/customer-central/object-transporter/qbd1670640965501.html)
-   [Concept: Object Transporter Migration Workflow](https://doc.workday.com/admin-guide/en-us/manage-workday/tenant-configuration/implementation-tools/customer-central/object-transporter/concept--object-transporter-migration-workflow.html)
-   [Concept: Object Transporter](https://doc.workday.com/admin-guide/en-us/manage-workday/tenant-configuration/implementation-tools/customer-central/object-transporter/omh1634567473070.html)

## Related guides

[All guides](https://kiweely.com/guides)

-   [### Workday Object Transporter (OX) Errors: Prerequisites, Diffs, and What Moves Object Transporter runs a four-stage sequence before moving configuration between Workday tenants: error check, prerequisite check, pre-migration diff report, and migration. Here is how to fix missing Reference IDs, handle the 50-prerequisite cap, and choose Merge vs. Override for security.](https://kiweely.com/guides/workday-object-transporter-errors)
-   [### What are the types of tenant in Workday? Sandbox, Sandbox Preview, Implementation and Production compared Most Workday customers get four tenants: Production, Sandbox, Sandbox Preview and Customer Central. Implementation and demonstration tenants cost extra. Sandbox refreshes weekly from Production, Preview twice a year, Implementation on demand.](https://kiweely.com/guides/workday-tenant-types)
-   [### When does the Workday Sandbox refresh, and what does it wipe? Weekly: Workday replaces the Sandbox with a full copy of Production data and configuration. Public Workday docs give no day or hour, so ask your tenant management contact. Preview refreshes twice a year, Implementation on demand.](https://kiweely.com/guides/workday-sandbox-refresh)

### More guides on Integrations and APIs

[All 89 guides](https://kiweely.com/guides#integrations)

-   [What does Workday Studio “Content is not allowed in prolog” mean?](https://kiweely.com/guides/workday-studio-content-is-not-allowed-in-prolog)
-   [Why does Workday RaaS time out for non-admin users but work for admins?](https://kiweely.com/guides/workday-raas-timeout-non-admin-user)
-   [Why does a custom object update return 403 with escaped HTML in the body?](https://kiweely.com/guides/workday-custom-object-patch-403-escaped-html)
-   [Why does Create WCP API Client return 409 for an ISU?](https://kiweely.com/guides/workday-create-api-client-409-isu-already-has-client)
-   [How do I set an Integration System Security Group for an Integration System User?](https://kiweely.com/guides/workday-issg-for-integration-system-users)
-   [SOAP vs RaaS Basic Auth vs OAuth: which Workday credentials do I use?](https://kiweely.com/guides/workday-soap-vs-raas-vs-oauth-authentication)
-   [Which Object Transporter migration paths does Workday support?](https://kiweely.com/guides/workday-object-transporter-migration-paths)
-   [Sandbox to Production Object Transporter checklist](https://kiweely.com/guides/workday-object-transporter-sandbox-to-prod-checklist)

### From the blog on Integrations and APIs

[All posts](https://kiweely.com/blog)

-   [Ask Claude, ChatGPT, or Gemini About a Failed Workday Run](https://kiweely.com/blog/ask-an-assistant-about-a-failed-workday-integration)
-   [Before-and-After Diffs and One-Step Rollback for Integration Fixes](https://kiweely.com/blog/before-and-after-diffs-and-one-step-rollback)
-   [What Is an AI-Built Workday Integration Platform Outside the Tenant?](https://kiweely.com/blog/what-is-ai-built-workday-integration-platform)

## Let Workday check the work.

Kiweely writes WQL and builds orchestrations in your own tenant, and Workday, not Kiweely, says whether they passed.

[Start for free](https://kiweely.com/download) [See how it works](https://kiweely.com/vine/how-it-works)

## Get the next guide in your inbox.

One email a month with new guides and one Extend tip. Nothing else.
