Squarespace · free forever · no signup

Add a free GitHub stars badge to Squarespace

This guide shows how to add a github stars badge for Squarespace in about a minute, with no extension: you paste one snippet into a Code Block on the page, because it's social proof for a specific project, so it goes inline next to what it's vouching for. No extension. Squarespace renders raw HTML and script tags inside a Code Block, so there is nothing to install from the Extensions marketplace.

What this github stars badge for Squarespace shows

The GitHub stars badge shows the live star count of a public repository as a small pill that links to the repo. It's social proof for open-source projects: a docs site, a project landing page or a developer's portfolio can show at a glance that people use and follow the project.

How to add a GitHub stars badge to Squarespace

  1. 1Open the page in the editor and click an insert point where the widget belongs.
  2. 2Click Add Block and choose Code.
  3. 3Paste the snippet, keep the mode set to HTML, and save.
  4. 4The editor shows a placeholder rather than the widget — open the live page to see it render.
On the Personal plan, or no Code Injection? Code Blocks execute JavaScript only on paid plans above Personal. If you see the raw code as text or an empty box on a live page, that's the plan gate, not a broken snippet.

Where it works best on a Squarespace site

On Squarespace, the right spot is a Code Block on the page. A star count vouches for one specific project, so put it inline, right next to that project's name or install instructions, rather than in a sitewide footer.

Squarespace plan and editor requirements

On Squarespace's current plans, Code Injection (Settings → Advanced → Code Injection) is available on Core, Plus and Advanced, and on the older Business and Commerce plans, but not on Basic or the older Personal plan. Code Blocks exist on every plan, but JavaScript inside them only runs on those same higher plans, so on Basic you'll see the block but not the widget. Custom code never runs on checkout pages.

Three things that trip people up on Squarespace

Two different plan gates to know about

Code Injection (Settings → Advanced) needs Core, Plus or Advanced (or the older Business and Commerce plans). Code Blocks exist on every plan, but JavaScript inside them only runs on those same plans. So on Basic or the older Personal plan you see the block but not the widget — move up a plan or use a service that renders a plain image.

The editor never shows the widget

Squarespace renders a grey placeholder for Code Blocks while you're editing and doesn't run injected scripts in the editor at all. Save, then open the live URL in a normal tab — and hard-refresh, because Squarespace caches aggressively at the edge. Most 'it doesn't work' reports are an editor-only check.

7.0 templates with AJAX loading can swallow it

Brine-family 7.0 templates load pages via AJAX, so a script placed in the body may not re-run when a visitor clicks through your nav — the widget appears on first load and vanishes afterwards. Fix: Site Styles → uncheck Enable Ajax Loading, or put the snippet in Code Injection Header instead so it runs once for the whole session.

Honest limits

It works for public repositories only. Stars show interest, not quality or how many people actively use the project.

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 in 7.1 and 7.0 templates, in Code Blocks on every paid plan, and in site-wide Code Injection on Business and above
  • Bots filtered server-side on every visitor-counting widget

Squarespace questions

Do I need an extension to add a GitHub stars badge to Squarespace?

No extension. Squarespace renders raw HTML and script tags inside a Code Block, so there is nothing to install from the Extensions marketplace. Installing an extension for this would mean another dependency and update cycle just to show one widget.

Where exactly does the snippet go on Squarespace?

A Code Block on the page, because it's social proof for a specific project, so it goes inline next to what it's vouching for.

Will it slow my Squarespace 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. Squarespace serves your site from its own CDN and the snippet is one async tag, so it loads beside your content. Prefer the Footer field over Header in Code Injection for anything script-based — it keeps the tag out of the critical path on every page at once.

Does it work with page builders like Squarespace 7.1 editor?

Squarespace 7.1 editor: Add Block → Code. Code Injection: Settings → Advanced → Header or Footer. Page Settings: Advanced → per-page code injection on Business and above. 7.0 templates: same Code Block, plus turn off Ajax loading. Any builder with a raw-HTML or code block will render it.

Does the GitHub badge work for private repositories?

No. It reads the public star count, so the repository has to be public.