Installation and Management of Lightroom Plugins
Quick Links

· My Lightroom Goodies
· My Photo-Tech Posts
· My Blog

Plugins are added and maintained via Lightroom's Plugin Manager, which is accessible from Lightroom's File menu, and also from a button on the Export Dialog itself.

Here's a screenshot of the Plugin Manager on my system, after I installed half a dozen plugins. At the moment, it's showing my “Metadata Wrangler” plugin selected. Mouseover the labels at left to highlight areas of the screenshot...

(Mouseover items below)
  • List of plugins I've
    already installed
  • Install new plugins here
  • Info / tools for the
    highlighted plugin
  • Some plugins provide
    additional sections
  • Opens Adobe's
    Plugin Exchange
    in a browser

Installing a New Plugin

(short version)

Installing a plugin for use with Lightroom usually involves these steps:

  1. Downloading a zip file from a trusted plugin source.
  2. Unzip the plugin, and move the resulting “...lrplugin” folder to wherever you'd like to store your plugins.
  3. Bring up Lightroom's Plugin Manager and tell Lightroom about that folder via the Add button.

Installing a New Plugin

(long version)

0. Clean out old versions of the plugin, if applicable.

If you're about to do a reinstall, it may be prudent to delete any old versions of the plugin from your drive so as not to confuse what you download and unzip later.

1. Download a zip file from a plugin source

Plugins are available from a variety of sources. My plugins are available from my Lightroom goodies page. I also list there other notable sources.

Warning: a Lightroom plugin has as much access to your system as Lightroom itself, so for most people this means that a Lightroom plugin can access (and read/delete) any file on your system, so when choosing to install a plugin, exercise the same prudence you would use when downloading programs from the Internet. Just as when choosing to install a program, choosing to install a Lightroom plugin involves trusting that the programmer is both trustworthy and competent.

Some browsers unzip the download automatically for you, and with others you unzip it yourself. In either case, you should end up with a folder whose name ends in “.lrplugin” or“.lrdevplugin”. (On a Mac, a “.lrplugin” folder actually appears as a “module” package.)

You don't normally ever need to be concerned with the contents of a plugin folder, but if you need to confirm that the folder actually contains a plugin in the first place, check for an “Info.lua” file. (On Macs, you may need to “Show Package Contents” in Finder to view the files inside.) I mention this because some programs that produce zip files create a “....lrplugin” folder into which they drop the actual plugin “.lrplugin” folder, which can cause confusion.

2. Move the plugin folder to wherever you'd like to store your plugins

Lightroom allows you to keep the plugins wherever you like — you just have to tell it where you place each one — so it's up to you to pick a spot to save them. Perhaps a Lightroom Plugins folder in your Documents?

When you Add the plugin to Lightroom, you're just adding a reference to the location. It's only natural to think that a copy of the plugin was made when you Add, but Adobe doesn't do that, so be sure not to delete the plugin files from disk.

3. Tell Lightroom where the plugin is

Bring up Lightroom's Plugin Manager, either from the File menu, or from the Plugin Manager button on the Export Dialog. Click the Add button, then navigate to the “.lrplugin” item from the previous step.

Kinds of Plugins

Plugins can add functionality in any combination of the following:

  • A Publish Plugin adds a new publish service to the list available in the lower left of the Library Module, in the Publish Services panel.

  • An Export Plugin adds a new destination to the list available in the “File > Export...” dialog. See here.

  • A plugin can add export filter modules that can be used with any Export or Publish action. See here.

  • A plugin can add features to the “File > Plug-in Extras...“ and/or the “Help > Plug-in Extras...“ menus.

Again, a plugin can have any combination of the above. In particular, plugins that send files to remote photo-hosting sites can be Publish only, Export only, or both Publish and Export.

A plugin might not provide services through any of the methods shown above. My Folder Watch plugin, for example, provides all of its services from the Plugin Manager itself.

Using an Export Plugin

An export plugin can be selected by bringing up Lightroom's export dialog, then clicking on the “Hard Drive” popup menu at the top...

That brings up a list of the export handlers available, the three built in items (Email, Hard Drive, and CD/DVD), as well as any added by plugins that are both installed and enabled...

Using a Filter-Module Plugin (a “Post-Process Action” Plugin)

