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
    (or %appdata%\Roaming\Adobe\Lightroom\Modules)
  • 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.

Plugins for LR

Lightroom might ask you if you want to upgrade your catalog, which is normal, no worries :)

Basic Usage

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).

Publish Service

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 http, www or not www, and don’t include /wp-admin or /wp-login. You will be able to get the Token on your User Profile, the in admin of your WordPress website (click on Generate Token).

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 , you can link your Lightroom fields to your WordPress fields. On the first upload on a photo, those fields will be used. On future synchronizations, only the ones checked below will be updated. You can choose this way to manage those fields in WordPress rather than in Lightroom.

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).

Image Sizing

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.

WP/LR Sync - Filename

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.

WP/LR Sync Library Filter

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.

Previous Uploads

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 built on the WordPress-side.

You also might want to optimize those images’ size. I have prepared a guide for you here: Image Optimization for WordPress.

Go further

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.