ServiceNow Update Sets and Release Management Implementation Roadmap
An update set records a group of configuration changes made in a development instance so it can be deployed to later environments. This roadmap moves a team from informal changes to a phased release process with source control, testing and quality gates over about a year.
Phase 1: Assess Current State and Define Goals (Weeks 1-4)
Entry criteria: ServiceNow instance exists with customizations scattered across development without formal release process. Exit criteria: current state documented, target state defined and team alignment achieved.
Activities: Inventory current customizations: which tables, workflows, UI pages and plugins are custom? Which are in production? Document how changes currently flow from dev to test to production. Interview teams to understand pain points: are changes getting lost? Do releases fail? Do teams overwrite each other’s work? Define target state: What does a successful release look like? How will we track changes? Who will manage releases? What quality gates must pass before production deployment?
Phase 2: Foundation Setup (Weeks 5-12)
Entry criteria: Current state is well understood and goals are defined. Exit criteria: Update Sets are enabled, source control is configured and team processes are documented.
Activities: Enable Update Sets in the ServiceNow instance. Establish source control (Git) and code repository. Configure the repository to match ServiceNow instance structure: development, test, staging and production. Train developers on Update Set creation: how to record changes in a dev instance, commit to Git and send Update Sets to other instances. Define branching strategy: main branch for production-ready code, feature branches for new work, hotfix branches for urgent fixes.
Phase 3: Pilot Release (Weeks 13-24)
Entry criteria: Update Sets and source control are configured. Exit criteria: first release successfully deployed to production; team has learned and documented process.
Activities: Select a small set of customizations (a single module or workflow) for the pilot release. Developers work in a development instance, capturing changes in an Update Set. Test team tests the Update Set in a test instance. Once testing is complete and issues are resolved, the Update Set is deployed to staging for final review. Upon approval, the Update Set is deployed to production. Document the process: what worked, what was difficult, what should change for the next release.
Phase 4: Release Infrastructure and Quality Gates (Weeks 25-36)
Entry criteria: Pilot release is successful. Exit criteria: automated testing and deployment infrastructure are operational.
Activities: Implement automated testing: unit tests for business rules and workflows, integration tests for data flows and external system integration. Implement automated code scanning to detect quality issues (unused variables, potential bugs). Configure automated deployment pipelines: when an Update Set is approved, automatically deploy to test, staging and production. Define quality gates: tests must pass, code quality must meet thresholds, no critical defects. Only Update Sets that pass all gates can be deployed to production.
Phase 5: Scale and Optimization (Weeks 37-52)
Entry criteria: Infrastructure and quality gates are operational. Exit criteria: multiple releases per quarter are running smoothly with minimal issues.
Activities: Train all development teams on Update Set and release processes. Migrate all existing customizations to the repository. Establish a regular release schedule set by demand. Hold release planning meetings: review changes queued for the next release, assess risk, decide whether to include in the next release or defer. Measure release quality: track defects found in production and root cause analysis (code issue, testing gap or requirement misunderstanding). Use metrics to drive continuous improvement.
Common Sequencing Mistakes to Avoid
Do not skip the pilot phase. Jumping directly to production releases of complex customizations increases risk of failure. Start small, learn and scale.
Do not release large batches of unrelated changes at once. If release A contains 10 changes and production breaks, identifying which change caused the break is difficult. Smaller, focused releases make debugging easier.
Do not release to production without testing. Pressure to move fast is real but testing is the quality gate. Shortcuts lead to production defects that damage credibility and require emergency hotfixes.
Do not neglect documentation. If only one person knows how to perform a release, that person becomes a bottleneck. Document release procedures so anyone with permission can execute them.
Team Roles and Dependencies
Developers record and test changes, ensuring code quality. Release Manager plans releases and approves Update Sets for deployment. Test team validates changes against requirements. Compliance or Security team approves for regulated environments. Operations team may execute deployment if automation is not in place. Ensure clear handoff between roles: developer finishes, releases to test team; test team finishes, releases to release manager; release manager approves for production.
Update Set management requires discipline. Each Update Set should contain a cohesive set of related changes, not random modifications. Naming conventions help: prefix Update Sets with module names (HR_Add_Approver_Role, ITSM_Notification_Update). Include detailed descriptions so reviewers understand scope and impact. Link to incident or change requests that prompted the Update Set, creating traceability.
Rollback planning is critical. If an Update Set causes problems in production, you must be able to roll it back quickly. Document the rollback procedure for each Update Set: which tables are modified, which data is affected, whether rollback is reversible or requires manual intervention. Some Update Sets cannot be safely rolled back if they contain data migrations; for these, higher scrutiny and testing are warranted.
Choosing the starting point for the roadmap
A roadmap is only as good as its first move, and the first move depends on the state of the platform on the day the work begins. Some organizations have one instance with heavy local customization and no record of who changed what. Others have a clean instance but several teams building in parallel. A third group is under audit pressure and needs evidence before anything else. Each situation calls for a different opening step, and applying a generic sequence to all three is how roadmaps stall in their second quarter. Identify which situation applies, then choose the opening move from the table.
| Starting situation | Opening move | What to avoid first |
|---|---|---|
| Heavy undocumented customization on one instance | Inventory what exists and capture it into sets before changing anything | Building automation on top of changes nobody can account for |
| Several teams building in parallel | Agree one promotion path and one owner for collisions | Adding more environments before the first path works |
| Audit or regulatory pressure | Establish the evidence record for the next release | Redesigning tooling when the gap is documentation |
| Small, stable platform with infrequent change | Write the procedure and rehearse one release end to end | Investing in pipelines that the release volume cannot justify |
Readiness checks that gate each phase
Phases should close on evidence, not on the calendar. Before a team moves from one phase to the next, confirm each of the following:
- The outputs of the current phase exist in a form someone other than the author can use.
- Every open item has either been closed or moved to a named owner with a date the owner has accepted.
- The people who will run the next phase have done the work at least once under supervision.
- Any rollback step introduced so far has been rehearsed, not just written down.
- The team has agreed what would cause the phase to be repeated rather than pushed forward.
Pausing or stopping the roadmap without losing ground
Roadmaps are sometimes stopped for good reasons: a platform migration is announced, a key owner leaves, or the business changes its priorities. A pause is safer than a half-finished rollout. Before stopping, record which sets are in progress, which environments hold changes not yet in the development line, and who is responsible for each open item. Where the platform is already in an uncertain state, the platform health check readiness guide describes what to look at before committing to a sequence.
Frequently asked questions about the roadmap
Does the roadmap need to start with source control in place?
Not always. Source control adds the most value once several people are changing the platform and releases are regular. If the change volume is low, a disciplined set-based process with a written record may serve better until the team is ready to maintain repositories alongside the instance.
Who should own the roadmap once the initial work is done?
Give ownership to whoever will run releases after the roadmap ends. A roadmap owned by an outside team tends to finish with its document rather than its practice, so the release owner should take the lead as early as the pilot.
How do you know the roadmap has succeeded?
The clearest sign is that someone outside the design group can run a release from the written procedure and the platform record alone. If they still have to ask the original team how a step works, the roadmap is not finished.
Next step for planning your release roadmap
The implementation phases and deliverables guide sets out how phase gates work across a wider program.
Release Management in ServiceNow: Governance Record Versus Code Movement
In ServiceNow, release management usually refers to two linked jobs. The first is governance: a change record that says what is going live, who approved it and when. The second is movement: getting the customisations built in a development instance into test and production, typically by way of update sets or a source control repository. Many release problems start when only one of the two is in place.
The two jobs fail differently. A team with a strong change record but loose movement knows who approved a change but cannot say which update set carries it, so a production fault is slower to trace. A team with clean update sets but no change record can move code safely while nobody outside the build team knows it happened. The table below shows where each side is strong and where it leaks.
| Question | Change record | Update set or repository |
|---|---|---|
| What it answers | Whether the change is approved, scheduled and understood by the business | Exactly which configuration and code moved, and between which instances |
| Who usually owns it | A change or release manager with approval rights | The developers who built the change |
| Typical gap when missing | Changes reach production with no record of who accepted the risk | Fixes are made by hand in production and never return to the development line |
Use a decision rule for the first fix rather than building both at once. If releases fail because nobody can say what changed, fix movement first: define one promotion path and make every change travel inside a named set. If changes reach production without anyone outside the build team knowing, fix the change record first, because the approval gate is usually the cheaper control to add. Teams that try to build both in the same quarter usually finish neither.
If the approval side is the gap, start with the change enablement guidance. For the sign-off rules on a deployment, the DevOps governance model is the next step. Once movement is running, the update set troubleshooting guide covers the faults that appear in practice.
Frequently asked questions
How many release managers should we have?
At minimum, two so there is coverage when one is unavailable. Each release manager should be trained to execute the full release process independently. For large organizations with multiple releases per week, three or more release managers may be needed to spread workload and ensure availability.
What should we do if a critical bug is discovered in production?
Use a hotfix process: create a hotfix branch in source control, develop and test the fix quickly, obtain expedited approval and deploy immediately. Hotfixes bypass the normal schedule to address critical issues. After the hotfix is deployed, capture the lesson in post-incident review: how do we prevent this bug in the future?
How do we handle conflicts if two developers modify the same code?
Use source control to manage conflicts. When merging branches, if both developers modified the same code, the version control tool flags the conflict. Developers must resolve the conflict: determine which changes to keep. Code review before merging helps catch conflicts early. For large teams, use code review as a standard practice to reduce conflicts and improve code quality.
Related guides
Related Oblytech services
Where this topic turns into delivery work, these are the Oblytech services that cover it.
Planning, running or fixing a ServiceNow programme? Tell us where you are and we will suggest a sensible next step.
Contact us