Moving to ServiceNow Customer Self-Service Portal: Migration Considerations
Inventory Your Current Self-Service Capabilities
Before you move to ServiceNow Customer Self-Service Portal, understand what capabilities exist today. Some organizations have portal implementations in separate systems (a knowledge base here, a ticketing portal there). Others have email-based request submission or phone support only. You need to inventory what works today so you do not lose capabilities during migration.
Create a capability matrix: list what self-service functions customers use now, where each lives and how many customers use it. Identify capabilities you will recreate in the new portal and capabilities you will eliminate. Customers will complain if they lose a capability they depended on, even if you consider it outdated.
Interview support teams about what customers ask for. Track common requests and issues. These become priorities for your migration. Customers who are used to handling a process through an existing channel will expect similar ease in the new portal.
Data and Process Mapping
Moving to the new portal requires mapping current data to ServiceNow structures. If your current system stores customer requests in a different format, you need transformation logic to import data cleanly. If current processes have steps ServiceNow does not automate, you must decide whether to change the process or build custom automation.
Map your current customer record structure to the Contact table in ServiceNow. Document customer hierarchies if you have parent accounts with multiple contacts. Map existing request types to ServiceNow service requests. Identify data fields that do not have equivalents in ServiceNow and decide how to handle them (keep in ServiceNow with custom fields, archive separately, or drop).
Create a data quality assessment. Scan your current customer records for invalid email addresses, missing required fields and duplicate records. Clean the data before migration. Migrating dirty data means the new system starts with quality problems.
Cutover Planning
Decide whether to cutover all customers at once or phase migration by customer group. A big bang cutover is faster but risky; if problems occur, all customers are affected. A phased cutover is slower but allows you to identify and fix problems before the full population sees them.
For a phased approach, group customers by segment: high-value accounts first (you can support them through problems), then medium accounts, then small accounts. High-value customers get more support during transition. By the time small customers migrate, your team knows what works and can handle volume better.
Plan parallel running if possible. Keep the old portal available for a transition period so customers can switch at their own pace. Set an explicit end date for the old system so customers understand they must migrate eventually. Parallel running creates more operational burden but makes the migration feel less like a forced change.
Risk Mitigation Strategies
The biggest migration risk is customers unable to use the new portal and reverting to other channels (email, phone). Mitigate this with extensive testing before launch. Test with real customers in beta, not just internal teams. Monitor their experience and make adjustments based on their feedback.
Communication is critical. Announce the change well in advance. Explain what customers will see in the new portal. Describe how to accomplish their common tasks. Offer support hotline during the transition. Send multiple messages at different intervals so information sinks in.
Data loss is another major risk. Validate that historical data migrated correctly. Spot check records by selecting random samples and verifying they match the source system. If you discover migration errors, decide whether to re-run the migration or accept the errors and provide a correction process.
Performance degradation during migration is common. The new system is handling different volumes or query patterns than the old. Monitor performance during and after cutover. Have a performance optimization plan ready if response times degrade.
Validation Steps
Before cutover, run through a checklist: Can customers log in? Can they submit requests? Can they search for knowledge? Can they track ticket status? Does data appear correctly? Are notifications being sent? Do custom workflows execute? Have you tested on mobile devices? Have you verified that customers only see their own data?
Plan a sanity check period immediately after cutover where you monitor the system closely for problems. Have a rollback plan if critical issues occur, though rolling back after cutover is rarely feasible. Prepare to have additional support resources available for the first weeks.
Choosing a cutover pattern from the risk you can tolerate
A portal migration is rarely a single decision. It is a choice between patterns, each of which trades speed for exposure in a different place. A big-bang cutover is quick to finish and puts every customer through the same risk at once. A segment-by-segment cutover is slower and spreads the risk, but it means running two systems long enough for the differences to cause confusion. The right pattern depends on how many customers would be stranded by a failure and how quickly you can recover from one.
Before choosing, write down the way back. Some migrations can be reversed by re-enabling the old portal and redirecting traffic. Others cannot, because cases or preferences have been created in the new system and would be lost or duplicated by a return. A pattern that cannot be reversed needs a longer rehearsal and a tighter decision gate, whatever its speed.
| Pattern | Best when | Main risk | Way back |
|---|---|---|---|
| Big-bang cutover | Customer base is small, data is clean and the old portal is failing anyway | Every customer is affected by any defect at once | Redirect to the old portal if no new records have been written |
| Segment cutover | Customers differ in value or in how much support they need | Two systems create confusion about where a request lives | Per segment, if the segment’s records are kept in both |
| Parallel running with an end date | Customers need time, and the old portal can be kept read-only | Duplicate submissions across both systems | Close the old submission route first, then the old read path |
Rehearsing the cutover before the real one
A rehearsal is the most reliable way to find the steps that depend on memory. Run it in a copy that resembles production, time each step, and write down anything that needed a person to intervene.
- Freeze new submissions on the old portal for the rehearsal window, and record how many items were open at the start.
- Run the data load from the old system, then reconcile the counts of open cases, closed cases and attachments against the source.
- Switch the customer login route in the copy, and log in as one test customer per organization type.
- Submit one new request and one follow-up on an existing migrated case, and confirm that both reach the back office with the right group.
- Repoint the public links, then check the old addresses return a useful page rather than an error.
- Record the time taken for each step, and set the real cutover window from the slowest step plus a margin the migration lead can defend.
Questions migration leads ask
What about customers who bookmarked the old portal?
Keep the old addresses redirecting to the matching page in the new portal, and do not redirect them to the home page, because that forces a second search. Where a page has no equivalent, show a short message that explains what replaced it, and link to the new route for the same task.
How do we move open cases from the old system?
Move open cases with their status, owner and latest public note, and leave closed history in the old system with a read-only link. Moving every historical note creates noise and a larger reconciliation task, and customers rarely need it to finish a current request.
Can a customer use both portals during the overlap?
They can, which is why the overlap needs a rule. Each open request should have exactly one home, and the old portal should stop accepting new submissions for any customer once that customer has been moved. A customer who submits in both places creates duplicates that agents must untangle by hand.
How do we know reconciliation is finished?
When the counts match for each record type, a random sample of records has been checked against the source, and the exceptions list is small enough that each item has a named owner and a decision. Reconciliation that never reaches a stated end point can continue for months as a background task.
The data side of this work is covered in data migration validation and cutover, and migration reconciliation controls covers the count checks in more detail. For the integration side of cutover, integration cutover readiness is the next read. If customer self-service portal raises a question these pages do not settle, ask through the contact page. The testing and acceptance checklist is where to check the rehearsal evidence an acceptance review is likely to ask for.
Frequently asked questions
Should we migrate all historical data to the new portal?
Not necessarily. Migrate recent data that customers might reference (last two years is typical). Archive older data separately if needed for compliance but do not clutter the new system with years of old requests.
How long should the old portal stay available after cutover?
Plan for a parallel operation period. This allows customers to familiarize themselves with the new portal while still having the old one as a safety net. After the transition period, archive the old system.
What is the biggest adoption barrier?
Users cannot find what they need or do not understand how to do it. Invest in clear interface design and training. Early support is more important than advanced features.
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