Generate your Script

Tumblr Name:   eg,
Sort Tags
Minimum Tag Freq.   — Only show a tag used at least this many times
Max # Tags   — Shows at most this many tags. (default: 5000)
Post History Use Last    (max 7000 posts)
Scale Tags?  
Max Font Size % recommended:  250 – 400
Base Font Size default:  uses size from your tumblr theme
Show Tag Count? format:  
Scale tag count?
Alter Text Case
Display Tags as
Comma b/w Tags?  
Extra space b/w tags? pixels
Prevent Tag Wrap?
Language Code Recommended for Alphabetical sorting for non-English users
Enter a 2 or 3 letter ISO-639 code
Exclude certain tags:
Separate tags with commas. You can use an asterisk * to exclude groups of tags. For example, "the*" will exclude any tag beginning with "the", like "the rabbit" or "theory". Capitalization does not matter.

This is your Code:

copy & paste to your Tumblr Theme or Page

This is an example of your Tag Cloud

actual appearance will depend on your tumblr Theme!


Installing the Tag Cloud Script

  1. Where do you paste the code?

    • On a "Page" on your Tumblr

          Click here for a Tutorial

    • In your Tumblr “Description”

      You can paste the code directly into the "Description" field on your Tumblr Customize page.

      On some Tumblr Themes, this will look nice, putting the Tag Cloud in a sidebar or header or something similar.   On other Themes, it may look horrible!

      Click here for a Tutorial

    • In your Tumblr Theme Code

      You'll need to know the basics of HTML to do this correctly.

      For most people, figuring out where to paste the script in your Theme HTML is the tricky part. You cannot just paste the script anywhere in your Theme.

      I suggest you use the "Search" (Ctrl+F) in your browser on the "Edit HTML" screen on your Customization page to locate some text in your Theme Code near where you want your Tag Cloud to display. You might have to play with it a bit to get it just right.

      If you need help, you can ask me on Tumblr, and I will try to assist you if I can.

  2. If you change your Tumblr Name –

    If you change your Tumblr name, your Tag cloud will stop working within a day or two.

    You will have to come back to this page, and generate a new piece of code that works with your new Tumblr name, and replace the old code in your tumblr.

    I'm sorry, that's just how it works!  I wish I could find a way around this.

  3. If you have Thousands of Posts –

    This Tag Cloud will only list the Tags from the most recent 7,000 posts on your Tumblr.

    I'm sorry, but it's just too much load on my server to handle more than that.

  4. If you need help, or things are not working as expected

    If you need help, or think something is broken, you can send me a note on Tumblr or shoot me an e-mail. I try to help when I have time, because I'm just a nice guy like that.   :)

  5. If you are a Theme Developer –

    If you are a developer writing a custom Tumblr theme, and wish to incorporate this tag cloud, that's fine. But there is a right way and a wrong way to go about doing this. Please e-mail me first to get to correct Javascript code.


