{"id":3594,"date":"2026-01-14T06:31:06","date_gmt":"2026-01-14T06:31:06","guid":{"rendered":"https:\/\/vwo.com\/product-updates\/?p=3594"},"modified":"2026-01-14T06:38:31","modified_gmt":"2026-01-14T06:38:31","slug":"introducing-user-aliasing-for-seamless-identity-management","status":"publish","type":"post","link":"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/","title":{"rendered":"Introducing user aliasing for seamless identity management"},"content":{"rendered":"\n<p>We are excited to announce User Aliasing, a new feature designed to eliminate the headache of managing temporary user IDs and ensure a consistent experience for all your users.<\/p>\n\n\n\n<p>Previously, when a user hadn&#8217;t logged in, our FE SDKs required you to generate a random temporary ID for them to ensure a consistent experience. This meant you had to persist that random ID even after the user logged in and a genuine ID was available, creating an unnecessary burden on your development team.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">The solution: User Aliasing<\/h2>\n\n\n\n<p>With User Aliasing, we remove this friction. Your team can now:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Use a random temporary ID (the `aliasId`) for anonymous users before they log in.<\/li>\n\n\n\n<li>Once the user logs in and their actual userId is available, simply call our new method to map the two IDs together.<\/li>\n<\/ol>\n\n\n\n<p>This simple mapping ensures that no matter which ID is used after login, the temporary one or the actual one, the user will get the exact same experiment variation decision as before.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Benefits<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Consistent Experience:<\/strong> Ensure a seamless and uninterrupted experience for your users as they transition from anonymous to logged-in states.<\/li>\n\n\n\n<li><strong>Accurate Reporting:<\/strong> VWO reports will recognize the temporary ID and the permanent ID as the same user, leading to cleaner, more reliable data and metrics.<\/li>\n\n\n\n<li><strong>Reduced Development Effort:<\/strong> No need for complex logic to manage and persist temporary IDs across sessions.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Crucial requirement- Gateway service<\/h2>\n\n\n\n<p>The Gateway Service is required to use User Aliasing. The Aliasing API (like setAlias()) depends on Gateway endpoint logic to reconcile multiple user IDs reliably.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How it works&nbsp;<\/h2>\n\n\n\n<p>To enable this feature, simply pass the <strong>`isAliasingEnabled`<\/strong> flag during SDK initialization:<\/p>\n\n\n\n<p>Javascript<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>vwoClient = await init({\n&nbsp;&nbsp;accountId: '123456',\n&nbsp;&nbsp;sdkKey: '32-alpha-numeric-sdk-key',\n&nbsp;&nbsp;gatewayService: {\n&nbsp;&nbsp;&nbsp;&nbsp;url: 'http:\/\/your-custom-gateway-url',\n&nbsp;&nbsp;},\n&nbsp;&nbsp;\/\/ Required to use Aliasing\n&nbsp;&nbsp;isAliasingEnabled: true,\n});<\/code><\/pre>\n\n\n\n<p>Once the user has logged in, and their actual userId is available, call the <strong>setAlias()<\/strong> method to do the mapping.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>vwoClient.setAlias(userContext, 'aliasId');<\/code><\/pre>\n\n\n\n<p>That&#8217;s it! User Aliasing takes care of the rest, ensuring your users are consistently bucketed and accurately reported.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Get started with user aliasing today<\/h2>\n\n\n\n<p>User Aliasing is now available in the latest Mobile and server-side SDKs. Upgrade your SDK to the <a href=\"https:\/\/developers.vwo.com\/v2\/docs\/fme-history-of-changes-that-went-live\">latest version<\/a> if you haven\u2019t already, and start delivering consistent experiment experiences across your mobile app. Also, feel free to <a href=\"https:\/\/vwo.com\/demo\/\">book a demo<\/a> to understand this feature from our product experts.\u00a0\u00a0<\/p>\n","protected":false},"excerpt":{"rendered":"<p>We are excited to announce User Aliasing, a new feature designed to eliminate the headache of managing temporary user IDs and ensure a consistent experience for all your users. Previously, when a user hadn&#8217;t logged in, our FE SDKs required you to generate a random temporary ID for them to ensure a consistent experience. This&#8230;<\/p>\n","protected":false},"author":491,"featured_media":3595,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[62],"tags":[34,67],"feature":[64],"industry-type":[],"class_list":["post-3594","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-vwo-feature-experimentation","tag-feature-experimentation","tag-user-aliasing","feature-feature-experimentation"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v26.9 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Introducing user aliasing for seamless identity management | VWO Product Updates<\/title>\n<meta name=\"description\" content=\"Discover the User Aliasing feature that eliminates temporary ID management hassles. Map anonymous and logged-in user IDs seamlessly for consistent experiment variations and accurate reporting.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Introducing user aliasing for seamless identity management | VWO Product Updates\" \/>\n<meta property=\"og:description\" content=\"Discover the User Aliasing feature that eliminates temporary ID management hassles. Map anonymous and logged-in user IDs seamlessly for consistent experiment variations and accurate reporting.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/\" \/>\n<meta property=\"og:site_name\" content=\"VWO Product Updates\" \/>\n<meta property=\"article:published_time\" content=\"2026-01-14T06:31:06+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-01-14T06:38:31+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/static.wingify.com\/gcp\/uploads\/sites\/13\/2026\/01\/OG-image_Introducing-user-aliasing-in-VWO-Mobile-SDKs.png\" \/>\n\t<meta property=\"og:image:width\" content=\"2400\" \/>\n\t<meta property=\"og:image:height\" content=\"1260\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Ajit Singh\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/\"},\"author\":{\"name\":\"Ajit Singh\",\"@id\":\"https:\/\/vwo.com\/product-updates\/#\/schema\/person\/cf45f1a20c019cb485c4eb30985d5734\"},\"headline\":\"Introducing user aliasing for seamless identity management\",\"datePublished\":\"2026-01-14T06:31:06+00:00\",\"dateModified\":\"2026-01-14T06:38:31+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/\"},\"wordCount\":375,\"commentCount\":0,\"image\":{\"@id\":\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/static.wingify.com\/gcp\/uploads\/sites\/13\/2026\/01\/OG-image_Introducing-user-aliasing-in-VWO-Mobile-SDKs.png\",\"keywords\":[\"Feature Experimentation\",\"user aliasing\"],\"articleSection\":[\"VWO Feature Experimentation\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/\",\"url\":\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/\",\"name\":\"Introducing user aliasing for seamless identity management | VWO Product Updates\",\"isPartOf\":{\"@id\":\"https:\/\/vwo.com\/product-updates\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/static.wingify.com\/gcp\/uploads\/sites\/13\/2026\/01\/OG-image_Introducing-user-aliasing-in-VWO-Mobile-SDKs.png\",\"datePublished\":\"2026-01-14T06:31:06+00:00\",\"dateModified\":\"2026-01-14T06:38:31+00:00\",\"author\":{\"@id\":\"https:\/\/vwo.com\/product-updates\/#\/schema\/person\/cf45f1a20c019cb485c4eb30985d5734\"},\"description\":\"Discover the User Aliasing feature that eliminates temporary ID management hassles. Map anonymous and logged-in user IDs seamlessly for consistent experiment variations and accurate reporting.\",\"breadcrumb\":{\"@id\":\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#primaryimage\",\"url\":\"https:\/\/static.wingify.com\/gcp\/uploads\/sites\/13\/2026\/01\/OG-image_Introducing-user-aliasing-in-VWO-Mobile-SDKs.png\",\"contentUrl\":\"https:\/\/static.wingify.com\/gcp\/uploads\/sites\/13\/2026\/01\/OG-image_Introducing-user-aliasing-in-VWO-Mobile-SDKs.png\",\"width\":2400,\"height\":1260,\"caption\":\"Og Image Introducing User Aliasing In Vwo Mobile Sdks\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/vwo.com\/product-updates\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Introducing user aliasing for seamless identity management\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/vwo.com\/product-updates\/#website\",\"url\":\"https:\/\/vwo.com\/product-updates\/\",\"name\":\"VWO Product Updates\",\"description\":\"Just another VWO site\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/vwo.com\/product-updates\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/vwo.com\/product-updates\/#\/schema\/person\/cf45f1a20c019cb485c4eb30985d5734\",\"name\":\"Ajit Singh\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/vwo.com\/product-updates\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/static.wingify.com\/gcp\/uploads\/sites\/13\/2025\/12\/ajit.jpg\",\"contentUrl\":\"https:\/\/static.wingify.com\/gcp\/uploads\/sites\/13\/2025\/12\/ajit.jpg\",\"caption\":\"Ajit Singh\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Introducing user aliasing for seamless identity management | VWO Product Updates","description":"Discover the User Aliasing feature that eliminates temporary ID management hassles. Map anonymous and logged-in user IDs seamlessly for consistent experiment variations and accurate reporting.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/","og_locale":"en_US","og_type":"article","og_title":"Introducing user aliasing for seamless identity management | VWO Product Updates","og_description":"Discover the User Aliasing feature that eliminates temporary ID management hassles. Map anonymous and logged-in user IDs seamlessly for consistent experiment variations and accurate reporting.","og_url":"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/","og_site_name":"VWO Product Updates","article_published_time":"2026-01-14T06:31:06+00:00","article_modified_time":"2026-01-14T06:38:31+00:00","og_image":[{"width":2400,"height":1260,"url":"https:\/\/static.wingify.com\/gcp\/uploads\/sites\/13\/2026\/01\/OG-image_Introducing-user-aliasing-in-VWO-Mobile-SDKs.png","type":"image\/png"}],"author":"Ajit Singh","twitter_card":"summary_large_image","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#article","isPartOf":{"@id":"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/"},"author":{"name":"Ajit Singh","@id":"https:\/\/vwo.com\/product-updates\/#\/schema\/person\/cf45f1a20c019cb485c4eb30985d5734"},"headline":"Introducing user aliasing for seamless identity management","datePublished":"2026-01-14T06:31:06+00:00","dateModified":"2026-01-14T06:38:31+00:00","mainEntityOfPage":{"@id":"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/"},"wordCount":375,"commentCount":0,"image":{"@id":"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#primaryimage"},"thumbnailUrl":"https:\/\/static.wingify.com\/gcp\/uploads\/sites\/13\/2026\/01\/OG-image_Introducing-user-aliasing-in-VWO-Mobile-SDKs.png","keywords":["Feature Experimentation","user aliasing"],"articleSection":["VWO Feature Experimentation"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/","url":"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/","name":"Introducing user aliasing for seamless identity management | VWO Product Updates","isPartOf":{"@id":"https:\/\/vwo.com\/product-updates\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#primaryimage"},"image":{"@id":"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#primaryimage"},"thumbnailUrl":"https:\/\/static.wingify.com\/gcp\/uploads\/sites\/13\/2026\/01\/OG-image_Introducing-user-aliasing-in-VWO-Mobile-SDKs.png","datePublished":"2026-01-14T06:31:06+00:00","dateModified":"2026-01-14T06:38:31+00:00","author":{"@id":"https:\/\/vwo.com\/product-updates\/#\/schema\/person\/cf45f1a20c019cb485c4eb30985d5734"},"description":"Discover the User Aliasing feature that eliminates temporary ID management hassles. Map anonymous and logged-in user IDs seamlessly for consistent experiment variations and accurate reporting.","breadcrumb":{"@id":"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#primaryimage","url":"https:\/\/static.wingify.com\/gcp\/uploads\/sites\/13\/2026\/01\/OG-image_Introducing-user-aliasing-in-VWO-Mobile-SDKs.png","contentUrl":"https:\/\/static.wingify.com\/gcp\/uploads\/sites\/13\/2026\/01\/OG-image_Introducing-user-aliasing-in-VWO-Mobile-SDKs.png","width":2400,"height":1260,"caption":"Og Image Introducing User Aliasing In Vwo Mobile Sdks"},{"@type":"BreadcrumbList","@id":"https:\/\/vwo.com\/product-updates\/introducing-user-aliasing-for-seamless-identity-management\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vwo.com\/product-updates\/"},{"@type":"ListItem","position":2,"name":"Introducing user aliasing for seamless identity management"}]},{"@type":"WebSite","@id":"https:\/\/vwo.com\/product-updates\/#website","url":"https:\/\/vwo.com\/product-updates\/","name":"VWO Product Updates","description":"Just another VWO site","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vwo.com\/product-updates\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/vwo.com\/product-updates\/#\/schema\/person\/cf45f1a20c019cb485c4eb30985d5734","name":"Ajit Singh","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vwo.com\/product-updates\/#\/schema\/person\/image\/","url":"https:\/\/static.wingify.com\/gcp\/uploads\/sites\/13\/2025\/12\/ajit.jpg","contentUrl":"https:\/\/static.wingify.com\/gcp\/uploads\/sites\/13\/2025\/12\/ajit.jpg","caption":"Ajit Singh"}}]}},"_links":{"self":[{"href":"https:\/\/vwo.com\/product-updates\/wp-json\/wp\/v2\/posts\/3594","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vwo.com\/product-updates\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/vwo.com\/product-updates\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/vwo.com\/product-updates\/wp-json\/wp\/v2\/users\/491"}],"replies":[{"embeddable":true,"href":"https:\/\/vwo.com\/product-updates\/wp-json\/wp\/v2\/comments?post=3594"}],"version-history":[{"count":2,"href":"https:\/\/vwo.com\/product-updates\/wp-json\/wp\/v2\/posts\/3594\/revisions"}],"predecessor-version":[{"id":3598,"href":"https:\/\/vwo.com\/product-updates\/wp-json\/wp\/v2\/posts\/3594\/revisions\/3598"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vwo.com\/product-updates\/wp-json\/wp\/v2\/media\/3595"}],"wp:attachment":[{"href":"https:\/\/vwo.com\/product-updates\/wp-json\/wp\/v2\/media?parent=3594"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/vwo.com\/product-updates\/wp-json\/wp\/v2\/categories?post=3594"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/vwo.com\/product-updates\/wp-json\/wp\/v2\/tags?post=3594"},{"taxonomy":"feature","embeddable":true,"href":"https:\/\/vwo.com\/product-updates\/wp-json\/wp\/v2\/feature?post=3594"},{"taxonomy":"industry-type","embeddable":true,"href":"https:\/\/vwo.com\/product-updates\/wp-json\/wp\/v2\/industry-type?post=3594"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}