Installation Issues

Are you using Windows? If yes, the plugin for Lightroom must be unzip (usually, a double-click on the file will unzip it). Then, you can use the folder as the plugin. On MacOS, the (zipped) file is the plugin directly. That’s a Lightroom mystery :)

Connection / Publish Issues

Let’s see why the connection between the LR plugin and the WP plugin is not working. Please check every item of this list carefully. This covers 99.8% of the issues.

If the version of WP/LR Sync on the Lightroom side is before 5.x, then you might encounter issues as it’s not compatible with the latest versions available for WordPress.
Sounds like not a very clever question, but sometimes that might be that the plugin is disabled :) Can you check your Plugins page in WordPress? If not, enable it and try everything again. Also, there are plugins that can disable other plugins or their functions. Please make sure you try to disable all the plugins and test WP/LR Sync alone (such plugin as Plugin Organizer, for example, can do that).
Make sure the WordPress URL you are using on the Lightroom side is the right one. Try it with http¬†or¬†https. It’s often an issue.¬†Also, make sure your token is right.
Now, here is the flow of uploading a file with WP/LR Sync.

1. Lightroom Engine generates the image based on your Export Settings.
2. WP/LR Sync uploads this image from Lightroom to WordPress, as the original (full-size) image.
3. Thumbnails are created. Their numbers depend on your theme, and the plugins you might be using (WooCommerce adds many sizes for example).
4. If you are using a Retina, or WebP plugin, those images are created.
5. If you are using an Image Optimization plugin, all the images previously created will be optimized (that is a heavy operation).
6. More can happen depending on your plugins.

Servers usually only allow 30 seconds for a process to run (here, it concern the Step 3 to Step 6). If this process takes more time, the server ends it abruptly. There is unfortunately not way to go around this. In the case of WP/LR Sync, Lightroom will never ever know if the image was uploaded successfuly or not.

The size of the image generated by Lightroom influences the whole process, in an exponential way. So you should absolutely make sure the image generated by Lightroom isn’t huge. On the Lightroom side, in the Settings of the Publish Service, check the Export panel.

To understand more about timeouts and how to resolve them, have a look at this article:
WordFence blocks everything. I don’t know the version Pro, or way of handling this automatically, but one thing you can do is to add your own IP address to the Whitelisted IP addresses that bypass all rules field in WordFence. Can’t find your IP? Have a look in WordFence > All Options, and it will be shown below How does Wordfence gets IPs.

Another way is to add an entry to the Whitelisted URLs in your Firewall. Try this (yes, the URL is just a slash):

URL: /
Param Type: POST Body
Param Name: filePath

If you find another way to skip Wordfence, let me know (don’t hesitate to contact them).
This issue is not the most common, but it is easy to check. Access your website from the same computer where you are using Lightroom. If you can’t access your website (or that it takes forever to load), it means you have been blacklisted/blocked by your hosting service. Make sure you know your IP address (what is my IP?) and contact your hosting service, asking to be removed from the blacklist and better, to be added to the whitelist.
There are many tools nowadays to prevent us from giving our data to be uploaded everywhere. For example, there is a nice tool called Little Snitch that does that well. But don’t forget, you will need to let Lightroom access Internet to use WP/LR Sync :)
Strato seems to block POST requests by default. I found this interesting image here. Please have a look, that is probably the answer to this problem.
Make sure that the plugin and your website works normally. WP/LR Sync might not work properly if:

–¬†Maintenance Mode is enabled (or using plugins like Coming Soon Page, Maintenance Mode,…)

–¬†Privacy Mode is enabled (hosting services such as¬†Flywheel have a feature called like this)

РThe WP REST API is disabled by a security plugin (for example WP SpamShield and its Disable anti-spam for miscellaneous forms option )
you are using a captcha or something similar that restricts the access, for example by using reCAPTCHA

РThe wp-admin not directly accessible, or the website access has been limited through the .htaccess (the Authentification Required popup)

– Make sure you are not using those plugins: Clef,¬†Google Authenticator, NinjaFirewall+, WP SpamShield, ShieldSecurity, Force Login, etc…

Once you found why it is not working, you need to find an alternative to do what you need.

If the issue comes from a security plugin, you will need to ask the developers of that security plugin to find a way to let WP/LR Sync go through. For your information, WP/LR Sync needs access to the WP-JSON API, and it also uses the wp_authenticate function to resolve your credentials.
You have to be aware that if any other plugin fails or generate an error during the syncing process, WP/LR Sync will be stopped. Therefore, you need to check your PHP Error Logs to make sure nothing happens during the WP/LR Sync process. Check it before using WP/LR Sync, perform an action (or the specific action which failed) and check it again. Did something happen in between?

Your PHP error logs are made accessible by your hosting service, if you don’t know where they are, the best is¬†to ask them. You can also try to use such a plugin as Error Log Monitor¬†(but they don’t always detect the error file). If you are willing to learn more about checking errors by yourself, check this: Monitor PHP Errors. Be careful, the PHP Error Logs is not the Access Error Logs, they are two different things.

Your PHP error logs are empty? It might not be normal, PHP error logs usually have notices, warnings, and errors. Please make sure the errors are actually being logged. For that, you can edit your functions.php (what is functions.php?) and insert such a line:

error_log( “Hello Error Logs!” );

Then load any page on your website, and check your PHP Error Logs again. If they are empty, it means that they are not working. Contact your hosting service in that case. Don’t forget to remove this line from your functions.php.

Alternatively, you can also have a look at your WPLRSync.log located in your Documents folder, it sometimes contains interesting information.
Disable it, and try again. Does it work? Then an option are you are using in JetPack is blocking WP/LR Sync. One is that you need to authorize WP/LR through JetPack -> Settings -> Carousel, find WP/LR at the bottom of the page and enable it.
Disable¬†all the plugins (except¬†WP/LR Sync) and also¬†disable all the extensions you have chosen for WP/LR Sync. Any error or warning generated by any plugin during the WP/LR Sync process will end up with an error for WP/LR Sync. That’s the way it is. Try without any plugins running. It works? Re-active them one by one, until you find the culprit :)

I had myself issues with plugins such as Media Library Assistant and WP Fastest Cache.
Some hosting services are cheap and/or simply not good and basically, reject too easily requests to WordPress API. Alternatively, you can use one of the hosting services I recommend, here.

Did nothing work?

I will not be able to give you more advice than what is on this page. The only way to debug your issue further is to:

  • Get your PHP Error Logs. This file is really necessary for debugging the issue. If you don’t find it, or if it is empty, have a look at this: How to Debug WordPress.
  • Get your WPLRSync.log. This file is on your own system, in the Documents folder. If it is huge, delete it, reproduce the issue, and get the new WPLRSync.log file.
  • Contact me, and share with me those two files, and possibly, access to your install.

It is really important to follow this process to make sure that I can help you. Thank you.