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
| front | back | hint | multiple_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.