Importing from Letterboxd

Letterboxd exports your entire film history as a single ZIP file. That file can go straight in here.

Getting your export

In Letterboxd, go to Settings → Data → Export your data. You get a file named something like letterboxd-…-utc.zip.

Watch out on Safari. Safari unzips downloads by default, which leaves you with a folder instead of a ZIP. Turn off Safari → Settings → General → Open "safe" files after downloading, or re-compress the unpacked folder.

Uploading it

Pick Letterboxd on the import page and select the ZIP. We look inside the file first to confirm it is one. After that the import runs in the background — feel free to close the page.

What comes across

The ZIP holds several lists of the same films, and we merge them into one item per film:

• Watched, diary and ratings — become your seen films, with the watch date attached. Letterboxd counts to 5 stars and allows halves; we double that onto our scale of 10.
• Your watchlist — arrives as upcoming, so you can use it as a to-watch list.
• Your own lists — each list becomes a tag on the films in it.
• Your reviews — become an article on the film, credited to Letterboxd.
• Your tags — come across exactly as you set them on Letterboxd.

And afterwards

An export only carries the title, the year and the link to Letterboxd. Poster, director, cast, runtime and genres we fetch per film from TMDB. That happens one film at a time on purpose, so with a big collection you'll see posters appear gradually rather than all at once. If a film can't be matched it simply stays put with its title and year.

Films already in your box are skipped — we recognise them by their Letterboxd link. A second import only adds what's new.

The free plan's ceiling

On the free plan your box holds 100 items, and an import counts towards that. At 100 it stops, even halfway through your collection. See Free and Pro.

For what else gets filled in on your films afterwards, see Metadata enrichment.