Some plugins provide generic support that can be used with any Publish or Export action. For example, my Metadata Wrangler plugin allows you to strip selected metadata from exported copies as they are produced. It can be used with any Export or Publish action, whether via Lightroom standard methods or unrelated plugins.

Adobe calls these “Post-process Actions”, but most people call them “Export Filters”.

Once you've added and enabled a filter plugin via the Plugin Manager, it shows up in the lower-left of the export dialog....

Click on its name, then the Insert button at the bottom, and you'll see it added to the main dialog. In the screen snippet above, the “Metadata Wrangler” dialog section is shown collapsed, so you only see its banner. If you were to click on the little triangle beside the name, you'd see the full dialog for the plugin, which, in this case (my Metadata Wrangler filter) is huge (see here for a screenshot).

Plugin Maintenance & Upgrades

Once a plugin has been installed with Lightroom, you can enable or disable it from the Status section of the Plugin Manager. A disabled plugin can't be used from within Lightroom, but remains available in the Plugin Manager, so it can be easily enabled when you want to start using it again.

You can have Lightroom forget about a plugin with the Remove button, on the bottom of the left-hand column.

If the Remove button is grayed out for a particular plugin, it's because the plugin is located in Lightroom's system area. Such plugins can be removed only by deleting the plugin files from disk.

The Status section might also display plugin version and web-site information, if the plugin provides it (such as in the screenshot above).

Upgrading a plugin

Upgrading a plugin to a newer version is similar to installing the first time, except that if you replace the original “.lrplugin” folder with the new one, you don't have to re-register the location with Lightroom. In that case, you simply need to restart Lightroom, or click the “Reload Plug-in” button in the Plugin-Manager's “Plug-in Author Tools“ section.

If you install the new version in a new location, and register it via the Plugin Manager, the previous version will remain, but be disabled. You can enable only one version of any particular plugin at a time. Simply Remove the older versions when you no longer need them.

Upgrading one of my plugins

I've built an upgrade mechanism into my plugins, such that when a new version is available, you can simply press the Upgrade Now button in the Plugin Manager. That causes the new version to be downloaded and unzipped in place over top of the old version. You then press the Reload Plug-in button, or restart Lightroom, to have the new version take effect.

