Delivering a Numbas exam to your students

Once you’ve created an exam, you need a way for your students to access it.

The following instructions describe how to make an exam available to your students, either standalone with an embed code, or through your VLE (virtual learning environment) so you can record scores.

Run standalone on the web

Numbas exams can run entirely standalone: students access the test through a web browser, but data about their attempt is not saved. This is suitable when you want to provide material for students to practice on their own, and don’t need to record scores.

Embed from the editor

When you Run the exam, click the Share button at the top of the page and copy the URL that appears. You can share this URL with your students, or link to it from your course material.

If you use OEmbed-compatible software such as WordPress, you can paste the URL of the exam into the editor and it’ll be embedded automatically.

Upload to your own webspace

In the exam editor, click on the Download button, and select standalone .zip (no SCORM) to download a package suitable for standalone use on the web.

Extract the zip file on your computer, and then upload the resulting files to a new directory on your webspace. Most often you’ll be able to do this through an FTP client - ask your server administrator.

Once you’ve uploaded the exam files, you’re done! The exam will be available at the address you uploaded it to.

Uploading an exam to a virtual learning environment

Numbas produces SCORM objects which can be uploaded to any SCORM 2004-compatible VLE (virtual learning environment), or the Numbas LTI provider.

The Numbas LTI provider offers many features over a standard SCORM player, but needs to be installed locally.

If your VLE offers a built-in SCORM player, you can use it for Numbas exams without any further setup.

The first step for either method is to create a SCORM package of your exam.

Creating a SCORM package

In the exam editor, click the Download button and select SCORM package.

The "download" admin control in the exam editor is highlighted.

A .zip file containing everything needed to run the exam will be downloaded to your computer.

Uploading to the Numbas LTI provider

See the Numbas LTI provider documentation.

Uploading to Blackboard


Many users have reported problems with Blackboard’s built-in SCORM player, including a consistent pattern of losing data on 5-10% of all attempts. We don’t recommend using Blackboard’s SCORM player for high-stakes assessments. Instead, if you can, use the Numbas LTI provider with Blackboard.

Log in to Blackboard, and go to the content section of the relevant course. Click on the Content package (SCORM) item under the Build Content menu.

Blackboard's "Build Content" drop-down, with "Content package (SCORM)" highlighted.

On the next screen, select the .zip file you downloaded earlier, then click Submit.

Uploading a SCORM package to Blackboard.

On the next screen you can set some options for your exam.

Editing a SCORM package on Blackboard.

The default options are usually fine, but you should make sure that the settings under SCORM availability in particular are how you want them.

The SCORM availability options.

Click Submit, and your exam is ready to use!

Uploading to Moodle

Log in to Moodle, and go to the relevant course. Turn editing mode on, then click on the Add an activity or resource link and select SCORM package.

Moodle's "Add an activity or resource" dialog.

Enter your exam’s name in the Name field, and write a description in the field beneath. Then drag the .zip file you downloaded earlier onto the Package file field.

Moodle's "Adding a new SCORM package" form.

Take a look at the rest of the settings on the page to make sure they’re set how you want. The default settings are usually fine, though you might like to set Hide navigation buttons to Yes to save screen space.

When you’re ready, click on Save and display. Your exam is ready to use!

Other VLEs

A few other VLEs offer built-in SCORM players. Most VLEs now support LTI - if your VLE supports LTI, use the Numbas LTI provider.