Sync a shoot onto your photos in Lightroom
Rundown can write a shoot's caption, credit, location and keywords straight into Lightroom Classic, onto the frames you have selected. You set it up once. After that it is three clicks per shoot.
Before you start
- Lightroom Classic, on Mac or Windows. The cloud version of Lightroom accepts no plug-ins, so this only works in Classic.
- Your Rundown sign-in.
- The shoot has to be assigned to you in Rundown. The plug-in can only ever see your own shoots — never anyone else's, and never the whole team's.
Setup is the same three steps as the Lightroom card in your Rundown settings, in the same order: install the plug-in, then make your key, then paste it in. The key comes last on purpose — it is shown once, so you want Lightroom open and waiting for it.
Step 1 — Install the plug-in
Open your Rundown settings. On the crew view, tap Me at the bottom of the screen. Anywhere else, click your initials in the top-right corner and choose Settings.
Or go straight there: your settings → Lightroom. It is the card headed Stamp a shoot's details onto your photos.
Click Download the plug-in.
Double-click the zip to unzip it. You get
Rundown.lrplugin(a single file on Mac, a folder on Windows).Move it somewhere permanent that won't be cleared out or synced to the cloud — not Downloads. Lightroom loads the plug-in from wherever you put it, every time it starts, so if it is later deleted, moved, or swapped for a cloud placeholder, the plug-in stops working.
In Lightroom Classic: File → Plug-in Manager…, click Add, choose
Rundown.lrplugin, then Done.If File doesn't show Plug-in Manager, close any open Lightroom dialogs first.
Step 2 — Make your Lightroom key
Lightroom has nowhere safe to keep a password, so it uses a key instead: a long one-off code that can only read your own shoots, can never change them, and that you can switch off from Rundown at any moment without touching your computer.
Back in Rundown, on Settings → Lightroom, click Create Lightroom key.
The key appears, once. Leave the page open and go straight on to Step 3.
Step 3 — Paste the key into Lightroom
In Lightroom, open File → Plug-in Manager… again and click Rundown in the list down the left-hand side.
In Rundown, click Copy key and paste it straight into Lightroom's Access key box.
Server should read
https://rundown-api.ryan-d90.workers.dev. If it doesn't, paste that in.Click Check the key. It should answer Connected as — and your own name. That is the whole setup.
There is nothing to recover. The key is shown once and Rundown keeps no readable copy of it — that is the point of it. Click Make a new key: you get a fresh one, the old one stops working the instant it is replaced, and you paste the new one into Lightroom. Nothing else needs redoing.
If you think someone else has seen your key, Turn off ends it without making a replacement.
Quit Lightroom before you replace the plug-in's folder, then open it again. Lightroom keeps a list of the plug-in's files while it runs; swapping the folder underneath it can make it report An error occurred while reading the schema for the plug-in and turn the plug-in off. Quitting and reopening clears it.
Lightroom remembers the plug-in's settings even after you remove it, so a new version keeps your key and your Server. If the Plug-in Manager says Server points at this computer, click Use Rundown's server.
The first time version 1.2.0 loads, Lightroom asks to update your catalog for the plug-in. Let it — that is where the plug-in keeps its note of which keywords it added, so that Replace can take them back off later.
Step 4 — Sync a shoot
In the Library grid, select the frames from one shoot. Everything you have selected gets that same shoot's details, so do one shoot at a time.
Library → Plug-in Extras → Sync from Rundown…
It's under the Library menu at the top of the screen. From version 1.1.1 it is also under File → Plug-in Extras; on older versions that is a different menu and won't show it.
Rundown lists the shoots it holds for you. The one taken on the same day as most of your selection is already chosen — change it from the list if it has guessed wrong. Underneath, the panel spells out exactly what is about to be written. Read that before you apply it.
Set the three tick boxes (below), then click Apply.
If any of the photos were taken more than two days away from the shoot, the plug-in names their dates and asks first. Cancel if they belong to another shoot; Apply anyway if the camera's clock was simply wrong.
The three tick boxes
All three start ticked — so unless you change something, a sync overwrites what is already on the photos. That is the right default for almost everything, and Undo puts it back; the one time to think about it is below.
| Tick box | What it does |
|---|---|
| Write the shoot's IPTC metadata | The caption, headline, job identifier, date, sublocation (the building and room), city, state and country, creator (you), credit line, source, description writer, your studio's contact details, and your team's copyright notice (with the copyright status set to Copyrighted) and rights usage terms. The team-wide ones — source, description writer, job title, contact details and the rights — are set by an admin in Settings → Photo Metadata. |
| Add the shoot's keywords | Adds the shoot's keywords as Lightroom keywords, creating any your catalogue does not have yet and nesting them the way Rundown does. |
| Replace values that are already there | Ticked: it overwrites. Fields are replaced with this shoot's, and keywords an earlier Rundown sync added are taken off — so syncing the right shoot over the wrong one leaves only the right one. Keywords you added yourself always stay. Unticked, it only fills in fields that are empty and leaves anything already there alone, and it adds keywords without removing any. Untick it if you have hand-edited captions on these frames. |
Which shoots show up in the list
The ones assigned to you, from the last two weeks through today, plus the days around when most of your selection was taken. So a shoot from last Friday is there on Monday, and a shoot from last month is there as soon as you select its photos — the capture dates bring it in. A single photo with a very different date does not change the list; you are warned about it before anything is written instead.
If a shoot you expect is missing, the two things to check are that it is assigned to you in Rundown, and that the photos' capture dates in Lightroom are right — the plug-in works out which dates to ask about from the selection itself.
Undo is one step
This surprises people, so it is worth saying plainly: however many photos and however many fields and keywords it just wrote, the whole apply is a single step in Lightroom's history, called Sync from Rundown. Edit → Undo Sync from Rundown puts all of it back at once. You do not have to undo photo by photo.
The one field the plug-in cannot write
Everything the Rundown sidecar carries goes onto the photo except one field: the IPTC Extension Event, which holds the job-type code. Lightroom's plug-in interface simply does not offer a way to set that field, so the plug-in leaves it alone rather than pretend. This is a limit of Lightroom, not something that gets fixed by reinstalling.
If you need the Event on a frame, use the sidecar instead: open the job in Rundown and click Export XMP on the job sheet.
Empty fields are never blanked
If your team has not filled something in on a shoot, the plug-in skips that field rather than writing an empty value over what is already on the photo. That includes the copyright: if your team has not set a notice in Settings, whatever your import preset put there stays. The one exception is a field an earlier Rundown sync wrote: with Replace ticked, that is cleared, so the wrong shoot's details do not outlive the right one.
When something goes wrong
| What it says | What to do |
|---|---|
| An error occurred while reading the schema for the plug-in | The plug-in's folder was replaced while Lightroom was open. Quit Lightroom (⌘Q), open it again, then in File → Plug-in Manager select Rundown and click Enable. |
| No access key yet | The key has not been pasted in. Go back to Step 3. |
| That access key does not look right | Usually a half-copied paste. The key is 64 letters and digits with nothing else in it. Make a new one and copy it with the Copy key button rather than by selecting the text. |
| Rundown did not recognise that access key | It has been replaced or turned off — making a second key always ends the first. Make a new one in Rundown and paste that in. |
| Could not reach Rundown / Rundown did not answer | A network problem, or the wrong server address. Check your internet connection, then
check that Server in the Plug-in Manager reads
https://rundown-api.ryan-d90.workers.dev. If Rundown opens in your browser but the plug-in still
cannot reach it, a firewall or VPN is the usual cause. |
| Rundown had a problem answering | Something went wrong on Rundown's side, not on your computer. Try again in a minute. If it keeps happening, tell whoever runs Rundown for your team, and include the status number at the end of the message and which shoot you were syncing. |
| No shoots found | Check the shoot is assigned to you in Rundown, and that the selected photos' capture dates are right. The message names the dates Rundown searched; if it says it stopped early, select only the frames from one shoot. |
| Some photos don't match this shoot's date | Some of the selection was taken more than two days from the shoot you picked. If those dates are right, cancel and select only this shoot's frames. If the camera's clock was wrong, click Apply anyway. |
| Nothing selected | Select the photos in the Library grid first, then run the command again. |
| Synced, with some fields skipped | Everything else was written. The message names the fields Lightroom refused — pass that list to whoever runs Rundown for your team. It is corrected in Rundown, so you will not have to reinstall anything. |
Your Rundown calls these people Crew; every team picks its own word, and video and audio people hold the same role. The buttons and menus named on this page say the same thing whatever yours is.