Custom Cards Import

Custom Cards Import

Load cards from your own file - handy when you keep a list somewhere else, or you generate one with a script. No API keys needed. Find it under Settings → Import → Custom cards.

File format

One file per import. Two formats are accepted:

• JSON - either an array of objects, or a single object for one card.
• CSV - one header row naming the columns, then one card per line. Standard CSV quoting rules apply, so a value can hold commas and line breaks if you wrap it in quotes.

Only two fields are required on every card: title and type (the media type - game, movie, tv, anime, manga, book, and so on). Everything else is optional.

Optional card fields cover the same things a normal card has: alternate title, description, year, genres, a link, a cover image URL, platform, manga/anime format, and progress totals (episodes, chapters, pages, parts).

You can also fill in your personal fields right in the file: status, your rating, a note, the rewatch counter, start and finish dates, time spent, the favorite flag, episode/season progress, and tags. Tags that don't exist yet are created for you.

Templates

The import screen has two download buttons that give you a ready-made file to fill in:

• a CSV template with just the header row
• a JSON template that describes itself - the hint keys in it start with _ and the importer ignores them, so the template imports cleanly as-is if you want to see how it lands

How to import

1. Go to Settings → Import → Custom cards
2. Download a template if you want a starting point, fill it in, and save your file
3. Press to pick your JSON or CSV file
4. Choose the target collection - a new one or an existing one
5. Check the preview (below), adjust which rows to bring in, and confirm

The preview

Before anything is written, the file is read and checked, and a preview shows a summary: Recognized · Errors · Duplicates.

• Errors - rows that couldn't be read (missing title or type, a bad value). They float to the top of the list with the reason spelled out, so they're easy to fix.
• Duplicates - a title already in the target collection, or the same title twice in your file. These are unchecked by default.
• Everything else is checked and ready.

The list has a checkbox per row plus select-all / select-none, so you decide exactly what gets imported. Nothing touches your library until you confirm.

Covers

If a row has a cover image URL (http or https), the image is downloaded only after you confirm the import, and only for the rows you actually brought in. If a cover fails to download, the card is still created and a short note is left on it.

Platforms

Platform text is matched against the app's platform list, ignoring case - you can write either the short name or the full one. If nothing matches, the text is kept as-is as a free-form platform name.

Prefill one card from a file

You don't have to type every field by hand. When you create or edit a single custom card, you can load a JSON or CSV file - the same formats this bulk import accepts - to fill the form for you. Pick the file, and the fields come in prefilled. You can still change anything before you save.

The create form also has My Notes and Tags of its own (tags as a comma-separated list), and a loaded file prefills them from the comment and tags columns. On Create the note is saved as the item's personal comment and the tags go through the global tag system, creating the ones that don't exist yet. The edit form does not show these two fields - change the note and tags from the item's detail screen instead.

See also

• Import / Export - the .xcollx collection format and full backups
• Item Details - what each field on a card means