Blogger · free forever · no signup

Add a free npm downloads badge to Blogger

This guide shows how to add a npm downloads badge for Blogger in about a minute, with no third-party gadget: you paste one snippet into the post editor, switched to HTML view, because it belongs beside the install command, in the post or docs page that teaches it. Nothing to install. Blogger's own HTML/JavaScript gadget takes raw markup, which is all this needs — and unlike a theme edit, a gadget survives changing your theme.

What this npm downloads badge for Blogger shows

The npm downloads badge shows how many times a package was downloaded in the last day, week or month, using npm's public download counts. It's for JavaScript library authors who want that number on their docs or landing page, not only on npmjs.com. Scoped packages are supported.

How to add a npm downloads badge to Blogger

  1. 1Open the post or page and switch the editor from Compose to HTML using the pencil/HTML toggle at the top left.
  2. 2Paste the snippet exactly where you want the widget to appear in the markup.
  3. 3Switch back to Compose only if you must — Blogger can rewrite markup when it converts views.
  4. 4Publish or Update, then open the live post.
Editing the theme XML instead? Pasting into Compose view escapes the code and you'll see the raw snippet as text on your page. HTML view is the only safe place to paste.

Where it works best on a Blogger site

On Blogger, the right spot is the post editor, switched to HTML view. Put it next to the install command, in the docs page or post that teaches people to use the package. That's where a reader is deciding whether to run npm install.

Blogger plan and editor requirements

Blogger is free, and every method here works on every blog, on blogspot.com or a custom domain. The HTML/JavaScript gadget is the safest place for most widgets, because gadgets survive theme changes. Editing the theme's HTML also works, but it's parsed as XML, so a snippet with stray characters can stop the theme from saving.

Three things that trip people up on Blogger

The theme editor is XML, so raw code can break the save

Blogger themes are parsed as XML, so characters like &, <, > and quotes inside a script can trigger errors such as "The reference to entity must end with the ';' delimiter" and refuse to save. Our snippet is a plain async script tag with no bare ampersands, so it pastes cleanly — but if you ever hit that error, wrap the code in //<![CDATA[ ... //]]> or encode the five reserved characters. This is the main reason to prefer a gadget over a theme edit.

Compose view will eat your snippet

The post editor has two modes. Compose escapes anything that looks like markup, so the snippet renders as visible text instead of a widget. Switch to HTML view before pasting, and avoid flipping back to Compose afterwards — Blogger sometimes rewrites the markup when it converts between the two.

Theme edits vanish, gadgets don't

Changing theme, restoring a backup or applying one of Blogger's own themes replaces the whole template, taking any code you pasted into it with it. Gadgets live in your layout settings instead, so they survive. Unless you specifically need the <head> position, use a gadget.

Honest limits

Download counts include automated installs from CI systems and mirrors, so they overstate the number of people using a package. Use them as a relative signal, not a user count.

What you get, and what it costs

  • Free forever — there is no paid tier, no trial and no card
  • No signup for the badge-style widgets; the live ones create a site ID inline from your URL
  • Async script — it never blocks your page from rendering
  • Works on every Blogger theme, on blogspot.com and custom domains, in gadgets and in the post editor's HTML view
  • Bots filtered server-side on every visitor-counting widget

Blogger questions

Do I need a gadget to add a npm downloads badge to Blogger?

Nothing to install. Blogger's own HTML/JavaScript gadget takes raw markup, which is all this needs — and unlike a theme edit, a gadget survives changing your theme. Installing a gadget for this would mean another dependency and update cycle just to show one widget.

Where exactly does the snippet go on Blogger?

The post editor, switched to HTML view, because it belongs beside the install command, in the post or docs page that teaches it.

Will it slow my Blogger site down?

It adds one small script, loaded asynchronously, so it doesn't block your page from rendering. Any third-party script has some cost, so check your page speed before and after adding it. Blogger is served by Google's own infrastructure and the snippet is one async tag, so it loads after your post is already on screen. There's no cache to purge — saving a gadget publishes it immediately.

Does it work with page builders like Layout editor?

Layout editor: Add a Gadget → HTML/JavaScript. Theme editor: Edit HTML, paste above </head> or </body>. Post editor: switch to HTML view, then paste. Blogger mobile app: not supported — use the desktop dashboard. Any builder with a raw-HTML or code block will render it.

Do npm download counts equal users?

No. They include automated installs from build servers and mirrors, so treat them as a rough popularity signal rather than a count of people.