Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Import & Export Formats

ArcaneMetriX supports several ways to import and export your decklists, allowing for seamless and high-fidelity transfers between different MTG tools while maintaining metadata like specific printings (set/collector number) and deck zones.

What happens when you import

Every import creates a new deck. It does not merge into the deck you currently have open. Importing a second deck gives you a second deck.

  • The deck currently open is replaced. If it has cards in it, the import window warns you before you commit. Save it first if you want to keep it.
  • If you are signed in, the imported deck is saved to your library automatically. You do not need to find Save afterwards; it is already there when you open the Library tab.
  • If you are not signed in, the deck stays in your browser and is not saved anywhere. Sign in and save it to keep it.
  • The deck keeps its name from the source where the source provides one. Pasted lists and CSV files have no name of their own, so they arrive as Imported Deck and can be renamed.

You can start an import from the Home tab, the Library tab, or the deck menu.

ArcaneMetriX natively supports importing decks directly from popular deckbuilding websites via their URLs. Simply paste the URL into the Import Deck modal.

Supported Sites:

  • Archidekt: e.g., https://archidekt.com/decks/12345
  • ManaBox: e.g., https://manabox.app/decks/abcdefg
  • ArcaneMetriX: e.g., https://arcanemetrix.com/deck/12345

Moxfield links are not supported. Moxfield blocks automated access to decks at their edge, so a Moxfield URL fails for public and unlisted decks alike. It is not a privacy setting you can change, unfortunately. Use the export-and-paste route below instead.

When using a supported URL, ArcaneMetriX automatically fetches the decklist with all its high-fidelity data, including specific printings, quantities, and board sections (Mainboard, Sideboard, Commander, etc.).

To get a link, open the deck in ManaBox, tap the three-dot menu, and choose Share. Sharing a link requires a ManaBox account.

Two things worth knowing:

  • ManaBox links are snapshots. If the deck changes afterwards, the owner has to update the link in ManaBox before those changes appear here.
  • ManaBox decks have no sideboard. Any card ArcaneMetriX cannot place moves to the Maybeboard, where it is easy to see and adjust, rather than being dropped or silently added to your main deck.

If a ManaBox link ever fails to import, use ManaBox’s text export instead. That path does not depend on their website at all.

Moxfield URLs cannot be imported. Moxfield blocks automated deck access, and it applies to every deck — public, unlisted, or private — so there is no setting on the deck that makes a link work.

To bring a Moxfield deck across:

  1. Open the deck on Moxfield.
  2. Choose Export and copy the decklist text.
  3. Paste it into the Import Deck window here.

The pasted text keeps its set codes, collector numbers and foil markers, so you get the exact printings and finishes you picked rather than arbitrary ones. See Standard Text Format below for the format.

2. Standard Text Format

You can paste standard text-based decklists directly into the import box or drag-and-drop a .txt file. The parser expects the following standard format:

[Quantity] [Card Name]

Example

1 Command Tower
1 Sol Ring
4 Lightning Bolt
18 Mountain

This is also the format ManaBox produces when you share a deck as text (three-dot menu → Share → text), so a ManaBox text export can be pasted or dropped in directly.

Notes:

  • Empty lines are ignored.
  • If a quantity is omitted, it defaults to 1.
  • Set and collector number in parentheses are used to pick the printing, so 3 Verdant Catacombs (MH2) 260 imports that exact art and edition rather than an arbitrary printing. Non-numeric collector numbers (promos, variants such as 65s) work too.
  • A *F* marker imports the card as foil, and *E* as etched — 1 Sol Ring (LTC) 284 *F* gives you the foil LTC printing.
  • *CMDR* marks a commander, and // Sideboard, // Maybeboard, // Commander headers assign the following cards to that zone.

Archidekt & Moxfield text exports

Archidekt’s text export adds a per-card category list, and it is supported as-is. You may paste it without editing anything out:

1x Sol Ring (sld) 2807 [Late Game Ramp]
1x Kynaios and Tiro of Meletis (sld) 2806 [Commander{top},Everybody Draws]
1x Curse of the Swine (soc) 192 [Maybeboard{noDeck}{noPrice}]
1x Beast (plst) TIKO-10 [Tokens & Extras{noDeck}]
  • The 1x quantity style and Archidekt’s non-numeric collector numbers (STH-101, 1012a, 252p) are both handled.
  • Categories decide where a card lands: Commander, Sideboard and Maybeboard go to those zones, and everything else goes to the main deck.
  • {noDeck} is Archidekt’s “not part of the deck” marker, used for tokens and the maybeboard. Those cards import to the Maybeboard. They are kept, but they do not inflate your deck’s card count.

