get out of my <head>

HandheldFriendly

Why do so many websites have this mystery tag?

When I first started this project to Marie Kondo HTML — I wrote some code that looked at the <meta> tags used by the 10000 most popular websites.

Of that 10000 only 6560 returned a result — and of those 460 had the HandheldFriendly <meta> tag.

HandheldFriendly meta tag

45 bytes

<meta name="HandheldFriendly" content="True">

If we unscientifically extrapolate from those numbers — that's around 7% of websites using this tag — which is quite a lot, considering that it took days to work out what it does.

What is the HandheldFriendly <meta> tag?

The HandheldFriendly <meta> tag was invented for the AvantGo web browser.

AvantGo was used on Palm Pilots between 2000-2009.1

This is a Palm Pilot
Retro looking device with a stylus.

It was more of an RSS feed than a browser.

If the HandheldFriendly tag wasn't present AvantGo would remove <table> elements, "certain image tags" and JavaScript from from the page.2

By using the HandheldFriendly tag you're telling the 1 person in the world that still uses AvantGo that you made your website compatible with their Palm Pilot — which would be a lie!

While backwards compatibility is important to consider — it is extremely unlikely that your website is compatible with an old Palm Pilot.

Palm Pilots — and other devices from that time — cannot view websites that use basic security practices like https and tls.

So, to access your website a Palm Pilot user would need make extremely nerdy modifications to their device, or use a proxy server.

These people do exist.

However, even if you want your website to work for the small number of hobbyists who will access it using a Palm Pilot — you still don't need this tag — the Palm Pilot will simply load your website as best as it can without the tag.

For anyone is still using these browsers, let their devices render your content in the default way.

Blackberry Browser

Why is it still around?

I think we can safely say that the HandheldFriendly <meta> tag does not spark joy.

It sparks fear — fear of the unknown.

Nobody wants to be the person who deletes it and then breaks everything.

But now that you know what it is, and what it does, you can thank it for it's service, and let it go.


  1. Palm info center — AvantGo going away ↩︎

  2. avantgo.com — developer reference ↩︎

  3. pcmag.com — blackberry OS 4.5 ↩︎

  4. Manuals Lib — Blackberry Browser Fundamentals Guide ↩︎