(If something goes wrong with the upgrade process, you'll have to manually download and install the new version. In such a case, you might want to inspect the log file left in the temporary-files area of the system, named for the plugin, e.g. “flickr-log.txt” for my Flickr plugin).

The 30 most-recent comments (out of 207; see all), most recent last...

Hello – I am trying to use the Photobucket plugin and can get it enabled, but when I try to export and authenticate I get an error message “Couldn’t authenticate to photobucket: Unexpected HTTP error…” I can get the other plugins working, but this one doesn’t seem to want to work. I’m not logged on anywhere and didn’t see a place for that. I’m on a trial version of LR. Thanks!

It’s difficult to guess from just this. Perhaps send a log the next time you run into it. —Jeffrey

— comment by Brad on November 24th, 2013 at 1:26pm JST (3 years, 5 months ago) comment permalink

Short story …. i bought a license for LR4 from a un-trusted source … shame on me … your plugin to export to Zenfolio no longer works.

I re-downloaded your plug in, Made a NEW donation, and upgraded to Photoshop CC and LR5. When i try to install your zenfolio plugin into LR5 , it is still saying disabled. How do i get it to let me register my new donation?

Thank you

The top section of the plugin manager tells you exactly what to do. —Jeffrey

— comment by Sean on December 19th, 2013 at 11:52am JST (3 years, 4 months ago) comment permalink

Many thanks for the Preview Extraction plugin. Worked great. Much appreciated!!

— comment by RSwift on January 17th, 2014 at 7:13pm JST (3 years, 3 months ago) comment permalink

Hey thanks for the great plugins!!!!! Toledo, Ohio photographer here.
Quick question…I have the fb plugin and the zenfolio plugins. I started working at a studio and they have their own copy of LR and I have my own copy at home. But I often take a LR Catalog back and forth between work and home. Will I be able to use the plugins in both places or not? If not is there a way to do so?

Adobe doesn’t make it easy, but it’s possible. You probably want to have the catalog and the master image files on a removable disk that you bring with you. Then you have your preferences, which you’ll likely have to set at both places. Then if you use special lens correction profiles, or sensor calibration profiles, etc., and presets of all manner, those also have to be replicated. (Many find Dropbox or the like useful for that.). The Lr/Backup plugin saves all these different files, so you can look at what it does to learn about what’s there to be replicated. —Jeffrey

— comment by Jen on March 26th, 2014 at 10:45pm JST (3 years ago) comment permalink

When I try to update Picasa with your plugin I always have this error “Unexpected HTTP status from Google: 400
Error trying to parse element.”

I used lightroom 5.6 (64bits)

What can I do?

It’s probably just a glitch by Google, but if it persists then send a log after encountering the error… —Jeffrey

— comment by Emilio on April 26th, 2014 at 8:46pm JST (3 years ago) comment permalink

Initial success installing and using Google Drive plug-in on Lightroom 5.4, uploaded about a dozen pictures no problem.

Subsequent attempts to update/reupload and add new pictures consistently fails and return s

“Unexpected HTTP status from Google: 400
Invalid multipart request with 0 mime parts.”


Win7/64 I7 16Gb RAM

I believe this is a Lightroom bug… I’ve heard of it from time to time, where the plugin prepares everything to send to Google, but Lightroom sends only the header then tells Google it’s done. I’ve reported it to Adobe; beyond that, I can only cross my fingers and hope it doesn’t rear its ugly head very often. —Jeffrey

— comment by wtlloyd on May 1st, 2014 at 10:24am JST (3 years ago) comment permalink

Photobucket plugin not showing on LR5.4, Picasaweb is working correctly though and I installed both the same way. Photobucket shows in plugin manager but not in the Publish Services. Any ideas?

The Photobucket plugin has never been Publish… only Export. —Jeffrey

— comment by Gavin on May 17th, 2014 at 6:39pm JST (2 years, 11 months ago) comment permalink

Hi Jeff,
The export to Zenfolio plugin says “Plugin Registration button appears here after Lightroom is registered with Adobe” I’m registered with Creative Cloud. Any ideas?

It’s a known issue as of yet without a known fix. )-: —Jeffrey

— comment by Daniel on June 27th, 2014 at 6:54am JST (2 years, 10 months ago) comment permalink

Hi, Jason writing from Oakland, CA, here.

I’m wondering if your LR->Facebook plugin will cure the dreaded “via Adobe Photoshop Lightroom” text in Facebook posts. This text drives me crazy.



Unfortunately, no, as far as I know, Facebook does not give users a choice to suppress the name of the upload app. Flickr does, FWIW, but FB chooses to make it obligatory. —Jeffrey

— comment by Jason on July 17th, 2014 at 3:02pm JST (2 years, 9 months ago) comment permalink

Hi, I reside in Melbourne , Australia.
I am using your Metadata Preset Builder plugin. Each time I restart LR5 the Metadata preset goes back to default. I was using it last year on another system and this didn’t happen – have I done something wrong while installing. I have just updated the plugin and it still reverts to default at start up.

It sounds like a classic symptom of your Lr preferences file going bad. —Jeffrey

— comment by Rex Harris on November 3rd, 2014 at 1:31pm JST (2 years, 6 months ago) comment permalink

writing from the San Francisco area…..I have used your export from LR to Zenfolio happily for years. Suddenly now whenever i export, it will only upload to one specifc folder from 2010. I try to create a new gallery but it doesn’t seem to see it. under upload destination it tells me that this old 2010 gallery is selected and I can’t seem to unselect. I’ve tried trashing the plug in and reinstalling it to no avail. Any thoughts on how to get this working again? Thank you!

Are you sure that when you try to create a new gallery, you’re not accidentally creating a new group instead? Groups don’t show up in the destination list. —Jeffrey

— comment by hilary Hood on December 10th, 2014 at 7:15am JST (2 years, 5 months ago) comment permalink

Thank you for your effort. I appreciate it!

— comment by Jogi on March 21st, 2015 at 10:18pm JST (2 years, 1 month ago) comment permalink

Is it possible in the folder status plug in to change the size of the box so I can include more columns horizontally. Thx. This is a really helpful plugin (and it successfully included my statuses as I moved to CC)