Moxfield export pasted as text keeps the printings and finishes you chose, which is what makes the export-and-paste route a full-fidelity substitute for the URL import Moxfield does not permit.

3. CSV Format (High-Fidelity)

ArcaneMetriX supports importing and exporting decklists and collections using the CSV (Comma Separated Values) format. This allows for high-fidelity transfers between different MTG tools while maintaining metadata like specific printings (set/collector number) and deck zones.

General Structure

A valid CSV should contain a header row followed by data rows. ArcaneMetriX uses a flexible header detection system that supports multiple common naming conventions from tools like Archidekt, Moxfield, and ManaBox.

ManaBox CSV exports work as-is. Export your collection from ManaBox and drop the file straight in — its Name, Quantity, Set code, Collector number, Foil, Scryfall ID, Condition, Language, Binder Name, Purchase price, and Purchase price currency columns are all recognized. Columns ArcaneMetriX has no use for or are not compatible with (rarity, ManaBox ID, misprint, altered) are ignored rather than treated as an error.

Supported Headers

CategoryPrimary HeaderAliasesDescription
QuantityCountQuantity, Qty, countNumber of copies of the card. Defaults to 1 if missing.
Card NameNameCard Name, Card, nameThe full English name of the card.
Set CodeSetSet Code, Edition, Edition CodeThe 3-4 character code for the expansion (e.g., ELD, MMA).
Collector #Collector NumberCollector #, CN, numberThe specific number of the card within the set.
Scryfall IDScryfall IDscryfall_id, IDThe UUID used by Scryfall for this specific printing.
Section/ZoneSectionZone, Board, categoryWhere the card belongs (Mainboard, Sideboard, etc.).
FinishFinishFoil, Is Foil, Printing, FoilingCollection finish, such as nonfoil, foil, or etched.
ConditionConditionCard Condition, CondCollection condition, such as NM, LP, MP, HP, or damaged.
LocationLocationFolder Name, Binder, Storage Box, StoragePhysical storage location. Nested paths can be written as Binder > Section > Row.
TradableTradableFor Trade, Tradelist Count, Trade QuantityWhether the imported collection lot should be marked for trade.
Acquired OnAcquired OnDate Added, Date Bought, Date Acquired, Purchase DateDate the card was acquired.
Purchase PricePurchase PricePrice Bought, My Price, Paid, Acquired Price, PricePurchase price for collection tracking.
CurrencyCurrencyPurchase Price Currency, Price CurrencyCurrency for the purchase price.
NotesNotesComment, CommentsFree-form collection notes.

Zone/Section Handling

ArcaneMetriX recognizes the following values in the Section or Zone column:

  • Mainboard: Main, Mainboard, Deck, Main Board
  • Sideboard: Side, Sideboard, Side Board
  • Maybeboard: Maybe, Maybeboard, Maybe Board
  • Commander: Commander, Command, General
  • Companion: Companion

If no section is specified, the card is imported into the Mainboard.

Example CSV Formats

Minimum (Name only)

Name
Lightning Bolt
Opt
Island

Standard Decklist (Quantity + Name)

Count,Name
4,Lightning Bolt
4,Opt
22,Island

High-Fidelity (With Printings and Zones)

Count,Name,Set,Collector Number,Section
1,Thrasios, Triton Hero,C16,46,Commander
1,Tymna the Weaver,C16,48,Commander
30,Island,ELD,254,Mainboard
1,Lurrus of the Dream-Den,IKO,226,Companion
4,Duress,M19,94,Sideboard

Exporting from ArcaneMetriX

When exporting a deck as a CSV, ArcaneMetriX will include all available metadata to ensure the deck can be re-imported with 100% accuracy into ArcaneMetriX or other compatible tools:

  1. Count
  2. Name
  3. Set
  4. Collector Number
  5. Scryfall ID
  6. Section

When exporting a PRO collection as CSV, ArcaneMetriX includes collection inventory fields:

  1. Quantity
  2. Name
  3. Scryfall ID
  4. Oracle ID
  5. Set Code
  6. Collector Number
  7. Finish
  8. Condition
  9. Language
  10. Location
  11. Tradable
  12. Acquired On
  13. Purchase Price
  14. Currency
  15. Source
  16. Notes

Import Troubleshooting

  • Encoding: Ensure your .txt or .csv file is saved in UTF-8 encoding.
  • Multiple Matches: If a card name matches multiple printings and no Set/ID is provided, ArcaneMetriX will prioritize the most recent or popular printing.
  • Failed Cards: If a card cannot be found, ArcaneMetriX will provide a summary of failed names at the end of the import process.