Bulk Upload Cards Documentation

This guide will help you format your files correctly to bulk upload multiple flashcards into the current deck.

Supported File Formats

You can upload cards using one of the following file formats:

  • JSON (.json)

  • CSV (.csv)

1. JSON Format

Your JSON file must be an array of card objects. Each card object can optionally include a `multiple_choice_options` array containing incorrect answers (decoys) for quiz mode.

[
  {
    "front": "Which cranial nerve is responsible for the sense of smell?",
    "back": "Olfactory Nerve (I)",
    "hint": "Think of the first nerve.",
    "multiple_choice_options": [
      "Optic Nerve (II)",
      "Vagus Nerve (X)",
      "Facial Nerve (VII)"
    ]
  },
  {
    "front": "Which cranial nerve controls facial expression?",
    "back": "Facial Nerve (VII)"
  }
]

2. CSV Format

For CSV files, the first row must be the header, and each following row is a single flashcard.

Columns

  • front: (Required) The text for the front of the card.
  • back: (Required) The text for the back of the card (the correct answer).
  • hint: (Optional) An optional hint for the card.
  • multiple_choice_options: (Optional) A comma-separated string of incorrect answers (decoys) for quiz mode.

Example Structure

frontbackhintmultiple_choice_options
Which cranial nerve is for smell?Olfactory Nerve (I)Think of the first nerve.Optic Nerve (II),Vagus Nerve (X)
Which nerve controls facial expression?Facial Nerve (VII)

Download Sample Files

Use these files as a template to ensure your data is formatted correctly.

Note: To use the sample files, you must place them in the /public directory of your project.