{"id":20235,"date":"2018-12-07T08:30:59","date_gmt":"2018-12-07T16:30:59","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/visualstudio\/?p=20235"},"modified":"2019-02-14T15:23:18","modified_gmt":"2019-02-14T23:23:18","slug":"new-preview-label-for-visual-studio-extensions-2","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/visualstudio\/new-preview-label-for-visual-studio-extensions-2\/","title":{"rendered":"New Preview label for Visual Studio extensions"},"content":{"rendered":"<p>Visual Studio extensions can now be marked with a Preview label which is shown very clearly on the Visual Studio Marketplace. This gives your customers clear expectations that this version could contain issues as you are actively developing new features. You can get feedback from your users earlier, test out new code changes to improve your extension, and continue to provide a stable version for your users that may require it.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/4\/2019\/02\/marketplace-page.png\" target=\"_blank\" rel=\"noopener\"><img decoding=\"async\" class=\"alignnone size-full wp-image-20265\" src=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/4\/2019\/02\/marketplace-page.png\" alt=\"\" width=\"1149\" height=\"312\" \/><\/a><\/p>\n<p>Determining the quality of an extension is today an exercise left to the extension user. If an extension isn\u2019t recommended by a friend, coworker or other trusted person, all we can do is to look at the number of downloads, the star rating, and reviews to determine if we perceive the quality to be high enough for us to try out the extension.<\/p>\n<p>The new preview label explicitly communicates some important details to the consumer about what to expect from the extension. This helps them to understand that the extension may not be feature complete and may contain bugs. It can also help to communicate to them that feedback is welcome to improve the extension before its final release and the preview label removed.<\/p>\n<p>If the version of your extension is less than one (i.e. v0.5) then it will likely benefit from adding the preview label.<\/p>\n<h2>Add the preview label<\/h2>\n<p>In your extension\u2019s .vsixmanifest file, add the new &lt;Preview&gt; element to the &lt;Metadata&gt; node.<\/p>\n<pre title=\"Add Preview node to vsixmanifest\" class=\"lang:xaml decode:true\">&lt;Metadata&gt;\r\n  &lt;Identity Id=\"[guid]\" Version=\"0.8\" Language=\"en-US\" Publisher=\"My name\" \/&gt;\r\n  &lt;DisplayName&gt;Extension name&lt;\/DisplayName&gt;\r\n  &lt;Description&gt;Extension description.&lt;\/Description&gt;\r\n  &lt;Icon&gt;Resources\\Icon.png&lt;\/Icon&gt;\r\n  &lt;Preview&gt;true&lt;\/Preview&gt;\r\n&lt;\/Metadata&gt;<\/pre>\n<p>Now upload your extension to the <a href=\"https:\/\/marketplace.visualstudio.com\/items?itemName=MadsKristensen.PkgdefLanguage\" target=\"_blank\" rel=\"noopener\">Visual Studio Marketplace<\/a> to see the new preview label show up. If your extension isn\u2019t uploaded but referenced by a link, then there is a checkbox you can check to add the preview label when you edit your linked extension on the Marketplace.<\/p>\n<p>It\u2019s important to note that the extension will not change behavior in any way due to the addition of the preview label.<\/p>\n<h2>Try it out<\/h2>\n<p>If you have any applicable extensions, then use the preview label to better communicate the right expectations to your users and get a better chance at higher ratings.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Visual Studio extensions can now be marked with a Preview label which is shown very clearly on the Visual Studio Marketplace. This gives your customers clear expectations that this version could contain issues as you are actively developing new features. Learn how to enable the Preview label here.<\/p>\n","protected":false},"author":642,"featured_media":222783,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1388,155],"tags":[294,634,156,475],"class_list":["post-20235","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-extensibility","category-visual-studio","tag-extensions","tag-preview","tag-visual-studio-2017","tag-visual-studio-2019"],"acf":[],"blog_post_summary":"<p>Visual Studio extensions can now be marked with a Preview label which is shown very clearly on the Visual Studio Marketplace. This gives your customers clear expectations that this version could contain issues as you are actively developing new features. Learn how to enable the Preview label here.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/posts\/20235","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/users\/642"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/comments?post=20235"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/posts\/20235\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/media\/222783"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/media?parent=20235"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/categories?post=20235"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/tags?post=20235"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}