Unfortunately, Lightroom really limits plugins with regard to UI flexibility. If there are too many fields to fit in the width, it should automatically scroll, but sadly Lightroom doesn’t let the plugin just fill the width of the screen. )-: —Jeffrey

— comment by alan on April 26th, 2015 at 2:05pm JST (2 years ago) comment permalink

Excellent work as always Jeffrey, your Flickr/Facebook/Twitter plugins are an absolute must have for me. I keep banging on about them to all my Camera Club members.
I have just upgraded to Lightroom CC, so expect a whole bunch of donations again soon….

— comment by Danny on April 29th, 2015 at 4:40am JST (2 years ago) comment permalink

I am moving my lightroom to a new computer, how do I transfer my folder status program? I want to keep the information already stored in it. I am actually delaying the move until I find this out, I am 100,000 photos in my review (of 250,000 photos) and can’t afford to lose the info.

I love this plug in!



Folder Status keeps its data in the catalog, associating the data about a folder with its path. If you copy the catalog, and the folder paths remain the same on the new system, then everything will just work out right. The plugin also writes data to each folder in the form of a hidden file (“.Lr-folder-status-plugin-data”), so if folder paths change, the plugin can revert to the hidden file to access current settings. —Jeffrey

— comment by alan on May 16th, 2015 at 12:12am JST (1 year, 11 months ago) comment permalink


Recently moved LR5 to a new drive almost everything came over except your plugin for Zenfolio. It says the “nil” file is not installed or working properly. So I decided to download a new copy of the plugin. Unfortunately it will not unzip. Whenever I click on the download file it just tries to open LR and import your logo. Any thoughts?

It sounds like your browser automatically unzipped it for you, so just move it to where you want it to live on your system, and point Lightroom’s Plugin Manager at at. But, if it truly is a bad download, try with another browser. For reasons I’ve never understood, some folks have trouble with one browser but not another. —Jeffrey

— comment by Byron Capo on May 29th, 2015 at 12:25pm JST (1 year, 11 months ago) comment permalink


I just installed the plugin ” timelapse support” , but I do not understand how to operate in lightroom .
I took a sequence of pictures, click plugin extra, fade developp setting, and then ?
I exported the pictures but nothing is corrected.

Thanks for your help, Phil

Yeah, sorry, I really need to write the docs. If you want to vary some develop settings (e.g. exposure) across a set of photos, make whatever adjustments you want for the first and last photos, then select those two and all the photos in between, then invoke the fade dialog… the plugin will incrementally adjust the settings you select, for the photos between the first and the last, to ramp them between the first and the last. —Jeffrey

— comment by Phil on July 1st, 2015 at 6:11pm JST (1 year, 10 months ago) comment permalink

I have tried everything I suggested and Zenfolio gives me no option to upgrade. Which I have already done and is living on my computer. It seems to be focused on an old version.
Really need this ASAP.

I’m not sure what you’re saying (or asking?), but if you want to upgrade a plugin, just delete all copies that you might have on your disk, download a new version, unzip and move it to where you want it to reside on your disk, then point Lightroom’s plugin manager at it. —Jeffrey

— comment by aphra pia on September 8th, 2015 at 8:55am JST (1 year, 8 months ago) comment permalink

I just acquired a secondary laptop to complement my main desktop PC where Lightroom and your Flickr plugin are installed. I have installed Lightroom on the secondary laptop, and would like to install the Flickr plugin as well. (I recognize that I’ll need to register/pay for it and have no issues with that).

My question is: how can I copy the Flickr plugin settings from my main computer to my laptop so that I can maintain (or at least start with) the same configuration on both machines?


Plugin settings are kept in both the preferences file and, for Publish, the catalog. The preference file can simply be copied over, so that’s easy. To clone a catalog, just copy over the LRCAT file and when you open it on the new machine, remove all the images from it (just making sure that you’re not actually deleting images from disk that might still actually be available on the new machine, e.g. via a shared disk). If you want to register the plugin, you can just go ahead and use the same registration code as on the main computer, if your LR serial is the same as on the main computer.—Jeffrey

— comment by Eric on September 29th, 2015 at 2:25am JST (1 year, 7 months ago) comment permalink

