{"id":8095,"date":"2017-03-17T09:42:21","date_gmt":"2017-03-17T16:42:21","guid":{"rendered":"http:\/\/blog.mozilla.org\/addons\/?p=8095"},"modified":"2017-04-04T08:55:08","modified_gmt":"2017-04-04T15:55:08","slug":"migrating-webextensions-dont-forget-users","status":"publish","type":"post","link":"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/","title":{"rendered":"Migrating to WebExtensions? Don\u2019t Forget Your Users"},"content":{"rendered":"<div id=\"attachment_8096\" style=\"width: 262px\" class=\"wp-caption alignleft\"><img aria-describedby=\"caption-attachment-8096\" decoding=\"async\" loading=\"lazy\" class=\"size-medium wp-image-8096\" src=\"https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/stranded-252x188.png\" alt=\"\" width=\"252\" height=\"188\" srcset=\"https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/stranded-252x188.png 252w, https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/stranded.png 583w\" sizes=\"(max-width: 252px) 100vw, 252px\" \/><p id=\"caption-attachment-8096\" class=\"wp-caption-text\">Stranded users feel sadness.<\/p><\/div>\n<p>If you&#8217;re the developer of a legacy add-on with an aim to migrate to <a href=\"https:\/\/developer.mozilla.org\/Add-ons\/WebExtensions\" target=\"_blank\">WebExtensions<\/a>, here are a few tips to consider so your users aren&#8217;t left behind.<\/p>\n<h2>Port your user data<\/h2>\n<p>If your legacy add-on stores user data, we encourage you to take advantage of <a href=\"https:\/\/developer.mozilla.org\/Add-ons\/WebExtensions\/Embedded_WebExtensions\" target=\"_blank\">Embedded WebExtensions<\/a> to transfer the data to a format that can be used by WebExtensions. This is critical if you want to seamlessly migrate your users\u2014without putting any actionable burden on them\u2014to the new WebExtensions version when it&#8217;s ready. (Embedded WebExtensions is a framework that contains your WebExtension inside of a bootstrapped or SDK extension.)<\/p>\n<h2>Testing beta versions<\/h2>\n<p>If you want to test a WebExtensions version of your add-on with a smaller group of users, you can make use of the <a href=\"https:\/\/developer.mozilla.org\/Add-ons\/Distribution#Beta_versions\" target=\"_blank\">beta versions<\/a> feature on <a href=\"https:\/\/addons.mozilla.org\" target=\"_blank\">addons.mozilla.org<\/a> (AMO). This lets you test pre-release beta versions that are signed and available to Firefox users who want to give them a spin. You&#8217;ll benefit from real users interacting with your new version and providing valuable feedback\u2014without sacrificing the good reputation and rating of your listed version. We don&#8217;t recommend creating a separate listing on release because this will fragment your user base and leave a large number of them behind when <a href=\"https:\/\/wiki.mozilla.org\/RapidRelease\/Calendar\" target=\"_blank\">Firefox 57<\/a> is released.<\/p>\n<h2>Don\u2019t leave your users behind<\/h2>\n<p>Updating your listing on AMO when your WebExtension is ready is the only way to ensure all of your users move over without any noticeable interruption.<\/p>\n<p>Need further assistance with your migration journey? You can find real-time help during <a href=\"https:\/\/blog.mozilla.org\/addons\/2017\/03\/09\/office-hours-support-transitioning-porting-webextensions\/\" target=\"_blank\">office hours<\/a>, or by emailing <strong>webextensions-support [@] mozilla [dot] org<\/strong>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>If you&#8217;re the developer of a legacy add-on with an aim to migrate to WebExtensions, here are a few tips to consider so your users aren&#8217;t left behind. Port your &hellip; <a class=\"go\" href=\"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/\">Read more<\/a><\/p>\n","protected":false},"author":648,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[44,278886],"tags":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v22.5 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Migrating to WebExtensions? Don\u2019t Forget Your Users - Mozilla Add-ons Community Blog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Scott DeVaney\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/\",\"url\":\"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/\",\"name\":\"Migrating to WebExtensions? Don\u2019t Forget Your Users - Mozilla Add-ons Community Blog\",\"isPartOf\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/stranded-252x188.png\",\"datePublished\":\"2017-03-17T16:42:21+00:00\",\"dateModified\":\"2017-04-04T15:55:08+00:00\",\"author\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/4c2e23c8fee2460a91031d2825ff7d35\"},\"breadcrumb\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/#primaryimage\",\"url\":\"https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/stranded.png\",\"contentUrl\":\"https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/stranded.png\",\"width\":583,\"height\":435,\"caption\":\"Stranded users feel sadness.\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/blog.mozilla.org\/addons\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Migrating to WebExtensions? Don\u2019t Forget Your Users\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#website\",\"url\":\"https:\/\/blog.mozilla.org\/addons\/\",\"name\":\"Mozilla Add-ons Community Blog\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/blog.mozilla.org\/addons\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/4c2e23c8fee2460a91031d2825ff7d35\",\"name\":\"Scott DeVaney\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/dc38a62432c7d12585390805c2bc58e2?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/dc38a62432c7d12585390805c2bc58e2?s=96&d=mm&r=g\",\"caption\":\"Scott DeVaney\"},\"url\":\"https:\/\/blog.mozilla.org\/addons\/author\/sdevaneymozilla-com\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Migrating to WebExtensions? Don\u2019t Forget Your Users - Mozilla Add-ons Community Blog","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:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/","twitter_misc":{"Written by":"Scott DeVaney","Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/","url":"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/","name":"Migrating to WebExtensions? Don\u2019t Forget Your Users - Mozilla Add-ons Community Blog","isPartOf":{"@id":"https:\/\/blog.mozilla.org\/addons\/#website"},"primaryImageOfPage":{"@id":"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/#primaryimage"},"image":{"@id":"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/#primaryimage"},"thumbnailUrl":"https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/stranded-252x188.png","datePublished":"2017-03-17T16:42:21+00:00","dateModified":"2017-04-04T15:55:08+00:00","author":{"@id":"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/4c2e23c8fee2460a91031d2825ff7d35"},"breadcrumb":{"@id":"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/#primaryimage","url":"https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/stranded.png","contentUrl":"https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/stranded.png","width":583,"height":435,"caption":"Stranded users feel sadness."},{"@type":"BreadcrumbList","@id":"https:\/\/blog.mozilla.org\/addons\/2017\/03\/17\/migrating-webextensions-dont-forget-users\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/blog.mozilla.org\/addons\/"},{"@type":"ListItem","position":2,"name":"Migrating to WebExtensions? Don\u2019t Forget Your Users"}]},{"@type":"WebSite","@id":"https:\/\/blog.mozilla.org\/addons\/#website","url":"https:\/\/blog.mozilla.org\/addons\/","name":"Mozilla Add-ons Community Blog","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/blog.mozilla.org\/addons\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/4c2e23c8fee2460a91031d2825ff7d35","name":"Scott DeVaney","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/dc38a62432c7d12585390805c2bc58e2?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/dc38a62432c7d12585390805c2bc58e2?s=96&d=mm&r=g","caption":"Scott DeVaney"},"url":"https:\/\/blog.mozilla.org\/addons\/author\/sdevaneymozilla-com\/"}]}},"_links":{"self":[{"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/posts\/8095"}],"collection":[{"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/users\/648"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/comments?post=8095"}],"version-history":[{"count":0,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/posts\/8095\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/media?parent=8095"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/categories?post=8095"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/tags?post=8095"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}