WP/LR Sync requires a plugin on the Lightroom side and another plugin on the WordPress side. The WordPress plugin can be found on the official WordPress repository. You can also install it directly from your WordPress by looking for “WP/LR”. There is nothing else to set up on the WordPress side.
Get a Key and the Plugin for LR
You need to get a key on the Meow Apps Store here: WP/LR Sync (or the button on the left). By doing so, you will also get the latest version of the Plugin for LR.
Unzip the plugin for LR in the directory where the plugins are kept on your system.
- Windows: \Program Files\Adobe\Adobe Lightroom Classic
- Mac: /Applications/Adobe Lightroom/Adobe Lightroom.app/Contents/PlugIns
Note that the uncompressed directory (from the zip) should be named wplr.lrplugin. The .lrplugin part of the filename is how Lightroom recognizes that it is indeed a plugin. Restart your Lightroom. In your Lightroom Plugin Manager, the plugin should appear. Enable it.
If it is not listed, you will need to add it manually through the Add button and look for that .lrplugin file (you can try to go through File > Plugin Manager in Lightroom). If this explanation is not enough for you, check Jeffrey Friedl’s page about it: how to install Lightroom plugins.
Lightroom might ask you if you want to upgrade your catalog, which is normal, no worries :)
Add a new WP/LR Sync Publish Service. Go the the Publishing Manager, click Add, and select WP/LR Sync.
Note: Don’t use more than one catalog to sync with a particular website. You can, however, create many Publish Services in one catalog for the same website. In that case, all the photos must be different. I recommend you to have a one to one relationship between your website and your Publish Service (and therefore, one catalog).
The window containing the settings of the Publish Service for WP/LR Sync should appear.
The Serial (License Key), The WordPress URL of your website, and the Token are mandatory fields. The WordPress URL should be the base URL of your website. Be careful with the https or
Once entered, click on the Log In button and you will be able to save those settings and use this new service immediately.
If you get an error, please check this: Debug Errors & Connectivity.
In the Synchronization / Meta section
Important ! You should tweak the settings a bit. I actually suggest you the settings below. If you don’t set any limits (Image Sizing), the generated images might be too large and WordPress (or any other plugin) might generate an error or a timeout. Do not worry much about the Resolution (set at 240ppi here – if you do, have a look at this article).
Note : WP/LR Sync don’t generate those final images. The section of the settings presented above is actually part of Lightroom engine. WP/LR Sync only ships and synchronizes the files.
You are all set! Like a normal Lightroom Publish Service, you can drag & drop photos in the folder called Photos and Publish them. If you make any modification on those photos, you will be able to synchronize those changes via the Publish button.
Photos added in the collection called Photos will be only available in the Media Library, and that’s fine.
If you create collections, smart collections (in folder(s) or not), the photos in those will be also available in your Media Library. The hierarchy of folders and collections is stored internally by Photo Engine (in WordPress) and can be used by themes or other plugins through the extensions, or the Media Organizer (we’ll look into this later).
Customize your filenames
In the settings of the WP/LR Sync Publish Service, you should define the way those filenames are decided. Here is what it looks like.
There is no correlation between the filename of your photo on your hard-drive (in Lightroom) and the one used by WordPress. The first time WP/LR Sync uploads a photo, this filename (based on the File Naming screen) will be used. Then, on further synchronizations, the filename will rename the same one (to avoid breaking anything in your HTML, by safety).
If you wish to rename your files after they have been uploaded to the Media Library, have a look at the Media File Renamer plugin.
Folders and Collections
In the List Mode of the Media Library, a new filter is added by Photo Engine. You will be able to pick the collection, and filter by it.
Better, you can also enable the Media Organizer.
Alternatively, there is also the Media Browser which adds a sidebar on the left of the standard Media Library.
You can also enable the Debugging Tools in the Settings. Then you will be able to check the hierarchy of collections but also the hierarchy of keywords and other things. All this data can be consumed by other plugins and themes through the WP/LR Sync API.
If you want to take care of (= linking) all the photos that you previously uploaded before using WP/LR Sync, the next step is to use the Total Synchronization module.
Optimize the Images
Congratulations, you are now uploading your photos from Lightroom. You might want to use the Perfect Images plugin in order to add High-DPI (Retina) support and to make sure only the image sizes you really need are
You also might want to optimize those images’ size. I have prepared a guide for you here: Image Optimization for WordPress.
Do you want to go further, and sync WP/LR Sync with your theme portfolio, galleries, or something else? WP/LR Sync is very powerful and can do a lot of things for you. Check about the extensions.