Jeffrey’s “Export to Tumblr” Lightroom Plugin

This plugin allows you to export images from Lightroom directly to your Tumblr account.

This plugin works in Lightroom CC/6, Lightroom 5, and Lightroom 4.

The same download works for both Windows and Mac. See the box to the upper right for the download link (in orange) and installation instructions.

After downloading, installing, and enabling the plugin (download link is in the orange box, in the upper-right of this page; install instructions are here), you can activate the Tumblr export by clicking on the Export Dialog's masthead, as illustrated here.

You can add additional functionality to the Tumblr export (and to all exports) with export-filter plugins. I have a variety of them on my Lightroom Goodies page related to Geoencoding, support, metadata management, running external apps, automatic snapshot creation, Creative Commons licensing, etc.


This plugin is distributed as “donationware”. I have chosen to make it available for free — everyone can use it forever, without cost of any kind — but unless registered, its functionality is somewhat reduced after six weeks.

Registration is done via PayPal, and if you choose to register, it costs the minimum 1-cent PayPal fee; any amount you'd like to add beyond PayPal's sliding fees as a gift to me is completely optional, and completely appreciated.

Note: a Lightroom major upgrade, such as from Lr4 to Lr5, de-registers the plugin in the upgraded version, so if you want to maintain registration, a new ($0.01 if you like) registration code is needed in the upgraded version. It makes for a hassle every couple of years, I know. Sorry. See this note for details.

For details on plugin registration and on how I came into this hobby of Lightroom plugin development, see my Plugin Registration page.

Version History
( Update Log via RSS )


Added the ability to use template tokens in the "Photo Link" field.


In the POODLE-vunerability dialog, display a raw URL of a page on my site that discusses the issue, so that folks can be independently sure that the dialog is indeed from me and not malware.


Part of the code was confused about Tumblr's max upload size.

Added a special note about the recent Tumblr authentication woes, to try to head off bug reports heading my way. Tumblr's having issues with their back-end servers, and there's nothing I can do about it but commiserate.


Fix to the date_diff() function supported by the LUA template token.

Updated the camera-name code to try to guess the actual camera model of Hasselblad H5D files, since in their infinite wisdom Hasselblad decided to encode three distinct models with the same internal code, making it impossible to know for sure what camera produced a given image file.


If the remote site sends back garbage during the authorization handshake, properly report the error instead of crashing.

Use a compressed view on the Plugin Extras dialog if the screen is not very tall.

Added extra logging to debug why Lightroom might fail to render for export.

20141019.52 Windows Only: Add a one-time check for the POODLE security vulnerability, and alert the user if it exists.
20140923.51 Added the LrMD5, LrLocalization, LrSystemInfo, and LrMath packages to the {LUA} template token.
20140902.50 New build system

Made the {GPSAltitude}, {Altitude}, and {GPSCoordinates} tokens subject to the geo-privacy settings like the other geo-related tokens.

20140731.48 Registration fix for Lr5.6
20140720.47 More Creative-Cloud support.

Fixed an issue with Creative-Cloud revalidation.


Lr5.5 and later Creative-Cloud installs can now revalidate themselves if needed.

20140710.44 Sigh, had a bug in the Creative-Cloud support.

Now supports Lr5.5+ Creative-Cloud Installs.

20140704.42 Ran into a crash while reporting certain upload errors
20140630.41 Build-system update
20140614.40 It seems Tumblr upped the max upload from 5mb to 10mb.

Added date_diff() and raw_time_diff() functions to the special {LUA} token understood by the plugin.


Add a note to the Keyword options to highlight that only exportable keywords are considered

A missing 'automatic destination' could cause the plugin to crash.


Added new tokens to the template language the plugin understands: LrVersion, LrVersionMajor, LrVersionMinor, LrVersionRevision, LrVersionBuild, Location, CatalogName, CatalogPath, OperatingSystem, OS

Added new token filters: NS and LO


Fixed a bug in the "smoother revalidation" stuff recently added.


