Workflow
Supported reference matrix
Review supported structured references and the intentionally blocked or unsupported boundaries.
Asset Swap 26.8.5Unity 6000.0+Editor onlyBuilt-in · URP · HDRP
| Surface | Capability | Apply behavior |
|---|---|---|
| Scenes | Supported | Opens only when needed, preserves loaded scene state, blocks included dirty scenes, saves after structured changes |
| Prefabs and variants | Supported | Uses isolated prefab contents APIs; missing-script payloads are blocked |
| ScriptableObjects and serialized assets | Supported | Traverses visible and hidden object-reference properties |
| Components | Supported | Preserves prefab overrides through structured serialized properties |
| Materials | Supported | Replaces texture and shader references; shader swaps surface compatibility warnings |
| Animation clips | Supported | Rewrites object-reference keyframes while preserving binding, time, and order |
| Importers and model remaps | Supported | Backs up asset and .meta, updates structured importer data, then reimports |
| Addressables | Optional | Updates typed GUID/sub-object data; can add a missing target entry to the source group with copied labels |
| Timeline | Optional | Covers Timeline assets, clip/track sub-assets, curves, exposed references, and scene bindings through structured owners |
| Localization | Optional | Replaces asset-table values while preserving locale, table, and key structure |
| Third-party schemas | Adapter SDK | Must report deterministic exact occurrences and block on schema failure |
Intentionally unsupported
- MonoScript conversion
- unavailable fields inside missing-script payloads
- prefab-instance source conversion
- unknown strings that happen to contain a GUID
- scripts, DLLs, shaders, arbitrary text, YAML, or JSON search-and-replace
- Package Cache, Library, or imported read-only package mutation
- deleting or moving source assets
An unattributed Unity dependency is reported as unsupported instead of being repaired as text.
Still stuck?
Bring the plan and receipt with you.
Include the Asset Swap version, Unity version, operating system, plan, preview or receipt, relevant logs, and the smallest reproducible project state.