← All articles
Paivio blog

How to Import Anki Decks: Step-by-Step for Every Device

How to Import Anki Decks: Step-by-Step for Every Device

Student opening a deck on an iPhone

To import an Anki deck, open the file on the device where Anki is installed. On desktop, double-click the .apkg file or use File > Import. On a phone, tap the downloaded file and let the app open it. Spreadsheets and text files work too, but they need a quick check of the separator and field mapping first. The part that catches people is the file type. A .apkg adds decks, and a .colpkg replaces everything.

This guide covers each file type, each device, the settings that break imports, and how to export your notes to CSV. It also covers what to do when you want your cards in a second tool.

Paiviopaivio.aiKeep Your Anki Decks in Your Study LoopBring your own Anki decks into Paivio and review personalized material with a system that adapts to your learning pace.Explore Paivio

TL;DR

  • A .apkg file adds a deck to your collection. A .colpkg file replaces the whole collection, so only import one if you mean to start over.
  • On desktop, use File > Import or drag the file into the main window. On iPhone or Android, tap the file and open it in the app.
  • AnkiWeb does not accept uploads of deck files. Import on a device, then sync.
  • For CSV or text files, use plain UTF-8, then check the separator, the field mapping, and the duplicate setting in the preview.
  • To move decks into Paivio, bring your own Anki decks and keep your review history.

Table of Contents

Know your file type before you click

Most failed imports come from not knowing what the file is. Check the extension.

Extension What it contains What importing does
.apkg One or more decks, with their notes and media Adds the decks to your collection
.colpkg An entire collection: all decks, review history, settings Replaces your whole collection
.txt, .csv, .tsv Plain-text rows of notes Creates or updates notes, depending on your settings

The Anki manual’s exporting page describes a .colpkg as a whole collection, including decks, review history, and settings. AnkiMobile’s documentation is blunt about the consequence: a collection package replaces existing content with what is in the file. It does not merge changes the way syncing does. If you have studied recently on another device, sync or export first.

This matters most with shared decks. If a classmate or a deck author sends you a .colpkg, you will lose your own cards and scheduling. Ask for a .apkg. Anki forum helpers give this same advice when someone receives an updated deck as a collection file.

Import a .apkg deck on desktop

This is the easy case, and it is what you want for decks from classmates, course repositories, or shared-deck sites.

  1. Download the .apkg file and note where it saved.
  2. Open Anki on your computer.
  3. Either double-click the file, drag it into the Anki main window, or choose File > Import and pick it.
  4. Review the import dialog. If you already have some of these notes, you can choose whether updates to existing notes are accepted or ignored.
  5. Click Import, then check the deck list for the new deck.

If you have edited cards from an earlier version of a deck and the author sends an update, the “reject updates” choice is what protects your edits. Take a second to read that dialog instead of clicking through.

One small tip for large decks: import, then open the deck and browse a few cards before you study. Check that images, audio, and formatting came through. A packaged deck bundles its media, so missing images usually mean the file was damaged in download, not that you did something wrong.

Deck package containing cards and media assets

Import on iPhone, iPad, and Android

Phones differ from desktop in one way: you open the file from outside the app.

iPhone and iPad (AnkiMobile). Download the .apkg, then tap it. That opens AnkiMobile. If you download from Safari, the Anki forum advises tapping the blue download arrow, then Downloads, then the deck. The same thread notes that AnkiMobile also has an Add/Export option with a download link for fetching shared decks directly.

Android (AnkiDroid). The AnkiDroid manual says you can open an .apkg through Android, or import it manually from inside the app. If tapping the file does not work, use the in-app import and browse to the file.

If a phone import keeps failing, the quickest fix is to import on a computer and sync. Your phone then receives the deck through your account.

Can you upload a deck to AnkiWeb?

Not as a file. AnkiWeb is the sync service, and it does not load .apkg files for you. The route is always the same: import into the desktop or mobile app, then sync. You can download shared decks from the AnkiWeb site, but you still import them into an app. Anki forum replies state this plainly: you cannot import into AnkiWeb, only download from its shared decks.

This answers a common frustration for teachers and tutors. If you want students to have a deck, send them a .apkg, not a link to a spreadsheet, and have them import it in their own app.

Import a CSV or text file

Spreadsheets are the fastest way to get hundreds of facts into Anki, especially if you built a table in a course or copied a vocabulary list.

Prepare the file

The Anki manual says text files must be plain text in UTF-8, with fields separated by commas, semicolons, or tabs. A Word or Excel file will not work. In a spreadsheet, use Save As or Export and choose CSV (UTF-8). That one choice prevents garbled accented characters, which matter for anatomy terms, drug names, and anything in another language.

A simple layout for flashcards:

Front Back Tags
Which nerve innervates the diaphragm? Phrenic nerve (C3-C5) anatomy
First-line treatment for anaphylaxis? Intramuscular epinephrine emergency

If a field contains commas, such as a sentence, wrap that field in quotation marks, or use tabs as the separator instead.

Check the import screen

Choose File > Import and select the file. You will get a preview. Verify these before you click Import:

  • Separator. Anki guesses, and it can guess wrong. If your preview shows everything crammed into one column, change the delimiter.
  • Field mapping. Map each column to a field, such as Front, Back, or Tags. Per the manual’s text-file page, you also verify the delimiter and duplicate handling here.
  • Note type and deck. Pick the note type (Basic is fine for two-sided cards) and the deck that will receive them.
  • Allow HTML in fields. Turn this on only if your file contains HTML tags you want rendered. Otherwise the tags appear as visible text.
  • Duplicates and existing notes. Decide whether rows update notes already in your collection, or are skipped. If you are re-importing a corrected file, updating is what you want. If you are merging two lists, it may not be.

