Shopify · free forever · no signup

Add a free npm downloads badge to Shopify

One snippet, pasted into the product or page template itself — because it belongs beside the install command, in the post or docs page that teaches it. Shopify powers well over 4 million live stores, and almost none of those sites want another app just to render a small piece of live data. No app. Shopify renders raw HTML and script tags inside a Custom Liquid block, so there is nothing to install from the App Store.

The free npm downloads badge that doesn't refetch an SVG every page load. Shields.io's npm badge is fetched 3rd-party. npm-stat.com is a separate site visitors have to leave for. This npm downloads badge is a 4 KB script tag — pulls the live download count from api.npmjs.org, caches it server-side for 6 hours, and shows 'npm 3.2M downloads / week' as a crisp pill in 7 themes. Free, no API key, no signup, supports scoped packages (@scope/pkg).

How to install it on Shopify

  1. 1Open Online Store → Themes → Customize and select the Product or Default page template.
  2. 2Click Add block inside the main content area and choose Custom Liquid.
  3. 3Paste the snippet, then drag the block to sit directly under the price, the Add to cart button, or wherever it earns its place.
  4. 4Save, then view the live page to confirm.
Older theme, or no Custom Liquid block? For a one-off page you can also use Online Store → Pages, open the page, and click the <> (Show HTML) button in the rich text editor before pasting. Pasting into the visual editor instead silently strips the script tag.

Three things that trip people up on Shopify

Check which theme you actually edited

Shopify lets you customise an unpublished theme, and the editor looks identical either way. If you pasted the snippet, saved, and the live store shows nothing, you almost certainly edited a draft or the duplicate you made as a backup. Online Store → Themes shows which one is under Live — edit that one, or publish the one you edited.

Use Custom Liquid, never the visual editor

Shopify's rich text editor for pages, articles and product descriptions strips script tags on save without warning you. The Custom Liquid block, the <> Show HTML view, and raw .liquid files in Edit code all pass markup through untouched. If your snippet disappeared the moment you saved, that is the reason.

Checkout pages are off limits

Shopify does not allow third-party scripts on checkout — that is a platform restriction, not a widget limitation. Everything else is fair game: home, collection, product, cart, blog, pages and the 404. Put the widget in the footer and it covers all of them in one paste.

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 Dawn and every other Online Store 2.0 theme, on older vintage themes, and inside Shogun, PageFly and GemPages
  • Bots filtered server-side on every visitor-counting widget

Shopify questions

Do I need an app to add a npm downloads badge to Shopify?

No app. Shopify renders raw HTML and script tags inside a Custom Liquid block, so there is nothing to install from the App Store. Installing an app for this would mean an extra dependency, an update cycle and a security surface to render one snippet. Paste it into the product or page template itself and you're done.

Where exactly does the snippet go on Shopify?

The product or page template itself — because it belongs beside the install command, in the post or docs page that teaches it. Open Online Store → Themes → Customize and select the Product or Default page template. Click Add block inside the main content area and choose Custom Liquid. Paste the snippet, then drag the block to sit directly under the price, the Add to cart button, or wherever it earns its place. Save, then view the live page to confirm.

Will it slow my Shopify site down?

No. The script tag is async, so it never blocks your page from rendering, and the widget draws itself after your content is already on screen. Shopify serves your storefront from its own CDN and that doesn't change — the snippet is a single async tag, so it loads alongside your theme instead of in front of it. Nothing needs excluding from Shopify's own minification.

Does it work with page builders like Shogun?

Shogun: drag in the HTML/Liquid element and paste there. PageFly: use the HTML/Liquid element. GemPages: use the Liquid element. Shopify's own theme editor: add a Custom Liquid block. Any builder with a raw-HTML or code block will render it, because there's nothing framework-specific in the snippet.