Installation & Errors

For now, the installation is manual and might appear tricky for the user: I really apologize about that!

In short: unzip, keep the files in a folder called wplr.lrplugin (the .lrplugin in the folder name is important) and pick this folder as the plugin in File->Plugin Manager in Lightroom.

Jeffrey Friedl (author of many LR plugins) wrote an amazing article about how to install those plugins. It is the best article so I don’t even want to attempt to write a better one. It is here: Installation and Management of LR Plugins.
URL could not be found, LR cannot communicate with the WP/LR Sync, unresponsive login or sync, few photos are uploaded then it fails, etc? Check the Debug Connectivity page.
It is very simple, as it is only one: /?wplr-sync-api


You can learn about it here: The default post types in WordPress are pages, posts and attachments. Themes and plugins can create additional ones, for instance, galleries, videos, products, etc.
Envira and NextGEN are plugins that are working only with themselves. If you use NextGen or Envira to upload your photos to Lightroom, they will not be usable by another gallery plugin (or even the core Media Library in WordPress) if you wish to switch one day in the future. You will need to re-create everything from scratch. That is why WP/LR Sync was created. It synchronizes naturally with WordPress and has a powerful API that allows any other plugin, gallery or theme to plug into it and use its data.
The plugin doesn’t decide in which order to send the files, Lightroom does. And WordPress decides how to display them in the Media Library. There is no manual ordering possible in the Media Library, that is technically not doable (or that would be really tricky).

In the Media Library, the images are ordered by a field internally known as Upload Date, it is shown as the Date column. So basically the latest image you upload will be at the top. In Lightroom, you can choose that by drag & drop the images about to be sent for the first time (in New Photos to Publish). Then Publish. The last image to be uploaded will appear first in the Media Library.

Another way is to use the Use Photo Taken Date. I recommend this because the plugin will override the default process and use the Taken Date of the photo as the Upload Date. That will make your Media Library clean, with useful and re-usable data.

If you want to order images within a gallery synchronized by WP/LR Sync, this is possible. You need to use Custom Order in Lightroom for this specific gallery, and trigger a Re-Publish for any photo within this gallery to trigger this ordering update.
If you have caching on your server (or a CDN) then the photos might not be refreshed. The plugin cannot do anything about it so you should try to reset your cache and/or you CDN. The refreshed photos should appear after that.

Of course, this could be the cache at many different level, so depending on the plugins and systems you are using for this, the way to resolve it is very different. Photon is also known to do that.

The only way to make sure the new image has been uploaded and synchronized, is to download the file by FTP and open it. Please do this before trying to check if there is an issue with the plugin itself.
For this to happen you need to either have a WordPress field link to ‘Keywords’ or you need the ‘All Meta’ box to be checked.
Check the module called Switch Photos (Library > Plugins Extra). You can then select two photos (the current one that you have in your WP and the one you want to exchange it in your LR and then it will be done. Easy!
The easiest way to do it would be to use the plugin called Media Library Assistant. If you have a problem, the developer behind it is very helpful and you can check this WordPress thread, it is quite useful.
Another way is to take advantage of the API available in WP/LR Sync. One of my users, Geet, wrote some code that keeps his custom meta (city, country) synchronized from the IPTC information. The code is available here.

The plugin considers that the language you are using in Lightroom is the default/base language you are using in WordPress. Therefore, on a fresh first new upload, all the media translations will received the texts from Lightroom and will be the same as the default media. The following synchronizations will not update those translations’ metadata anymore since they are supposed to be… translations :) However, the default translation will always be synchronized with LR. I believe it is the way it should work.

Post Types Extension

Check if you are using the “Reuse” feature in the settings of this extension. It is maybe the case that you have another post type somewhere else using the same title for your collection, or that you have a deleted one that has the same name. In both cases, WP/LR Sync will re-use it. Find it and delete it definitely, or disable the “Reuse” feature.
Enable the Debugging Tools, and check if the Hierarchy (the area on the right) is correct. This is what WP/LR Sync exactly knows about your Lightroom. If it is wrong, try to Re-Publish many of your images from the LR side, which should update the hierarchy maintained by WP/LR Sync.

Is the Hierarchy is right but your WordPress doesn’t have the Posts/Pages/Galleries (or whatever you linked it to) the same, try to Reset the Extensions, then Sync the Extensions again (in the Extensions menu). That will call your extensions (and therefore, the Post Types extension) to re-do everything.

Total Synchronization

Lightroom has a weird way to handle plugins and I would rather have the Total Sync available through a contextual menu. However, we cannot do that (Lightroom is very restrictive for developers). I took a screenshot of where you can find the module, click here.
If you want it to be faster, you can run the hashing process by yourself (Advanced tab) on all your photos using the fastest service you have (you can use a WordPress installed on your own machine). Those hashes can then be used for matching with any other service, it only has to be done once per photo.
No problem: in the LR Sync column of the Media Library there is an input field for the LR ID. Type in a ‘0’ and ‘Link’. The photo will be marked as ‘Ignored’. You can also do this during the matching.
How you manage those duplicated photos is up to you but personally I like to avoid this case. In WP/LR Sync, there is a dashboard that will show you the duplicated photos you have (based on the links between LR and WP). To enable this dashboard, go to Settings > Media and check the WP/LR Tools. Now go in your Media menu and there will a new WP/LR screen.

Issues with Extensions

Real Media Library

If you are a user of the Real Media Library extension built-in WP/LR Sync, this extension is now deprecated and has been removed from the plugin in 2019. But don’t worry, that doesn’t mean that you are not able to use WP/LR Sync with RML, on the contrary! Matthias – the developer of Real Media Library – is in charge of the extension of his plugin.

Install the extension made by Matthias. It is available on the WordPress repository, here: WP/LR Sync Folders.

If any issue with this extension, please use the Support Threads related to the plugin. They are here. Also, don’t hesitate to leave a review for Matthias’ hard work. Thank you :)