Run a small test first. Import five rows into a throwaway deck, look at the cards, and delete the deck if something is off. It takes two minutes and beats cleaning up four hundred broken cards.

Common problems

Everything lands in the Front field. The separator is wrong. Reopen the import and change the delimiter.

Accents or symbols look like gibberish. The file was not saved as UTF-8. Re-export from your spreadsheet.

Cards appear with literal tags like angle brackets. Enable HTML in fields, or remove the markup from the file.

Rows vanished. Duplicate handling probably matched them to existing notes. Look at the import log for counts of updated and skipped notes.

Four common Anki import problems and fixes

Export Anki notes to CSV

People search for this because they want a backup, a spreadsheet edit, or a way to move cards elsewhere.

  1. In Anki desktop, choose File > Export.
  2. Pick “Notes in Plain Text” for one row per note. Choose “Cards in Plain Text” if you want one row per card.
  3. Choose what to include: HTML and media references, tags, deck names, note type name, and unique identifiers.
  4. Pick the deck and save.

The AnkiDroid documentation update lists the same plain-text options and notes the files must be UTF-8 plain text. The result is a tab-separated text file that opens in a spreadsheet. If you want a .csv, open it there and save as CSV (UTF-8).

Two cautions. First, plain-text export holds the content of your notes, not your scheduling. Your review history and due dates do not travel in that file. Second, media such as images and audio are exported as references, not embedded files. If you need everything, including scheduling and media, use a package export: .apkg for decks, .colpkg for a full backup.

Pick the right route for your goal

You want to… Use
Add a classmate’s or shared deck .apkg import
Back up or move your whole collection to a new computer .colpkg export, then import (this replaces what is there)
Bulk-add facts from a spreadsheet CSV or text import
Edit a lot of cards in bulk Plain-text export, edit, re-import with updates on
Study on phone Import on desktop, then sync

Our perspective: your cards are worth more than the file

We built Paivio around one belief: a deck you made or curated yourself beats a generic one, because it matches what your course actually tests. That is why importing is the front door. You bring your own Anki decks, notes, or topics, and the study loop is built on your material, not on a library we picked for you. If you want the longer argument, we wrote it up in custom flashcards versus premade.

Here is what we have noticed about imports. Students treat a deck as a pile of cards, but the valuable part is the history: which cards you know cold and which you keep missing. Throw that away and you start from zero. So we care about direct Anki import that keeps review history, and about scheduling by explicit recall ratings so each card returns when you need it.

The second thing is relationships. A flat deck of 3,000 cards does not show how the renal system connects to acid-base balance. That is why we pair spaced repetition with concept mapping, which you can read about in our guide on building concept maps that stick. If you study cumulative subjects such as anatomy, physiology, or pharmacology, the connections are what make facts hold up under exam pressure.

Our advice: keep your Anki collection as your backup, and import into whatever tool you want to try. You lose nothing by testing.

— Jackson

Bring your Anki decks into Paivio

If you want your decks in a system with daily review queues, exam-date pacing, concept maps, and optional AI-generated cards, Paivio takes your Anki decks, notes, or topics and builds the review around them. See how it works, or try the sample session first.

The Free plan costs $0 per month. Paid plans are Plus at $20 per month or $200 per year, and Pro at $40 per month or $400 per year. Extra credits are available as a $10 one-off top-up. Paivio is free to use during the beta, with unlimited cards. Current details are on the pricing page. If you want to see what subjects students study with it, browse subjects.

Before you import anything: a short safety routine

A few habits keep imports from turning into lost work.

  • Back up first. Export a .colpkg of your current collection before importing anything large or anything you are unsure about.
  • Sync before you import a collection. Because a collection package replaces content rather than merging, recent reviews on another device can disappear if you have not synced.
  • Test with a small file. Five rows or one small deck tells you whether the mapping and formatting are right.
  • Keep one source of truth. Decide which tool holds your scheduling. Studying the same cards in two apps splits your history.
  • Look at the log. After import, Anki reports how many notes were added, updated, or skipped. Those counts tell you quickly if something went wrong.

FAQ

Can I import an Anki deck without a computer?

Yes. On iPhone or iPad, download the .apkg and tap it to open it in AnkiMobile. On Android, open the file through AnkiDroid or use its in-app import. If either one fails, import on a computer and sync instead.

What is the difference between .apkg and .colpkg?

A .apkg adds one or more decks to your existing collection. A .colpkg is a whole collection with decks, review history, and settings, and importing it replaces what you have. Use .apkg for sharing and .colpkg for backups.

Why did my CSV import put everything in one field?

The separator is probably wrong. In the import preview, change the delimiter to comma, tab, or semicolon until the columns split correctly, then confirm the field mapping. Also make sure the file is saved as plain UTF-8 text.

Can I upload a deck to AnkiWeb?

Not as a file. Import the deck into Anki on desktop or mobile, then sync with your account. AnkiWeb lets you download shared decks, but you import them into an app.

Does exporting notes to CSV keep my review history?

No. A plain-text export holds note content, tags, and optional extras such as deck names, but not your scheduling. For history, use a package export instead.

Sources

Recommended

Your next chapter

Bring one deck.
Start one session.

Create an account and make your next review a place to begin.

Start studying free

Free during beta · No credit card · For students 18+