The authentication process allowed the authentication dialog to be closed before authentication was finished.

Handle an upload-limit-reached situation more gracefully.


Added a new "Location Privacy" section to the Exprt/Publish dialogs.

Updated the location-based tokens in the template language the plugin uses — City, State, Country, Location, Latitude, Longitude — to respect new privacy options in the Export/Publish dialogs, and in the resend-metadata dialog. You can override those options on a case-by-case basis with the evenIfPrivate filter.

Added locationIsPrivate variable to the environment available to the LUA token.

The {Empty} template token wasn't working properly.

Make the revalidation process smoother, especially for folks using Lr5.4 and later.


Enable a new feature internal to Lr5 for large exports that keeps the CPU from running too far ahead of the upload. Prior to this, Lightroom would go ahead and peg the CPU to pre-render all the images even if they weren't being uploaded at nearly the same speed. Now Lightroom pauses the behind-the-scenes rendering if it has gotten too far ahead of the upload.

Added the “:EMBED” token filter to the template language.

20130926.32 Oops, fix a bug introduced in the previous update

Added a bunch of tokens to the preset templates supported: ExportFormat, ExportColorSpace, ExportBitDepth, ExportQuality, ExportSharpeningLevel, ExportSharpeningMedia, IpernityUrl, GoogleDriveUrl, and TumblrUrl.

The token-examples dialog had been broken. Also deprecated Folder and Path tokens in preference to FolderName and FolderPath tokens.


Work around a Lightroom bug concerning the determination of whether a photo is offline.


Better handle very long user account names, so that the [Logout] button doesn't get cut off of the Export dialog.

Fixed the KW/KWE tables in template tokens; they had been broken when using load for the script.


Added the ability to update/replace posts.

Moved the "Export with Smart Previews?" dialog section to a more-logical place in the dialog order, and made big improvements. you can now pick to be asked whether to export via Smart Previews, and can differentiate between when the Smart Previews are "good enough" for an export and when they are not.


Work around a bug that causes the export-related progress bar to not show up right away.

20130613.26 Better support for plugin revalidation.
20130611.25 Sigh, previous update for Lr5 broke things for the Lr5 beta.
20130611.24 Yet another Lr5 update
20130610.23 Better logging to try to understand catalog-write-access contention under Lightroom's hood

Added the ability in Lr5 to export images even if the master image file is not available, so long as there's a smart preview available.

20130501.21 Update for Lr5
20130412.20 Build system update.
20130328.18 Fixed a possible plugin crash in Lr2 that might happen if the remote site's servers are failing.
20130302.17 Make authentication a bit more robust.
20130225.16 Fixing a boo-boo in yesterday's update.
20130224.15 Sending keywords with the image is now optional.

Added support for some new template tokens: FlagStatus (requires Lr4.1 or later), and for Lr3 and later, a bunch of IPTC extended metadata: AdditionalModelInfo, CodeOfOrgShown, DigImageGUID, Event, ImageSupplierImageId, MinorModelAge, ModelAge, ModelReleaseID, ModelReleaseStatus, NameOfOrgShown, PersonShown, PlusVersion, PropertyReleaseID, PropertyReleaseStatus, and SourceType.

20130209.13 More build-system maintenance
20130206.12 Tweak for my registration system

Added the ability to set the post date to the photo date.

The caption-preset UI was ugly... made it better (I think).


Added the ability to use caption presets.

Keywords marked in Library for export are now sent as image tags, and you can add extra tags as well in the export dialog.

20121213.8 Added the ability to include a click-through link when uploading a photo
20121126.7 Try to work around a logging problem one user has.

Plugin was unwittingly overriding the blog's auto-tweet setting. Fixed.


Added the ability to automatically upload only those images not yet uploaded and/or modified since last upload.

Fixed an error that popped up during export if the plugin's unlimited trial had ended.

20121113.4 Added the ability to set a new post as private/draft/queue.