Yesterday I downloaded and registered the plugin “Metadata-Viewer Preset Editor”. It is working. I made two metadata presets and saved them in the “Metadata Presets” folder. I know it’s the correct folder because it also has the two copyright custom presets that I made with Lightroom. The two new metadata presets have the same file type name.

But the presets do not appear in Lightroom. I tried putting copies at the root level for presets, i.e. the Edit-Preferences “Lightroom Presets Folder”. I also tried creating a folder named ” User Presets” in the “Metadata Presets” folder (as is found in some other presets folders but not others). None of these attempts worked.

The two newly created presets do not appear as presets in the Metadata panel. Am I doing something wrong?

Are you perhaps confusing two kinds of presets, one being “what metadata fields are to be shown?” (which is the kind of preset that this plugin works with; they are selectable via the dropdown menu in the “Metadata” section header), and the other being “update the image metadata with this specific data” presets (selectable via the dropdown menu at the top of, but still within, the “Metadata” section)? —Jeffrey

— comment by Richard Sweeney on November 17th, 2015 at 4:51am JST (1 year, 5 months ago) comment permalink

Dear Jeffrey,

Thank you so much for your help!!!

I managed to extract the JPEGS from Lightroom with the help of your plugin!!!

Brilliant work!!!




— comment by Amelia on January 6th, 2016 at 12:03am JST (1 year, 4 months ago) comment permalink

First, Thanks for this plug-in.
Secondly, I hate to complain, especially since I haven’t donated yet…but I get this error message.
“PicasaWeb does not accept “.dng” files for upload.”
I want to upload high quality pics. I want to donate too:) but this is a big deal to me.
Can anyone tell me why this is happening? I searched the error message but found nothing. I am using Lightroom 6.

Google’s 3rd-party API, that non-Google apps like my plugin must use, don’t accept DNGs. I’ve heard that Google’s tools do, so I guess they save those goodies for themselves. —Jeffrey

— comment by Eric on January 13th, 2016 at 3:33am JST (1 year, 3 months ago) comment permalink

using LR Facebook plugin – When I create a new collection under a publish service the name seems to be automatically prefixed with [photographer] – is there a way to modify this behaviour so I can either have no prefix or one of my own preference ?

If your account is permissioned for albums for more than one page (your personal albums, plus albums for a business page, shared groups, etc.), a prefix is sometimes applied so that you know which page the album is for. This is shown only in the list (in the Publishing Manager dialog), but shouldn’t show up in the collection name once the collection has been made. If it does, please send a log with full details. —Jeffrey

— comment by Kish Woolmore on March 8th, 2016 at 12:04am JST (1 year, 2 months ago) comment permalink


I’m installing the Folder Watch plug-in. I don’t want it to import files that already exist in Lightroom (no duplicates). Is that a going to be a problem? If so, what do I do?

Thanks for your help.

Dave Stout

If a particular file is already in Lightroom it won’t be added again, but a copy of the file in a different location or with a different name will be imported. The Lightroom import dialog has an “ignore duplicates” feature that avoids importing copies, but Lightroom doesn’t export that functionality to plugins. —Jeffrey

— comment by David J Stout on March 8th, 2016 at 5:17am JST (1 year, 2 months ago) comment permalink

Hi Jeffrey. I am finding that in Lightroom CC (latest version as of 4/24/2016) running on OS X 10.11.4 (with 16gb ram), that when I update any of your four plugins I have installed, that after the update when the “restart Lightroom” message appears, my Lightroom locks up and requires a forced restart. Is this normal now with Lightroom CC? Thank you in advance for any help you can provide!

This is not normal… I’ve never seen this. When I do see something unexplainably strange like this, I wonder whether your Lr preferences file has gone bad. Perhaps reset your preferences, keeping your fingers crossed that it actually does fix whatever is wrong. —Jeffrey

— comment by Rich Harrison on April 24th, 2016 at 9:22pm JST (1 year ago) comment permalink

Hi Jeff,

I’m working on a plugin and I have some issue that I can’t find any answer.
As I think you are at the beginning of lightroom plugins, you probably have some tips 🙂