Frequently Asked Questions

  1. I changed my Tumblr name, and now my tags are not showing up!

    Your Tag Cloud is connected to your Tumblr name, as described above.

    Unfortunately, there is no way for me to know when your Tumblr changes names, or what the new name is.  It just looks like your Tumblr disappeared.

    You will have to register again with your new tumblr name, generate a new script code, and paste this new code into your tumblr theme.

  2. I just posted something, but the Tag Cloud didn't update!

    The tag cloud is cached.  This means it is updated frequently, but not immediately.

    I need to cache your tags so the script loads fast. The downside is that it takes a little while for new changes to appear.

    I update your tags as often as I feasibly can.  This is a free service used by thousands of tumblrs. I am working with a small budget and limited resources.

    For your convenience, you may request a refresh to update your tags if you can't wait for the cache to automatically update.

  3. I changed some tags on my posts, but the changes aren't showing up!

    Again, the tag cloud is cached.  It is updated frequently, but not immediately.

    In particular, your tags are only updated when I detect that your Tumblr has a new post.

    So if you edit tags on posts, or delete posts, changes will not show up on your cloud until:

         1. You post something new on your Tumblr   (with up to 30 min delay)

         2. The cache automatically updates itself   (about once every 24-36 hours)

    Otherwise, you may request a refresh to update your tags if you really can't wait for the cache to update itself.

  4. How often are the tags updated?

    This gets a little complicated.  For most people, I think the answer is "often enough".

    Every time someone views your tag cloud, I will check if your tumblr has any new posts. (I'll check once every 30 minutes). If your tumblr has any new posts, the tags for the last 50 posts on your tumblr are updated.

    If nobody is visiting your Tumblr page and viewing your tag cloud, updates will be much less frequent, 12 - 24 hours.

    A complete refresh is done every 24 - 36 hours, assuming you had at least one visitor to your tumblr in the last 3 days. The complete refresh will find any changed tags from old posts, deleted posts, etc.

  5. Why is it asking me to Register my tag cloud?  I already registered once.

    If you changed your tumblr name, you will have to register again with your new tumblr name, generate a new script code, and paste this new code into your tumblr theme.

    Sorry, that's just how it works.

  6. I have a tag like "my-hyphenated-tag" and it doesn't work when I click on it!

    This is a well-known Tumblr bug for tags containing a hyphen / dash ( - )

    In fact, all of the following characters have issues:

    •   “ - ”     is converted to a space

    •   “ + ”     is converted to a space

    •   “ _ ”     is converted to a space

    •   “ / ”     does not work at all

    When I say "is converted to a space" I mean that the tags "some-tag", "some+tag" and "some_tag" actually link to the tag "some tag" (whether or not you use it). These links not find any posts whose tags have the hyphen, plus or underscore in them.

    If I were you, I would avoid using any of these characters in your Tags.

  7. I have a Private Tumblr, will the Tag Cloud work?

    No.  Unfortunately, private does mean private.

    Temporarily removing the password from your Tumblr will not work either. Once your Tumblr is marked "private" again, my server will delete your Tag Cloud within 24-48 hours. So don't even bother trying that.

  8. Is this free?

    Yes, this Tag Cloud script is "Free as in Free Waffles"

    Free Waffles come with butter and maple syrup,  Yum!

    But that's it:  there's no warranty, guarantee, or money back (hey, they're free), and if you eat them, you assume any risk (ie, don't blame me if you get sick) etc.

    More specifically,

    By using this Tag Cloud, you agree to the Tag Cloud License and Terms of Service.

    The Tag Cloud comes "as-is", with no warranty of any kind, and I disclaim any liability arising from its use

    I will not make any claim to constant availability of this service, now or in the future.

    There may be brief periods when the Tag Cloud will not load correctly ("downtime"). It happens, it's annoying, it's not always my fault. But I can't make any guarantee for 100% uptime.

    I reserve the right to disable this service at any time, or to block any particular Tumblr, IP, user, etc. at my sole disgression.

  9. You're not going to insert advertisements or something are you?

    No. I will never do that, don't worry.

    I will also never add any kind of "tracking" codes or cookies.

  10. Do you have a Privacy Policy?

    Yes I do, you can Read my Privacy Policy here.

  11. Do you offer support?

    Not in any official way (unless you want to pay me!)

    But I do want my tool to be useful! So please do:

    • Send me bug reports!

    • Let me know if something is broken or not working correctly!

    • Request new features!

    • Ask me questions if anything is confusing!

    If you need help with "How do I put the Tag Cloud in my Tumblr Theme?"

    • Help with this is offered "out of the goodness of my heart", when and if I have time.

    Please direct any questions or whatever to my Tumblr Ask Box or send me an e-mail.

  12. What Browsers are supported?

    Browsers I have tested –

    • Internet Explorer 8 - 10 on Windows

    • Firefox 10+ on Windows 7

    • Google Chrome 15+ Windows 7

    I have no plans to support IE < 8

    I don't have an Android phone or tablet, but I have been told the cloud works OK on Android based phones/tablets.

    Occaisonally, something else in your Tumblr Theme may interfere with the tag cloud script. The usual suspects are other JavaScripts that cause unexpected changes to the document before the Tag Cloud gets a chance to run, some invalid HTML in your Theme, or an element in your Theme that uses the element id "tagCloud".

    I've fixed some of these issues, especially regarding various "infinite scroll" scripts on people's Tumblr Themes.

    Of course if you find a bug, please drop me a note on Tumblr, or send me an e-mail


About my Tag Cloud

I have previously used a Tag Cloud script by Heather Rivers. Her script is great, except:

  • It takes forever to load when your tumblr has more than a few hundred posts.
  • Heather's script loads every single one of your posts from the Tumblr API every single time your page is accessed by anyone. It's slow and wasteful.

Advantages of my Script:

  1. Your Tag Cloud loads much faster because my server has already downloaded your Tags from Tumblr and cached them for performance.

  2. The script is very simple and averages about 10 kB in size with all Tag data included.

  3. I have many additional options to control how your Tags are displayed.

Disadvantages of my Script:

  1. Because your tags are cached for performance, tags for new posts, or changes to tags on existing posts, will not appear immediately on your Tag Cloud. Updates are frequent, but you can expect a normal delay of about 30 minutes.

  2. This Script is primarily intended for blogs with many hundred or thousands of posts. If your blog has less than about 300 posts, you may prefer the non-cached behaviour of Heather's Script. Her script will load in about 1 second per 100 posts on your Tumblr.