PhotoShelter’s Official Adobe Lightroom Plug-in

 

Adobe Lightroom is a software package that helps you import, process, and manage your photos. The Lightroom Plug-in will allow you to upload your images from Lightroom directly into your PhotoShelter account.

 

Mac: Download & Install

Note: If you’re upgrading a previous version, do not uninstall (delete) your existing plug-in. To update, simply replace your existing plug-in file (i.e. PhotoShelter.lrplugin) with the new file. Follow the instructions as listed in the “Upgrading to the Latest Version” section.

1. Download the plug-in here.

Libris customers: Please visit the Libris Support Center to download the Libris version of the plug-in.

2. Unzip the plug-in file. This will reveal the uncompressed plug-in to import.

Note: If you don't have Lightroom already installed, the unzipped plug-in file will likely not be readable by your computer.

LR1.png

3. Move the PhotoShelter.lrplugin file to your preferred storage location.

4. Launch Lightroom, and select "File" > "Plug-in Manager."

LR2.png

 

5. In the new window, the left pane will reveal all plug-ins currently installed on your Adobe Lightroom application. The green icons next to the list indicate whether the application is currently installed and running. If you do not see the PhotoShelter plug-in here, click on the "Add" button.

lr_3.jpg

6. In the new window, locate the plug-in in the folder in which you opted to store it.

7. Select the plug-in (PhotoShelter.lrplugin), and click the "Add Plug-in" button at the bottom right corner of the window.

lr_4.jpg

8. That's it! If the plug-in was installed properly, the "Installed and Running" status will appear next to the plug-in name.

 

PC: Download & Install

Note: If you’re upgrading a previous version, do not uninstall (delete) your existing plug-in. To update, simply replace your existing plug-in file (i.e. PhotoShelter.lrplugin) with the new file. Follow the instructions as listed in the “Upgrading to the Latest Version section.

1. Download the plug-in here.

Libris customers: Please visit the Libris Support Center to download the Libris version of the plug-in.

2. Unzip the plug-in file. This will reveal the uncompressed plug-in folder to import.

3. Move the PhotoShelter.lrplugin folder to your preferred storage location.

4. Launch Lightroom, and select File > Plug-in Manager.

5. In the new window, the left pane will reveal all plug-ins currently installed on your Adobe Lightroom application. The green icons next to the list indicate whether the application is currently installed and running. If you do not see the PhotoShelter plug-in here, click on the "Add" button.

6. In the new window, locate the plug-in folder wherever you chose to store it in step 3.

7. Select the plug-in folder, and click the Select Folder button at the bottom right corner of the window.

8. That's it! If the plug-in was installed properly, the "Installed and Running" status will appear next to the plug-in name.

 

Upgrading to the Latest Version

To update your plug-in, follow these steps:

1. Make sure you have a backup of your Lightroom catalog saved in a safe location. Do not delete your existing plug-in file. If you do, you will have to rebuild your published galleries from scratch.

2. Download the latest version of the plug-in.

3. Find the location of your current plug-in file by opening the Lightroom plug-in manager and clicking PhotoShelter. You can do this by navigating to "File" > "Plug-in Manager" > "PhotoShelter" > "Status" > "Path."

4. To upgrade the plug-in to the latest version, simply replace your existing file (i.e. PhotoShelter.lrplugin) with the new file. To do this, drag-and-drop the new plug-in into the folder where the old plug-in lives to replace it. Please note that the new plug-in file must have the exact same filename (PhotoShelter.lrplugin) in order for the upgrade to work.

5. Once you’ve replaced the plug-in file, restart Lightroom and navigate to "File" > "Plug-in Manager" to ensure PhotoShelter is enabled with plug-in version 5.25.

 

 

Associating Uploaded Images

If you have images in your PhotoShelter account that were uploaded outside of the PhotoShelter plug-in, you can attempt to re-synchronize them with Lightroom using the “associate images” feature (requires v5.23). You can run this function by navigating to "File" > "plug-in extras" > "Associate Images with PhotoShelter."

This feature attempts to match a single image in Lightroom with a single image on PhotoShelter by comparing file name, capture date, capture time and exif. To prevent mistakes, no association will be made if more than one copy of an image exists in Lightroom or on PhotoShelter. Likewise, the plug-in will not associate images when the data does not match closely enough.

For best results:

  • Lightroom should only contain one copy/version of the image
  • PhotoShelter should only contain one copy/version of the image

When a photo is matched it will work just like any photo you've uploaded using the PhotoShelter plug-in.

Exporting vs. Publishing

The plug-in supports both exporting and publishing - two different workflows for getting your images from Lightroom into PhotoShelter. Here’s a general description to give you a better idea of which one is right for you:

Exporting

Select images, then "File" > "Export." On the next screen, choose "Export To" > “PhotoShelter” from the dropdown menu.

Screen_Shot_2019-03-25_at_5.07.43_PM.png