– Do you know if it is possible to skip “You have changed the settings for this publish connection.” when I change some info from my publish service settings? As my inputs there don’t change any photos, I would like to skip this. In your facebook plugin, it’s worked like that but not in your flickr plugin. So there is probably a way…

– Do you have any tips for your automatic upgrade check? Is it a custom feature you did for your plugin or it’s from Lightroom.

Thank you very much for your time and your blog.
Have a great day!!

The first item is from Lightroom. It won’t let you skip the dialog, but in the dialog you can tell it not to republish the photos, so it should be at worst a 5-second speed bump. About the upgrade check, I’m not sure what kind of “tips” you might be looking for, but I guess I don’t have any. It’s a feature of my plugin. —Jeffrey

— comment by Martin on May 31st, 2016 at 12:55pm JST (10 months, 25 days ago) comment permalink

Hey Jeff,

I’m building a Lightroom plugin as part of my startup’s photo sharing platform. I’m just starting to get a feel for the SDK, and I was hoping to use your Photobucket export plugin as a guide. However, when I look at the lua source files, I am only seeing crazy chacters – no Lua code. Is this intentional on your part to obscure the source code, or is something funky going on? Thanks for your time and keep up the good work!

– Justin

Yeah, the code is not public, sorry. My Picasa plugin for Lightroom 1 is cleartext code, so you can check that out (though it’s pretty nasty). Not that the ‘catalog:withCatalogDo’ method is no longer required after Lr2, so you can dispense with that kludginess. —Jeffrey

— comment by Justin on July 30th, 2016 at 11:28am JST (8 months, 26 days ago) comment permalink

HELP! I organized my desktop and moved the Zenfolio plug-in. Now Lightroom is saying the plug-in is missing. I tried moving it back onto my desktop and restarting LR but that didn’t work. Is there a way to fix this without messing up all my galleries and set-up?


None of your personal data is stored in the plugin folder, so just download the latest version of the plugin and put it wherever you want it to live, then point the Plugin Manager at it via the [Add] button, and you should be fine. —Jeffrey

— comment by Kelly on September 12th, 2016 at 10:41am JST (7 months, 13 days ago) comment permalink

I loaded your Metadata Wrangler with ease and clicked remove on everything. I exported photos as jpeg and they are still the same 13mb and larger files. The size of the files didn’t change at all. I am wanting to remove copyright and all. I want to get the files down to a smaller size. Any ideas?

Metadata doesn’t usually take all that much space, relative to a 13mb JPEG file, which sounds huge. Your best bet to make them smaller is to use a lower jpeg quality setting during export (see An Analysis of Lightroom JPEG Export Quality Settings for guidance). You can also view the exported copy in an exif viewer to make sure that everything you think has been removed actually has been. —Jeffrey

— comment by Lori on October 9th, 2016 at 2:58am JST (6 months, 17 days ago) comment permalink

Jeffrey-I have had your Geo-encoding plugin for Lightroom for awhile and have the most recent version installed. I just imported Nikon RAW images that have GPS data in the Metadata that were put in the images from a new Solmeta GMax gps unit. When I looked at the images in my master LR catalog there was no GPS in the LR metadata.

I later created a new LR catalog to import the same images as a trial and after the geo-encoding plugin loaded it asked if I wanted to enable reverse lookup for the map module, I said yes and imported the images and the GPS data was in the photo metadata and the image location showed on the map.

How do I re-enable reverse lookup in my Master catalog?


Everything you’re asking about is part of standard Lightroom… none of it requires or uses my plugin. Lightroom’s built-in “reverse lookup” setting can be toggled on/off in the Catalog Preferences section of Lightroom Preferences, on the Metadata tab. I’m surprised that the latitude/longitude were not available the first time you loaded, but was the second time. The first time did you perhaps use an import preset that wiped out the location data? —Jeffrey

— comment by Lynn Oakleaf on October 30th, 2016 at 5:31am JST (5 months, 26 days ago) comment permalink
Leave a comment...

Please do not report bugs or other comments related to my plugins here. Please do those on the appropriate per-plugin page (linked from my Lightroom Goodies page).

All comments are invisible to others until Jeffrey approves them.

Please mention what part of the world you're writing from, if you don't mind. It's always interesting to see where people are visiting from.

You can use basic HTML; be sure to close tags properly.

Subscribe without commenting