Realized a bit late that because Tumblr wants the entire upload package HMAC-SHA1 signed (as opposed to just the non-image-data parts like most upload destinations), the raw HMAC-SHA1 routines in pure Lua that I wrote years ago to handle short hundred-byte handshaking just won't cut it for multi-megabyte full-image uploads. I've found a way around it for Lr4, but it's not possible to fix in Lr3, so I have to pull support for Lr3.

Note that Tumblr's photo-upload limit is 5MB, so if the image is larger than that, bail before even trying.

20121014.2 Added a help dialog when encountering the mysterious 'handle in the wrong state' error.
20121010.1 Initial Public Release.

All 34 comments so far, oldest first...

I’ve tried your tumblr export plugin — the one I was using so far to publish directly from LR is now broken due to a change in Tumblr API.
It works, even if publication takes a very large amount of time (much more than with my previous plugin).
Some improvements that would be very welcome: possibility to add to the queue instead of direct publication, and possibility to associate keywords — similar to what one can do when publishing directly on Tumblr site.
Just some suggestions. Thank you in any case for your great work!

-Kiting Free, from France

— comment by kitingfree on October 20th, 2012 at 4:00pm JST (2 years, 8 months ago) comment permalink

Very glad to see this as an alternative to the other, broken plug-in.

I found the time to upload normal – I processed a 1280px picture at 240 dpi at about the same speed as LR’s native uploader for Flickr.

I too would welcome the use of keywords (from Lightroom would be fine) and also an option to use the caption in Lightroom, perhaps with the alternative to overwrite this in the plug-in. It would be good to be able to upload in draft mode if it is difficult to implement a direct publish day or date.

Thanks again for working on this and I hope these suggestions are of some help.

Howard – Oxford, UK

— comment by Howard on November 2nd, 2012 at 4:26am JST (2 years, 8 months ago) comment permalink

Great, but needs draft mode!

What is “draft mode”? —Jeffrey

— comment by Gusty Pants on November 9th, 2012 at 2:10am JST (2 years, 8 months ago) comment permalink

Posts can be saved as drafts on Tumblr rather than made live immediately – it’s one of the options on the ‘publish now’ menu. Its usefulness lies in uploading a batch of pictures for subsequent work in Tumblr, e.g. in adding them to a queue of pictures to be published in a predetermined sequence. (See the other options on the menu – add to queue or publish at a specified time/date.)

Got it. We’ll see whether the plugin garners enough attention to make additional development worthwhile…. —Jeffrey

— comment by Howard on November 9th, 2012 at 5:36pm JST (2 years, 8 months ago) comment permalink

Thanks for the new publish feature – v useful addition for me!

— comment by Howard on November 14th, 2012 at 5:04am JST (2 years, 8 months ago) comment permalink

i have try your export plugin but i’m stop uploading after 75 pictures
have you a solution

It doesn’t stop on its own… perhaps Tumblr is having issues, or perhaps you tried uploading only 75 pics :-) —Jeffrey

— comment by Maddog on November 24th, 2012 at 12:44am JST (2 years, 7 months ago) comment permalink

The Plug-in is working great.

One thing I have noticed is that images I export with your plug-in do not generate a Tweet automatically, but they do generate a Facebook post automatically. I have both options enabled in my Blog settings, so I am not sure why your export plug-in is not triggering the Tweet option.

A nice feature would be to allow a FB post and Tweet for each export, so that we could manually enable the options.



The upload API has nothing about FB, but it does have a way to suppress tweets, and it seems that I was doing that. I’ve just pushed a new version that doesn’t. —Jeffrey

— comment by Brian Ingram on November 24th, 2012 at 1:07pm JST (2 years, 7 months ago) comment permalink

Hi Jf, I would like to use your tumblr plug in, but it doesn’t appaer in the plug in option. jf Picasa and other plug ins appear but the tumblr one is not there. Thank you.

You’re looking in the Publish Services area… the Tumblr plugin is an Export plugin…. select the images and click the big “Export” button in the lower left of Library. —Jeffrey