Using the export function in Lightroom is much like uploading via the web browser or desktop uploader except that images exported from Lightroom don’t take up extra space on your hard drive. Exported images are uploaded to PhotoShelter and do not stay synchronized with the originals in Lightroom. If you make a change to the image in Lightroom, you’ll have to export it again to see that change reflected on PhotoShelter. Exporting is typically best if the images you upload are completely finished. In other words, if everything you upload to PhotoShelter is ready for display, sale or delivery, then exporting is a simple and efficient way to use the plug-in.

Since exporting is a simple process, it works equally well if you work from one Lightroom catalog or many different ones.

Publishing

Publishing is only designed for photographers who work out of a single Lightroom catalog. If you use multiple Lightroom catalogs, use the Export feature or one of our other upload methods.

The publish feature of the plug-in is very powerful but also more complicated than exporting. Publishing allows you to link your Lightroom catalog to your PhotoShelter account so that any changes to collections, galleries or images in Lightroom are automatically updated on PhotoShelter. Adding, editing or deleting published content in Lightroom automatically adds, edits or deletes the version on PhotoShelter. This is wonderful if you want your PhotoShelter content to match Lightroom exactly. Publishing is typically best if you often re-edit your photos or change your metadata after uploading to PhotoShelter.

 

FAQ

What versions of Lightroom will this plug-in work with?
The plug-in was built for Lightroom Classic CC.

What does Sync Hierarchy do?
It synchronizes the list of your PhotoShelter collections and galleries into Lightroom.

If I make metadata changes to published images do those files need to be re-uploaded to PhotoShelter?
No. The current version of the plug-in will update the image metadata on PhotoShelter first and only replace the entire file when absolutely necessary (i.e. a change to the way the image looks or a change in publish service settings).

What happens when I remove an image from a PhotoShelter gallery in Lightroom?
The next time you publish images in Lightroom that image will be moved to your deleted image area on PhotoShelter.

Can I use Smart Galleries to automatically add images to PhotoShelter galleries in Lightroom?
Yes. Simply right-click on the PhotoShelter gallery list in Lightroom and select “Create Smart PhotoShelter Gallery.” Once created any image that meets the rules you set will automatically be added to the gallery.

If the same image exists in more than one Smart PhotoShelter Gallery the publish service will upload a separate copy of the image in each gallery on PhotoShelter. This is a limitation of Lightroom.

Changes to Smart Gallery rules only apply to new images. Images that were previously published via Smart Galleries will remain on PhotoShelter.

Can I have more than one PhotoShelter publish service installed in the same Lightroom catalog with different files settings?
No. If you have more than one PhotoShelter publish service uploading to a single PhotoShelter account, all images on PhotoShelter will be replaced with files that match the settings of the publish service that was most recently run. If you want to store two different file types (e.g. JPG and RAW) of the same photo on PhotoShelter, we recommend publishing one file type (JPG) and using the export feature to upload the other (RAW).

I edited the metadata of images on PhotoShelter. Will my changes appear in Lightroom?
No. The publish service was designed for a workflow in which Lightroom is always the "master copy" and as such, changes in Lightroom will always overwrite the versions on PhotoShelter.

Am I able to see custom PhotoShelter image metadata?
Yes. If you have a large archive, we realize it is important for you to be able to see if individual images are associated/uploaded to PhotoShelter and what PhotoShelter settings are applied to those images. You can now see the PhotoShelter image ID, model release and property release status for any published image.

How do I know when my upload or synchronization is complete?
You will see a progress bar in the upper left corner of Lightroom once you have started an upload or synchronization.

Do not make changes to the publish service settings while an upload or synchronization is in progress. This will result in errors and PhotoShelter becoming out of sync with your Lightroom catalog. If you need to make changes to the publish service, cancel any tasks in progress, change the settings and restart the upload or synchronization.

I’m getting error message "Problem uploading to PhotoShelter (400). Please synchronise your PhotoShelter gallery, then try to publish again." when trying to publish and “./PhotoShelterSync.lua:697: attempt to index local 'publishService' (a nil value)” when trying to synchronize.
These error messages indicate that publishing or exporting to PhotoShelter will bring your account over your current storage capacity. You may want to consider purging your trash or upgrading to a higher subscription tier.

I have just started using the plug-in and I am getting the error message “./PhotoShelterExportDialogSections.lua:85: bad argument #1 to 'pairs' (table expected, got string)” when trying to log in, publish, or export or publish from Lightroom.
Try visiting your Image Browser first in your web browser to initiate your uploading area. You may see the following:

LR3.png

Choose “Create a Gallery” and you should see your Image Browser appear. Try using the Lightroom plug-in again to log in, publish, or export.

What is the difference between Lightroom CC and Lightroom Classic CC?
According to Adobe, Lightroom CC was redesigned to create an editing workflow regardless of the device you’re using by storing all of your photos, including RAW files, on a cloud server. Lightroom Classic CC maintains all of the photo-editing power meant for desktop systems and is what most people think of as the original Lightroom program. For PhotoShelter, the plug-in will only work for Lightroom Classic CC. Lightroom CC doesn’t currently include the ability to install external plug-ins.

Still have questions? Contact us.

Comments

Powered by Zendesk