Plan an Appcues to Userorbit migration for product tours, checklists, banners, surveys, launchpads, targeting, and onboarding analytics.
Appcues migration works best as an audit-and-rebuild project. Export what Appcues makes available, document the experience rules that do not transfer cleanly, then recreate the journeys that still drive activation.
Appcues is a mature product adoption platform, so do not treat migration like a simple text import. Appcues supports analytics CSV exports, localization exports, and API access for some data, but teams should not assume there is a single self-serve export that recreates every flow, checklist, launchpad, segment, style, goal, and publishing rule in another platform.
Use this checklist to move from Appcues to Userorbit without copying stale onboarding debt.
1. Inventory your Appcues workspace
List every active and recently used Appcues object:
Flows, modals, slideouts, tooltips, and hotspots
Checklists
Launchpads and resource-style entry points
Pins, banners, and embedded experiences
NPS surveys and forms
Segments, goals, events, user properties, and group properties
Custom styling, custom CSS, integrations, and environments
For each item, mark it as keep, rewrite, merge, archive, or defer.
2. Export the data Appcues makes available
Before rebuilding anything, preserve the records you may need later:
Flow or experience analytics CSVs
Survey response exports
Localization CSV or JSON files, if you use translated flows
Historical event data through API or raw event access, if your Appcues plan supports it
Keep those files as the historical record for Appcues performance. Userorbit should become the forward-looking system after the cutover date.
3. Capture non-exportable configuration
Some migration work is about documenting behavior, not exporting files. Capture:
Screenshots of every flow step and checklist state
Page and URL targeting rules
Event triggers and activation conditions
Segment logic, user properties, and account properties
Frequency, dismiss, and recurrence settings
Goal definitions and success events
Custom CSS, custom HTML, and brand styling
Integration dependencies
This prevents teams from rebuilding a flow that looks right but behaves differently.
4. Map Appcues objects to Userorbit
Use this mapping as the starting point:
| Appcues object | Userorbit destination |
|---|---|
| Flows | Product Tours |
| Tooltips, hotspots, pins | Tour steps, pointers, beacons, or contextual guides |
| Checklists | Checklists |
| Banners | Announcements |
| NPS surveys and forms | Surveys and feedback workflows |
| Launchpads | Widget, help content, or resource-style modules |
| Segments | Contacts, attributes, and targeting |
| Goals and events | Analytics events and conversion goals |
| Help/resource patterns | Help Center or in-app help surfaces |
Do not migrate every old Appcues experience blindly. Start with journeys that still support activation, adoption, expansion, or support deflection.
5. Rebuild the highest-value journeys first
Prioritize:
New-user activation flows
Checklists tied to first value
High-traffic feature adoption prompts
Current release announcements
Surveys or feedback prompts tied to product decisions
If a checklist has grown beyond the few tasks users actually need, simplify it during migration. A shorter checklist is often a better migration outcome than a perfect copy.
6. Install and test Userorbit alongside Appcues
In staging or a limited production segment:
Install the Userorbit widget or SDK
Identify contacts and companies
Pass the user and account traits needed for targeting
Recreate the core events used by onboarding and checklist completion
Confirm that Userorbit experiences trigger only for the intended audience
You can run Appcues and Userorbit during the transition, but avoid showing duplicate tours, banners, surveys, or checklists to the same users.
7. QA before cutover
Test the migration by:
Role, plan, lifecycle stage, and account type
New user, activated user, and returning user states
Empty-state routes and key feature pages
Single-page app route changes
Frequency, dismiss, and completion behavior
Responsive layouts and narrow screens
Analytics events and checklist completion tracking
Ask one person outside the migration project to complete the flow as a new user. They will catch copy and sequencing issues that source-platform screenshots do not reveal.
8. Cut over gradually
Use a phased rollout:
Internal users
A small customer segment
New users only
Broader production rollout
Disable overlapping Appcues experiences before enabling the Userorbit equivalents for the same audience.
9. Remove Appcues after verification
Before removing Appcues:
Confirm no active Appcues flows, checklists, banners, or surveys are still needed
Confirm no production code still depends on
Appcues.identify,Appcues.group,Appcues.page, orAppcues.trackConfirm analytics, goals, and checklist completion tracking are stable in Userorbit
Keep exported Appcues analytics for historical reference
Common questions
Can I export everything from Appcues automatically?
Not usually as a complete rebuildable package. Appcues has analytics exports, localization exports, and API access for some data, but targeting, styling, flow behavior, and publishing logic still need review.
Will historical Appcues analytics become Userorbit analytics?
Treat Appcues exports as historical records. Recreate goals and dashboards in Userorbit from the cutover date forward.
Can we migrate without engineering?
Many content updates are no-code, but SDK installation, identity, account traits, event tracking, and removing old Appcues calls usually need engineering review.
Should every Appcues flow move over?
No. Migration is a good time to retire stale prompts, merge duplicate flows, and rebuild only the experiences that still help users reach value.
Need more help? Compare Appcues and Userorbit, book a demo, or contact our support team.