Search

Item Import with Images

Certiverse supports importing items that include images directly within the item content, including the exhibit, stem, or response options. To use this import type, upload a ZIP file that contains both the item import CSV file and an Images folder with all referenced image files.

Overview

The Item Import with Images option allows items to be imported with HTML formatting and embedded images. The ZIP file must use the following structure:

your-import.zip
├── your-items.csv
└── Images/
    ├── ImageName1.jpg
    ├── ImageName2.jpg
    └── ImageName3.png

Important: The folder inside the ZIP file must be named exactly Images with a capital I. If the folder name is different, the system will not be able to locate the image files and the import will fail.

Step 1: Prepare your image files

Collect all image files you intend to use across your items. Before creating the ZIP file, confirm the following:

  • Supported file formats include JPEG, PNG, GIF, BMP, WebP, and TIFF.
  • File names should not contain spaces or special characters.
  • Use descriptive and consistent file names to make references easier to manage. For example: AVitamin.jpg or BVitamin.jpg.
  • All image files must be placed inside a folder named Images at the root level of the ZIP file.

Step 2: Add image references to the CSV

In the item import CSV file, images are referenced by placing an HTML image tag directly in the applicable cell. Use the following format:

<img src="Images/ImageName.jpg">

Replace ImageName.jpg with the exact file name of the image, including the file extension.

Where can images be placed?

The image reference tag can be added to any of the following columns:

  • Exhibit
  • Stem
  • ResponseOption1 through ResponseOption8

Note: You can combine text and an image reference within the same cell. For example, a stem cell might read:

Which food contains more Vitamin A? <img src="Images/AVitamin.jpg">

How does the system know which image belongs to which item?

The system does not assign images by row number. Instead, it follows the src path provided in the image tag. Each item points directly to its image file through the reference in the CSV. As long as the file exists in the Images folder inside the ZIP file, the system will locate and display it correctly.

Step 3: Build the ZIP file

Once the CSV file is ready and the images are organized, create a ZIP file using the following requirements:

  • The CSV file must be at the root level of the ZIP file. It should not be inside a subfolder.
  • The Images folder must also be at the root level of the ZIP file.
  • The folder must be named exactly Images with a capital I.
  • All image files referenced in the CSV must be present inside the Images folder.
  • Image file names in the CSV must match the actual file names exactly, including capitalization and file extension.

Step 4: Import the ZIP file

  1. Navigate to the item import section of the platform.
  2. Select Item Import with Images as the import type.
  3. Upload the .zip file.
  4. The system will read the CSV, locate each image using its reference tag, and import all items with their associated images.

Note: Imported items will have a status of PENDING IMPORT and must be reviewed and approved before they become accepted items.

CSV file format

The CSV must follow the standard item import format. The first row must contain the correct column headers. The table below lists the key columns used for this import type.

ColumnDescriptionSupports image tag?
ItemNameOptional. Auto-generated if left blank. Cannot match an existing item name.No
ItemTypeRequired. Item type identifier, such as MC4 for multiple choice with 4 options.No
TopicDisplayIdThe display ID of the topic the item belongs to, such as #1.No
ExhibitOptional introductory content shown before the stem.Yes
ScenarioOptional scenario or case context for the item.No
StemRequired. The question or prompt presented to the candidate.Yes
ResponseOption1-8Answer choices. Include as many options as the item type requires.Yes
ResponseOption1IsKey-8IsKeySet to TRUE for the correct answer and FALSE for all other answers.No
ResponseOption1Rationale-8Optional rationale explaining why the option is correct or incorrect.No
ReferenceOptional reference material for the item.No
ItemTagsOptional tags for categorization.No
NotesOptional internal notes about the item.No

Sample CSV rows

The table below shows three sample items from the Vitamins sample file and demonstrates how image references appear in the Stem column.

ItemTypeTopicDisplayIdStemResponseOption1IsKey
MC4#1Which food contains more Vitamin A? <img src="Images/AVitamin.jpg">Sweet Potato.TRUE
MC4#1Which food provides the most vitamin B per serving? <img src="Images/BVitamin.jpg">Liver.TRUE
MC4#1How much vitamin C should a healthy adult consume each day? <img src="Images/CVitamin.jpg">150 mg per day.TRUE

Pre-import checklist

  • The CSV file is at the root level of the ZIP file.
  • The image folder is at the root level of the ZIP file and is named exactly Images.
  • Every image referenced in the CSV is included in the Images folder.
  • Every image file name in the CSV matches the actual image file name, including capitalization and file extension.
  • Image references use the correct format: <img src="Images/ImageName.jpg">.
  • Image tags are only used in supported columns: Exhibit, Stem, or ResponseOption1 through ResponseOption8.

Updated

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.