— comment by Jack on December 2nd, 2012 at 10:12am JST (2 years, 7 months ago) comment permalink

Thank you Jeffrey for you reply…a little question: why only export and not publish…API restriction I suppose.

No, no API restriction… I just don’t want to do the extra work for Publish until I know it’ll be worth it. Very few folks use this plugin, so at this point I’m feeling it was a waste of time to have done it, but we’ll see whether it gets more use in the future…. —Jeffrey

— comment by Jack on December 10th, 2012 at 7:19am JST (2 years, 7 months ago) comment permalink

Would it be possible to add a Tag field so that we can tag our photos in the Tumblr system?

Right now just adding #Alaska to the caption does not actually tag it with that.



I just pushed version .9 that adds Lightroom keywords as tags, and other changes. Happy New Year —Jeffrey

— comment by Brian Ingram on December 17th, 2012 at 9:19am JST (2 years, 6 months ago) comment permalink

I just got the Tumblr Plugin for Lightroom 4.3. I’ve donate and installed it to the lightroom, but the option don’t appear is their a new update or will their be one soon?
Thanks for From Los Angeles, California

The Tumblr plugin is an Export plugin, so it won’t show up in the Publish list (if that’s where you’re looking). —Jeffrey

— comment by Jose on December 27th, 2012 at 9:05am JST (2 years, 6 months ago) comment permalink

Hi Jeffrey,
thanks for this great plugin…working smoothly…One question though…How can i export a batch of pictures as a gallery on Tumblr ? Thanks !

You can’t do that with the plugin… as far as I can tell, their API doesn’t support it. —Jeffrey

— comment by gwenhael appere on December 28th, 2012 at 4:45pm JST (2 years, 6 months ago) comment permalink

Thank you for this and all your other work; almost exactly what I was looking for! Would you consider adding one small feature: the ability to set the Tumblr API’s “date” attribute to match the photo’s Capture Time? This is a feature I rely on to update my baby daughter’s private blog :-) I would happily donate $25 or more for this feature.
Robin (from the UK)

I can take a look, but unfortunately, Tumblr’s API documentation is really bad in this respect.. they say that there’s a nebulous “date” parameter, but give no information about what format the date should be in, so I’m left with the task of trying every date format I’ve ever heard of until I get lucky with one that works. We’ll see. —Jeffrey

— comment by Robin on December 30th, 2012 at 10:08pm JST (2 years, 6 months ago) comment permalink

In Python, the following worked well for me against the Tumblr v1 API:
>>> import EXIF
>>> f = open(‘IMG_0231.jpg’,’rb’)
>>> tags = EXIF.process_file(f)
>>> tags.get(‘EXIF DateTimeOriginal’).printable
‘2012:12:25 15:11:06′


I’ve gone ahead and pushed a version that supports this. It seems to be working despite Tumblr’s documentation being explicitly wrong. /-: —Jeffrey

— comment by Robin on December 31st, 2012 at 2:47am JST (2 years, 6 months ago) comment permalink

Dear Jeffrey,

Jack again. Your great Tumblr plug in works fine, but I’m not able to export Keywords, Caption and Title as well I’m using your Wrangler plugin…Do you have any suggestions? Thank you in advance.

“I’m not able” is not much for me to go on. Perhaps send a log with explicit details? —Jeffrey

— comment by Jack on January 1st, 2013 at 4:21am JST (2 years, 6 months ago) comment permalink

Thanks for this update – great to see the export options added here – first impressions v positive!

— comment by Howard on January 2nd, 2013 at 9:42am JST (2 years, 6 months ago) comment permalink

Hey Jeffery, I have your Zenfolio plugin working fine, but the Tumblr one wont load. I have it set in Lightroom, and the program says its running in the Plug-In Manager, but its not listed in the available publish services aplet? Any ideas?

It’s not a Publish plugin… only Export. —Jeffrey

