|Tumblr Name:||eg, my-tumblr-name.tumblr.com|
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
Where do you paste the code?
On a "Page" on your Tumblr
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!
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.
In a "Text" Post
You can paste the code in a Text post, but it will not show up on the Tumblr Dashboard. People will have to open the post on your Tumblr Page to see the Cloud.
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.
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.
If you need help, or things are not working as expected
If you are a Theme Developer –
Frequently Asked Questions
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.
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 an refresh to update your tags if you can't wait for the cache to automatically update.
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 (again, with some delay)
2. The cache automatically updates itself (about once every 24 hours)
Otherwise, you may request a refresh to update your tags if you really can't wait for the cache to update itself.
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. (But I will only do this 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 viewing your tag cloud, updates are more infrequent, around 6 - 8 hours.
A complete refresh is done every 24 - 36 hours, assuming you have at least one visitor to your tumblr ever day. This will pick up changes if you changed the tags on old posts or deleted any posts.
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.
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.
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.
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.
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.
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.
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.
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.
I've fixed some of these issues, especially regarding various "infinite scroll" scripts on people's Tumblr Themes.
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:
Your Tag Cloud loads much faster because my server has already downloaded your Tags from Tumblr and cached them for performance.
The script is very simple and averages about 10 kB in size with all Tag data included.
I have many additional options to control how your Tags are displayed.
Disadvantages of my Script:
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.
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.