Update sets
Move configuration safely from dev to test to production.
Update sets are how configuration travels between instances. They are the backbone of safe change management: build in dev, capture the changes, promote to test then production, never edit prod by hand. Understanding exactly what they do (and pointedly do not) capture prevents most deployment surprises.
- What they capture, and what they don't
- The promotion flow
- Collisions and batching
- Update sets vs scoped apps
- Common mistakes
Update sets are how configuration travels between instances. They are the backbone of safe change management: build in dev, capture the changes, promote to test then production, never edit prod by hand. Understanding exactly what they do (and pointedly do not) capture prevents most deployment surprises.
What they capture, and what they don't
sys_metadata.The promotion flow
Collisions and batching
A collision means the target already has a different version of a record in the set, the preview flags it and you choose to accept or skip. Batching lets you group multiple update sets so they preview and commit together in dependency order, which is invaluable for larger releases.
Update sets vs scoped apps
Common mistakes
- Forgetting to set the current update set, so changes land in Default and can't be moved.
- Expecting data to travel with the set.
- Committing without previewing and walking into collisions on prod.
- Committing update sets out of dependency order, so referenced records are missing.