VIEWLOGUE
Join
Migration & Data Portability

How to Import your Letterboxd Library to Viewlogue

Switching to Viewlogue takes under 60 seconds. You keep your entire film diary, star ratings, review notes, and watchlist with zero data loss.

01

Export your data archive from Letterboxd

Log in to your Letterboxd account on web. Click your profile avatar in the top right $\rightarrow$ select Settings $\rightarrow$ click the Import & Export tab. Click the green "Export Your Data" button.

💡 Letterboxd will download a .zip archive (e.g. letterboxd-username-date-utc.zip) containing your CSV files.
02

Extract the downloaded ZIP file

Double-click the .zip file in your Downloads folder to unzip it. You will see a folder containing watched.csv, ratings.csv, diary.csv, watchlist.csv, and a likes/ subfolder.

💡 Viewlogue supports importing multiple CSVs at once so your entire library updates in one go.
03

Upload to Viewlogue Settings Hub

Navigate to your Viewlogue Settings $\rightarrow$ click on the "Import & Migration" tab. Click "Browse CSV Files" and select your CSV files (or the files inside the folder).

💡 Our matching engine automatically connects every film against TMDB and maps your star ratings, exact screening dates, and diary reviews.
04

Watch your cinephile passport sync in real time

Our stream processor displays an animated live progress bar showing matched titles. Once complete, you’ll see full metric cards and imported title highlights.

💡 Your watched films, screening journals, and review cards will be instantly accessible on both Web and the Viewlogue iOS app.

What files from Letterboxd can you upload?

watched.csvAdds all watched films to your permanent Watched Vault.
ratings.csv & reviews.csvPreserves your star ratings (0.5 to 5.0) and written reviews.
diary.csvLogs exact dates you watched each film, including rewatch tags.
likes/films.csvSyncs all films you loved directly to your Viewlogue favorites.
Go to Settings > Import & Migration→