Create your custom Quick Create VM gallery

First published on TECHNET on Nov 08, 2017

Have you ever wondered whether it is possible to add your own custom images to the list of available VMs for

Quick Create


The answer is: Yes, you can!

Since quite a few people have been asking us, this post will give you a quick example to get started and add your own custom image while we're working on the official documentation. The following two steps will be described in this blog post:

  1. Create JSON document describing your image
  2. Add this JSON document to the list of galleries to include


Step 1: Create JSON document describing your image

The first thing you will need is a JSON document which describes the image you want to have showing up in quick create. The following snippet is a sample JSON document which you can adapt to your own needs. We will publish more documentation on this including a JSON schema to run validation as soon as it is ready.

To calculate the SHA256 hashes for the linked files you can use different tools. Since it is already available on Windows 10 machines, I like to use a quick PowerShell call:

Get-FileHash -Path .contoso_logo.png -Algorithm SHA256

The values for




, and


are optional, so if there are no images at hand, you can just remove these values from the JSON document.

Step 2: Add this JSON document to the list of galleries to include

To have your custom gallery image show up on a Windows 10 client, you need to set the


registry value under

HKEY_LOCAL_MACHINESOFTWAREMicrosoftWindows NTCurrentVersionVirtualization


There are multiple ways to achieve this, you can adapt the following PowerShell snippet to set the value:

If you don't want to include the official Windows 10 developer evaluation images, just remove the fwlink from the GalleryLocations value.

Have fun creating your own galleries and stay tuned for our official documentation. We're looking forward to see what you create!


Update: The official documentation is now live as well — for more detail on the gallery functionality and create your own gallery: This way please:

Create a custom
virtual machine gallery


This article was originally published by Microsoft's Virtualization Blog. You can find the original article here.