Virtual labs generally require some development assistance from the Spaces Learning team or other developers. For each lab, you can follow a three-step process:

  1. Document lab content and requirements.
  2. Create a resource for the virtual lab.
  3. Create a lab guide with the "How to Create a Lab Guide" document and the My Content tool in Spaces Learning Composer.



(Click image to preview this activity type)


Refer to each section below for step-by-step guidance.



Step 1: Document Lab Requirements

First, you need to document instructions for the virtual lab and the tasks/requirements the learners will need to complete it. This information will appear in a “lab guide” the learners will refer to during the activity. You will also document the software/system requirements for the lab itself (software engineers will use this information to configure the lab).


Download the attachment "TEMPLATE - Virtual Labs" (at bottom of this article) and then follow the steps below.


Step-by-Step Instructions


Open the Virtual Labs Design Template and read the instructions.


  1. Enter the name of the Course/Skill where the virtual lab will be used.
  2. Enter the name of the Virtual Lab activity.
  3. Write a description/instructions for the activity.
  4. Enter the activity duration (in minutes).
  5. Write a detailed description of the tasks/requirements learners will need to complete for the lab activity. If there are supporting media such as charts, code snippets, or images, indicate their filenames and where to display them.
  6. Indicate if the virtual lab will be scored and used for assessment.
  7. Indicate whether the activity will reuse a virtual lab that was already built for the course, or whether a new one will need to be built.
  8. If the lab is new, document the required operating system and software, including the desired versions.
  9. If applicable, enter the validation criteria or solution code for the learner’s work. This information will be used to configure a validation tool (if evaluation by keyword is appropriate). The criteria could be written as a detailed description of what to check for each requirement, or simply the desired product or code.

Continue to Step 2.


(back to top)


Step 2: Create a Resource for the Virtual Lab Activity


In this step you’ll create a resource instance for the virtual lab. This will let the Spaces Learning team know where you want the lab activity to appear and what settings it should have.


1. Navigate to the target skill/lesson. Then select the Preview/Edit toggle at the upper right corner of the screen.


2. Select the Add Resource option.



3. Configure the Resource with the following settings:

  1. Give your virtual lab activity a name.
  2. Enter a brief Description of the activity. Learners will see this description in the course interface.
  3. Set the Resource Type to "Activity."
  4. Enter the URL for the lab guide content (e.g., and HTML or PDF file) in the Location field. If the guide has not been created yet, just enter "TBD" for now.
  5. Set the Resource Format to "Virtual Lab."


Update other settings as desired and then select Save when you are ready.


Continue to Step 3.


(back to top)



Step 3: Create a Lab Guide


The final step is to create a lab guide for the lab activity. There are several ways to do this, including using the My Content tool in Spaces Learning composer. To use this option, just download the guide below and then follow the instructions in the document.


Download the attachment "How to Create a Lab Guide" (at bottom of this article) and then follow the steps below.


You can also watch this video for a visual example of how to do this.


(back to top)