Importing your data

Letterboxd Pro members are able to import data into their account in one of two ways: directly into their account (as watched films and/or diary entries) or directly into a list.

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 export files are supported in the list importer only.

Proceed to the Import page to import into your Films and/or Diary sections, or to the Edit page for a list to import films into that list (you can import directly to your Watchlist also).

Letterboxd import format

The Letterboxd import format is a CSV file that supports the following column headers in any order (other columns in your file will be ignored):

LetterboxdURI String (optional, the URI of the matching film or diary entry)
tmdbID Number (optional, eg. 27205)
imdbID String (optional, eg. tt1375666)
Title String (used for matching when no ID or URI is provided)
Year YYYY (optional, used for matching when no ID or URI is provided)
Directors String (optional, used for matching when no ID or URI is provided)*
WatchedDate YYYY-MM-DD (optional, creates a Diary Entry for the film on this day)
CreatedDate YYYY-MM-DD'T'HH:mm:ss.SSS'Z' (optional)
For example: 2012-12-31T12:30:00.000Z
Rating Number (optional, rating out of 5 including 0.5 increments)
Rating10 Number (optional, rating out of 10)
Tags String (optional, added to Diary Entry if WatchedDate is provided)*
Review Text/HTML (optional, allows the same HTML tags as the website, added to Diary Entry if WatchedDate is provided, otherwise added as a review with no specified date)*

* Strings containing commas (such as director/tag lists or review text) must be placed inside quotes, eg: "Joel Coen, Ethan Coen". Remember to escape quotes within quoted text.

Notes on importing

  • The importer is available to Pro members only.
  • The importer shows you a summary of your file before performing the import, so you can fix any mis-matched titles and/or remove any inappropriate entries.
  • All films imported to your Films/Diary will be automatically marked as watched (this is an optional setting when importing films to a list).
  • The importer will update existing Diary Entries if a film is imported with a WatchedDate the same as one already in your Diary, so you can add tags or a review to existing entries.
  • Multiple lines containing the same film with the same WatchedDate will be combined into a single entry when the imported data is saved. If these are legitimately separate entries, you’ll need to process them manually.
  • If both Rating columns contain data on any given line of the file, whichever column appears second in the file will take precedence.
  • The importer works best in Chrome, due to its superior JavaScript engine. If you’re having trouble importing large files, try breaking them into multiple parts (ensure that the first “column header” row of the file exists in each part).

Additional tools

If you create a helper script that generates files for our importer, let us know.