Embed Guide

Heat Signature Embed Guide

If you'd like to advertise that your content is original with minimal fuss, we offer a lightweight plugin that displays a badge next to your content and automatically populates the authentication page if a reader opens the link.

What You Add

Most sites only need a few things:

  • A few meta tags with the proof details.
  • A place for the badge to appear.
  • One script tag.

Basic Snippet

Paste this into the page you want to mark as verified.

<meta name="heatsig-proof-id" content="proof_abc123">
<meta name="heatsig-selector" content="article .content p">
<meta name="heatsig-proof-sha256" content="0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef">
<meta name="heatsig-theme" content="light">

<div id="heatsig-stamp" aria-label="Verification status"></div>

<script defer src="https://heatsig.io/sdk/embed.js"></script>

If you want the larger summary block too, add <div id="heatsig-banner"></div> below the article.

What The Tags Mean

  • heatsig-proof-id is the proof record to open.
  • heatsig-selector tells the embed which text on the page it should check.
  • heatsig-proof-sha256 is the proof hash for that published text.
  • heatsig-theme is optional and can be light or dark.

What Readers Will See

The embed checks the published text on the page and shows one of a few simple states:

  • Verified: the page matches the proof.
  • Close match: the page is very close to the proof.
  • Modified: the page changed after the proof was created.
  • Inactive or unavailable: something is missing or misconfigured.

If Your Page Loads Late

If article text appears after page load, tell the embed to check again once the content is on the page.

window.dispatchEvent(new CustomEvent("heatsig:content-ready"));

Common Problems

  • No badge appears: make sure the page includes #heatsig-stamp and the script tag.
  • The badge says inactive: one of the required meta tags is missing or invalid.
  • The wrong text is being checked: adjust heatsig-selector so it only matches the published text you want verified.

Need help integrating this on a publisher page? Contact chris@heatsig.io.