Phase 1: Basic SDK, Event, and Property migration

Update your SDK, event, and property implementations while migrating from Segment to RudderStack.

RudderStack provides a wide range of SDKs for different platforms, including JavaScript, iOS, Android, and server-side languages like Node.js, Python, and Ruby.

This guide covers the process of updating your SDK, events, and properties implementation for web, mobile, and server while migrating from Segment to RudderStack.

JavaScript SDK

  1. Install the RudderStack JavaScript SDK by including the following script in thesection of your website:
<script type="text/javascript">
  !function(){"use strict";window.RudderSnippetVersion="3.0.3";var sdkBaseUrl=""
  ;var sdkName="rsa.min.js";var asyncScript=true;window.rudderAnalyticsBuildType="legacy",window.rudderanalytics=[]
  ;var e=["setDefaultInstanceKey","load","ready","page","track","identify","alias","group","reset","setAnonymousId","startSession","endSession","consent"]
  ;for(var n=0;n<e.length;n++){var t=e[n];window.rudderanalytics[t]=function(e){return function(){
  new Function('return import("")'),window.rudderAnalyticsBuildType="modern"}catch(a){}
  "undefined"==typeof globalThis&&(Object.defineProperty(Object.prototype,"__globalThis_magic__",{get:function get(){
  return this},configurable:true}),__globalThis_magic__.globalThis=__globalThis_magic__,
  delete Object.prototype.__globalThis_magic__);var e=document.createElement("script")
  },"undefined"==typeof Promise||"undefined"==typeof globalThis){var d=document.createElement("script")
  1. Update your page, track, and identify calls to use the RudderStack SDK. RudderStack and Segment calls are nearly identical. Here are a few examples:
  1. After implementing your calls, verify that the data flows correctly by checking the Live Events tab in your RudderStack dashboard. You should see events appearing in real time as users interact with your website.

iOS/Android SDK

The native iOS or Android SDK implementations can be migrated similarly and the calls will be very similar to Segment as well.

Example for iOS

  1. Install the RudderStack iOS SDK as follows:
  1. Implement identify and track calls in your app as below:
  1. Verify the data flow by checking the Live Events tab in your RudderStack dashboard.
See the RudderStack Android SDK and iOS SDK documentation for detailed implementation and examples.

Server-side SDKs

RudderStack supports eight different server-side SDKs that can be implemented similarly to Segment.

Example for Node.js

  1. Install the RudderStack Node.js SDK using npm:
npm install @rudderstack/rudder-sdk-node
  1. Import and initialize the SDK in your Node.js app:
const RudderAnalytics = require('@rudderstack/rudder-sdk-node');

const client = new RudderAnalytics(WRITE_KEY, {
  dataPlaneUrl: DATA_PLANE_URL, // default:

  // More initialization options
  1. Implement identify and track calls in your server-side code:
  1. Verify the data flow by checking the Live Events tab in your RudderStack dashboard.

Historical data imports

If you have a significant amount of historical data in your Segment warehouse and you are moving warehouses, you should migrate your historical Segment data into your new warehouse (Snowflake, BigQuery, Databricks, etc.) using your preferred ETL tool.

Once data is in your new data warehouse, you can combine SQL tables for a unified historical view of your customer data.

If you are not changing data warehouses, you don’t need to set up pipelines.

Migrate user traits and event properties

When migrating from Segment to RudderStack, follow these steps to ensure that all your custom user traits and event properties are properly mapped and migrated:

  1. Identify the key user traits and event properties that you want to migrate from Segment to RudderStack. The easiest way to do this is to set up Segment as a source in a RudderStack Tracking Plan.

  2. Create new events in the RudderStack Data Catalog:

Add new event
  1. Update your RudderStack SDK implementation to use the mapped trait and property names, ensuring your data is correctly structured and labeled in RudderStack.
  2. If you have any downstream destinations or data, consumers that rely on the Segment trait and property names, update their configurations to use the new RudderStack names.
  3. Verify that your user traits and event properties are correctly captured and forwarded by RudderStack by inspecting your live events stream and destination data.

By carefully mapping and migrating your user traits and event properties, you can maintain data consistency and ensure that your downstream systems continue to function as expected.

Handle custom events and mappings

If your Segment implementation includes custom events or mappings, you can set up Segment as a RudderStack source to import your existing mappings into a RudderStack tracking plan and manage them in the RudderStack data catalog. Otherwise, you must recreate your schema in RudderStack to ensure a seamless migration by following these steps:

  1. Identify any custom events or mappings in your Segment implementation like custom page or screen events, e-commerce events, or user attribute mappings.
  2. For each custom event, create an equivalent event in RudderStack using the track method and the appropriate event name and properties. For example:
// Segment

analytics.track("Custom Event Name", {
  property1: "value1",
  property2: "value2"

// RudderStack 

rudderanalytics.track("Custom Event Name", {
  property1: "value1",
  property2: "value2"
  1. If you have any custom mappings or transformations in Segment like user attribute synchronization or event property renaming, implement them in RudderStack using the JavaScript SDK’s identify and track methods or by leveraging RudderStack’s server-side transformations.
  2. Test your custom events and mappings thoroughly to ensure that they are being correctly captured and processed by RudderStack.
  3. Update any downstream systems or integrations that rely on the custom events or mappings to use the new RudderStack event names and property structures.

By handling custom events and mappings during the migration process, you can ensure that your data remains consistent and actionable across your entire stack.

Next steps

Phase 2: Advanced migration techniques

Questions? Contact us by email or on Slack