— comment by Tristan on January 14th, 2013 at 8:12am JST (2 years, 6 months ago) comment permalink

Hiya, I’m also having the problem of it stopping after 75 photos. I tried again to just upload the remaining photos but it’s saying “bad request”

It’s almost certainly just Tumblr having transitory issues, unless it stops at the same photo every time. —Jeffrey

— comment by Kristy on January 15th, 2013 at 9:06am JST (2 years, 6 months ago) comment permalink

When exporting 10 images to Tumblr they show up as 10 separate posts. This causes a problem when multiple bloggers are uploading images at the same time. I want to keep my 10 images grouped together in one post. Is there a setting / method for this ? Can’t find it. Love the plugin otherwise. thanks.

Unfortunately, their 3rd-party API allows only single-image uploads. —Jeffrey

— comment by Kai on February 22nd, 2013 at 7:01am JST (2 years, 4 months ago) comment permalink

I’ve tried to upload photos to Tumblr without lightroom keywords to no avail. It appears that this plugin ignores metadata export settings (including your plugin metadata wrangler). Is there a way to upload photos to Tumblr without lightroom keywords? Thanks.

Good catch. I’ve just pushed a new version that makes it optional. —Jeffrey

— comment by Chantal on February 24th, 2013 at 7:26am JST (2 years, 4 months ago) comment permalink

Hey Jeff Sorry I posted this in the other place then realised my mistake!!..thanks for this plug in Just joined Tumblr as everyone else is haha…problem is when i try to set it up try to authenticate with Tumblr I get a 400 error..tried it several times with no luck..any suggestions??? thanks mate!!

After encountering the error, please send a log —Jeffrey

— comment by paul on March 13th, 2013 at 1:40am JST (2 years, 4 months ago) comment permalink

Hi Jeff. I was the first to post on your plugin.

I just want to say that I am now a fully happy user of your plugin. It is just what I needed!

Thanks for your good work!

-KitingFree, from France

— comment by kitingfree on March 13th, 2013 at 7:53pm JST (2 years, 4 months ago) comment permalink

Great plugin, thank you! Did I miss something or does the plugin only work for strictly image posts? I was hoping to include an image within a post that has a title to the post. Thank you.

It uses the photo-post API, which allows for a caption and tags and a link, but apparently no title. —Jeffrey

— comment by tivoli on March 13th, 2013 at 11:47pm JST (2 years, 4 months ago) comment permalink


Is there a way to publish multiple photos into a single article? I use Tumblr as a blogging platform, and like to post blog entries with multiple photos and quite a long text description.

I also noticed pressing enter in the text box publishes the article rather than adding a line feed. You then get the same text box repeated under different photos, all as different posts.

Tumblr’s API for third-party apps like my plugin allows only single-photo photo posts, so no luck there. The “pressing enter launches the export” is a nasty feature of Lightroom that’s difficult to get around, so that’s a bummer too. Sorry. —Jeffrey

— comment by Stephen Eddy on March 30th, 2013 at 9:24pm JST (2 years, 3 months ago) comment permalink

Tumblr: another very useful tool, thank you. I can’t find a way to publish to an existing blog so that I can the images as part of that blog. Am I missing something?



You should be able to post photos to any blog associated with your account. —Jeffrey

— comment by Jim Seith on April 26th, 2013 at 4:32am JST (2 years, 2 months ago) comment permalink

I love your plugins, thank you for the time and attention to detail you put into them.

I’m having an issue with your Tumblr export plugin. I’m using Lightroom 5. The Tumblr plugin shows up in the plugin manager as installed and active, but does not show up in the export manager when I click add and click the drop-down for “via service”. I have removed it, moved it, renamed it, all with no luck. Have you come across this before?

It sounds as if you’re talking about the Publishing Manager. It’s not a Publish plugin, just normal export (File > Export). —Jeffrey

— comment by Josh on September 15th, 2013 at 10:59am JST (1 year, 10 months ago) comment permalink


