Letterboxd is an independent service created by a small team, and we rely mostly on the support of our members to maintain our site and apps. Please consider upgrading to a Pro account—for less than a couple bucks a month, you’ll get cool additional features like all-time and annual stats pages (example), the ability to select (and filter by) your favorite streaming services, and no ads!
Importing your data
When importing data we support the following formats:
- Letterboxd import format (CSV)
- IMDb export files (CSV)
- Delicious Library v2 or 3 export files (XML)*
- ICheckMovies export files (custom)
*Delicious Library files are only supported when importing to a list.
Letterboxd import format
“It’s CSVeasy!” —John Siracusa, ATP 351
The Letterboxd import format is a CSV file (with UTF-8 character encoding) that supports the following column titles, in any order (other column titles are ignored). You must include at least one of the first four column titles listed below on the first line of your file, along with any others your file includes data for.
|LetterboxdURI||String (optional), matches a film or diary entry by its Letterboxd URI, example:
Note: letterboxd.com URIs are also supported for backwards compatibility; this column can alternatively be titled
|tmdbID||Number (optional), matches a film by its numeric TMDb ID, example:
|imdbID||String (optional), matches a film by its alphanumeric IMDb ID, example:
|Title||String (optional), matches a film by title when no ID or URI is provided|
|Year||YYYY (optional), used to improve title matching when no ID or URI is provided|
|Directors||String (optional), used to improve title matching when no ID or URI is provided; use commas to delimit multiple director names (and remember to enclose the complete string in quotes)|
|Rating||Number (optional, decimals from 0.5–5 including 0.5 increments), a rating for the film out of five|
|Rating10||Number (optional, integers from 1–10), a rating for the film out of ten (will be converted to 0.5–5 scale)|
|WatchedDate||YYYY-MM-DD (optional), creates a Diary Entry for the film on this date|
|Rewatch||Boolean (optional), if
|Tags||String (optional), added to Diary Entry when
|Review||Text/HTML (optional, accepts the same set of HTML tags as on the Letterboxd website), your review of the film, added to Diary Entry when
Note: this column title can also be used when importing to a list, to populate the Notes field.
For example, a valid file might look like this:
Your CSV file must use the comma character (,) to delimit columns—do not include a space character immediately after the comma, as this can interfere with the parsing of quoted strings. Strings containing commas (such as film titles, director/tag lists or review text) must be placed inside quotes, eg:
"Joel Coen, Ethan Coen". Don’t forget to escape quotes within quoted text, by prefixing them with a backslash (\) character.
Notes on importing
- There is no undo after the confirmation step. Be careful!
- Providing a
imdbIDfor each line in your file performs an exact match for the film (or diary entry, see below), while providing title (and optional year and director/s) results in a best-guess match.
- The importer shows a summary of the import file prior to completing the import, so you can fix any mismatched titles and/or remove any inappropriate entries (such as TV entries that have matched to similarly named films).
- All films imported to your Profile will be automatically marked as watched (this step is optional when importing to a list).
- The importer updates existing Diary Entries if a film is imported with a
WatchedDatethat matches an existing entry for the same film already in your Diary, to allow the addition of tags or a review to existing entries.
- Multiple lines containing the same film with the same
WatchedDatewill be combined into a single entry when the imported data is saved. If these are legitimately separate entries, you’ll need to add them manually.
- If both
Ratingcolumns contain data on any given line of the file, whichever column appears second in the file will take precedence.
- There is a file size limit of 1MB, so you’ll need to divide large files into multiple smaller files (the header row containing column names must be in every file).
Importing to a list
- When importing to a list, films in the import file that are not already present in the list will be appended at the end, in the order they appear in the import file. Any films already present in the list will remain in their current positions.
- If you wish to revise/update a list based on an import, select the option to completely replace the existing list items, which appears on the confirmation screen prior to completing the import.
The helper scripts and web apps listed below are created and maintained by third parties. We hope you find them useful, but please contact the individual authors for support.
- Criticker2Letterboxd by mnzeric
- Filmow2Letterboxd by Lucas Meireles
- Filmweb2Letterboxd by Jakub Serwatka
- Mubi2Letterboxd (Go) by Igor Rudenko
- Mubi2Letterboxd (Python) by Igor Rudenko
- Mubi2Letterboxd (Python) by AL Kleijngeld
- Must2Letterboxd by iterlace
- Plex2Letterboxd by Max Timkovich
- SensCritique2Letterboxd by Steeve Vu
- Trakt2Letterboxd by Anoop Sankar
- CSV generator for Filmow by Larissa Gusmão
- CSV generator for Filmow (Portuguese) by Myanari
- CSV generator for FilmAffinity by Pablo Baeyens
- CSV generator for Vudu by Tieg Zaharia
- CSV converter for Lovefilm by Ian Wootten
- CSV converter for MovieLens by Jonah Lawrence
- Data exporter for Moviepilot by Max Kruse
- IMDb matcher (matches film titles to IMDb IDs) by Daniel Crouch
- RatS (Rating Synchronization for IMDb, Netflix, etc.) by StegSchreck
- Ratings exporter for Rotten Tomatoes by Moglum
- Simkl exporter by Nil Silva
- XML to CSV converter (for services like Listal that offer XML export) by Data.Page
If you create a helper script that generates files for our importer, let us know.