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 )


The plugin now supports video upload to Tumblr, for videos up to 10 megabytes. (You may need to log out from Tumblr within the plugin, then log back in, to get video support.)

The way Tumblr supports video in its third-party API that this plugin must use is fantastically bad in a number of unrelated ways. The plugin has to make a guess as to where the uploaded video is on Tumblr. Videos can't be deleted (though they can be replaced).

Tumblr's docs say that videos up to 100mb can be posted, but I've never been able to get anything beyond 10mb (the image filesize limit) to work, so that's what the plugin enforces.

It's unclear how long this will all last, as it appears that Tumblr has abandoned the third-party API; the last developer update I've been able to find is dated 2012.


Added {SpeedKPH} and {SpeedMPH} to the list of template tokens supported by my plugins.

The {People} token wasn't working properly for some keywords without a registered birthday.

Updated Twitter support to better count lengths of tweets that include URLs.


Made it so that "extra tags to register with exported images" tags come first in the list sent to Tumblr.

Updated the Caption part of the dialog to show up to three lines of text, and the full text in the tooltip.


Fixed the "SpecPeople:259: attemt to index al nil value" error.


Clicking on the example caption in the export dialog now brings up a dialog showing the whole example caption, which is useful to see the full thing when it contains multiple lines.


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.

The 30 most-recent comments (out of 37; see all), most recent last...

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 (3 years 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 (3 years 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, 11 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, 11 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, 11 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, 11 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, 11 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, 11 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, 11 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, 11 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, 10 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, 9 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, 9 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, 9 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, 9 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, 9 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, 8 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, 7 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 (2 years, 2 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 (2 years 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, 6 months 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, 5 months 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 (1 year 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 (10 months, 19 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 (10 months, 11 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 (10 months, 7 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 (7 months, 8 days ago) comment permalink

Good day Jefrey, I’ve been using this Tumblr plugin for a long while and really like how it works.

I made a mistake yesterday. I selected all the items in a collection to modify some keyword, then (forgetting I had everything selected) I exported my image of interest to tumblr. Instead of only one image, 70 images were uploaded. Oops! The cleanup on Tumblr was not that complicated but now all these images have a tumblr url and the “Uploaded to Tumblr” status in the metadata. I use this status in a smart collection … “Uploaded to Tumblr”. Sadly, I now have 70 extra items in my smart collection that I’d really rather were not there.

Is there any way to delete these fields from the metadata? An “un-export” option?

(Larry from Canada 😉 )

Sure, see “File > Plugin Extras > Tumblr Extras > Clear”. —Jeffrey

— comment by Larry on July 26th, 2015 at 9:10pm JST (4 months, 3 days ago) comment permalink

I have the Tumblr export plugin set up to add “photographers on tumblr” as an extra tag, in addition to my Lightroom keywords, because many Tumblr accounts that curate photography monitor this tag. However, the plugin adds this tag to the end, after my Lightroom keywords. This means that “photographers on tumblr” usually is not in my first five tags, which keeps it out of the search results. I would like the Tumblr exporter to provide a way to add tags before the Lightroom keywords. Thanks!

Makes sense… in the new version of the plugin that I just pushed live, the “extra tags” now show up before the photo’s tags. —Jeffrey

— comment by mph on August 25th, 2015 at 6:34am JST (3 months, 5 days ago) comment permalink


Have been using this plugin for quite a while – thanks for creating it :) One little feature request if I may:

Tag order is significant on Tumblr – in particular the first 5 tags for a photo have an impact on some search functions. It would be great if when I specify additional tags to add for every post (in the Metadata Management section) if I could opt to have them prepended to the list from the image rather than always appended.

Adam (from NJ)

As per the previous comment, I just pushed this in the latest version. —Jeffrey

— comment by Adam on August 25th, 2015 at 8:51am JST (3 months, 5 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