Home › Import a Test Into Blackboard

Import a Test Into Blackboard: From Document to Graded Test

Updated October 23, 2026 · 8 min read

You have a test — a final, a midterm, a department item bank — sitting in a Word, Excel, or PDF file. You want it live in Blackboard as a graded test. The first thing people discover: Blackboard has no "import document" button. There is no place to drop a .docx or .pdf and watch it become a test. Blackboard accepts exactly two formats, and understanding both is what turns a frustrating afternoon into a five-minute job.

Key fact: Blackboard imports tests from an IMS QTI 2.1 package (ZIP) or a tab-delimited text file (TSV) built on its specific template. Not CSV — Blackboard reads tab characters, not commas. A Word/Excel/PDF has to become one of those two formats first.

The two formats Blackboard accepts

FormatHow it is builtBest for
IMS QTI 2.1 (ZIP)Standardized XML package. ExamParser generates this from your document.Portability across LMS; survives the Original→Ultra move.
Tab-delimited text (TSV)One row per question, tab-separated, on Blackboard's template with the correct header row.Simple question sets when you prefer a plain file.

The tab-delimited file is fiddly because a single shifted column silently drops a question. A minimal valid TSV row looks like this:

Question	Option A	Option B	Option C	Correct
What is the capital of Japan?	Tokyo	Osaka	Kyoto	A

That is the shape Blackboard expects — tabs between fields, the answer as a letter. QTI 2.1 carries the same information in a structured, validation-friendly package, which is why it is the safer default.

Ultra vs Original: two import paths

Blackboard runs two course views, and the import screen differs:

A

Ultra course view

Open the course, go to Question Banks, choose Import, and select the QTI 2.1 package. Items land in a reusable bank you can attach to any test.

B

Original course view

Control Panel › Course Tools › Tests, Surveys, and Pools › Question Pools › Import Pool. Upload the QTI package (or the TSV).

Heads-up on course views: Blackboard's Original Course View retires on December 31, 2026. If your institution is migrating to Ultra, a QTI 2.1 package regenerates cleanly into the new view's question banks with no manual re-entry. Building your tests as QTI now is the move that saves you a second conversion later.

Step-by-step: document → Blackboard test

1

Pick the format

Default to QTI 2.1 for portability and the Original→Ultra future. Use TSV only for a quick simple set.

2

Convert your document

Upload the Word, Excel, or PDF. ExamParser reads it as written (OCR for scanned PDFs), maps it to fixed columns, and emits the QTI 2.1 ZIP or the TSV.

3

Open the import screen

Ultra: Question Banks › Import. Original: Question Pools › Import Pool.

4

Upload and verify

Select the package, let Blackboard parse it, then open the bank/pool and scan a few items for shifted options or dropped questions.

5

Attach to a test

Point your new or existing test at the imported bank/pool. The questions are now graded and reusable.

Why QTI beats the tab-delimited route

The TSV works, but it is brittle: a stray tab or an extra column breaks the parse, and it only ever lands in Blackboard. A QTI 2.1 package is structured and validated on export, and the same file imports into Canvas, Brightspace, Moodle, and more. Because ExamParser generates QTI deterministically — it never rewrites your question text — what you authored is what students see. That auditability is what you want on a graded test.

More import guides at examparser.com/blog/en.

Frequently asked questions

Can Blackboard import a Word, Excel, or PDF test directly?

No. Blackboard has no document import button. It accepts exactly two formats for a test: an IMS QTI 2.1 package (a ZIP), or a tab-delimited text file (TSV) built on its specific template — not CSV. To bring a document into Blackboard you first convert it into one of those two formats, then import.

What is the difference between importing into Blackboard Ultra and Original?

Ultra: open the course, go to Question Banks, and choose Import; the QTI items land in a reusable bank. Original: Control Panel > Course Tools > Tests, Surveys, and Pools > Question Pools > Import Pool. The Original Course View retires on December 31, 2026, so a QTI 2.1 package is the safer long-term choice — it regenerates cleanly into Ultra.

Why use QTI 2.1 instead of the tab-delimited text file?

The tab-delimited file works, but it carries less structure and breaks easily if a column shifts. QTI 2.1 is a standardized package that imports across Canvas, Blackboard, Brightspace, and Moodle, so the same source file can feed several systems and survives the Original-to-Ultra migration.

What source files can I use to build a Blackboard test?

Excel/CSV with a fixed column layout (question, options, correct answer, optional image URL), Word/DOCX, or PDF (text-based or scanned via OCR). Each question may carry at most one image, supplied as a URL.

Ready to import your test into Blackboard?

Convert your Word, Excel, or PDF into a QTI 2.1 package (or a clean TSV), import it into Ultra Question Banks or an Original Question Pool, and your graded test is ready — without retyping a single question.

Try ExamParser →