I am new on tumblr and tried to use your plugin to publish from LR 5.2 to tumblr. There seems the mechanism for the plugin to authenticate with tumblr is broken, at least on Windows 8.1.

After I allow your plugin to link to tumblr, I get a popup asking if I allow the website to open an application on my computer. I click Allow and I et a Windows error message saying no applicaiton is configured to open that link.

After that, when I click on ‘I have authenticated at Tumblr’ I get ‘Unexpected HTTP error reply #400 from Tumblr’.

Any idea if I do something wrong?



I’m not sure exactly what you’re reporting, but perhaps this FAQ might be related? —Jeffrey

— comment by Stephane Bosman on December 7th, 2013 at 6:23am JST (1 year, 7 months ago) comment permalink

Shelton Washington here.

I am attempting to use the Tumblr plug-in – but everytime I try to authenticate it, my browser dumps me to an error page saying something like “Firefox can’t find the file at lightroom://info.regex.lightroom.export.tumblr2″

Any idea what’s going on?
Please see this FAQ —Jeffrey

— comment by Brian Monroe on May 26th, 2014 at 9:18am JST (1 year, 1 month ago) comment permalink

Thanks for the plug-in, I use it a lot.

It would be nice to have photos that are exported via the plug-in be tagged in Lightroom after the upload succeeds. That way you can have a smart collection in LR of the photos that have been published.


Indeed. Try it… create a smart collection, and choose “Exported to Tumblr” as the field, and “Yes” as the value. 😉 —Jeffrey

— comment by Brad on June 23rd, 2014 at 9:24pm JST (1 year ago) comment permalink

Hi, like to use this plugin, however experiencing an issues with the authentication. First try it says can’t authenticate (logs off the site as well), second try ends with an error as well. Any fix/support on this appreciated, Hans

I’ve gotten a number of reports on this. It doesn’t happen to me (or, apparently, most folks), so I assume it’s a problem at Tumblr, but perhaps it’s related to the account. If someone experiencing this problem would let me try authenticating with their credentials, perhaps that would lead to a fix… —Jeffrey

— comment by Hans on November 4th, 2014 at 3:19am JST (7 months, 27 days ago) comment permalink

I get this error with your plugin for tumblr:
Unexpected HTTP error reply #401 from Tumblr

Yes, a lot of folks get that at times. The best I can tell it’s an issue on their side. It’s been going on for a long while )-: —Jeffrey

— comment by David on January 10th, 2015 at 10:00pm JST (5 months, 20 days ago) comment permalink

Your releases notes acknowledge the new tumblr file size limit of 10mb, but I am still hitting an error if I attempt to upload anything above 5mb. Any suggestions? Thanks!

“20140614.40 It seems Tumblr upped the max upload from 5mb to 10mb.”

Hah, good catch… one part of the code still thought it was 5mb. Fixed. —Jeffrey

— comment by cooper on January 19th, 2015 at 9:46am JST (5 months, 13 days ago) comment permalink

Thanks for writing this plugin! It would be great to be able to publish photosets (multiple photos in a single post). It seems Tumblr doesn’t do a great job with their documentation, but I found this breadcrumb that suggests it’s possible.

Even if Tumblr supports it, it’s not how Lightroom is set up, so I’m not quite sure how to handle it. Unfortunately, many things on the todo list above this. )-: —Jeffrey

— comment by Jason on January 23rd, 2015 at 3:48am JST (5 months, 9 days ago) comment permalink

I know its too soon to ask this, however just wanted to know when should we except plugin updates for Lightroom 6. Thanks!

Modern versions of my plugins should work fine on Lr6. —Jeffrey

— comment by Hunaid on April 22nd, 2015 at 8:08am JST (2 months, 9 days ago) comment permalink
Leave a comment...

All comments are invisible to others until Jeffrey approves them.

Please mention what part of the world you're writing from, if you don't mind. It's always interesting to see where people are visiting from.

You can use the following tags: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

Subscribe without commenting