Embeddable Badge

Display your identity and trust score

Embed a live Signet Score badge on your website, documentation, or marketplace listing. The badge fetches your agent's latest score in real time and works on any site with a single line of HTML.

How it works

The Signet badge is a lightweight, self-contained JavaScript widget that renders inside a Shadow DOM for complete style isolation. Drop the embed snippet onto any page and it automatically fetches your agent's current Signet Score from the public API, displays it in a compact card, and keeps a five-minute local cache so repeat page views are instant.

Each badge shows the agent's truncated SID, overall score, confidence tier, and a link back to the full Signet profile. It works on static sites, SPAs, CMSs, and anywhere else you can paste HTML.

HTML embed

Copy and paste the following snippet into your HTML. Replace the data-sid value with your agent's SID.

<div data-signet-badge data-sid="SID-0x7a3f...e91d"></div>
<script src="https://agentsignet.com/badge.js" async></script>

The script tag only needs to appear once per page, even if you embed multiple badges.

React component

If you are using React (or Next.js, Remix, etc.), you can load the badge with a simple component:

import { useEffect } from 'react';

export function SignetBadge({ sid, theme = 'light', size = 'md' }) {
  useEffect(() => {
    const existing = document.querySelector(
      'script[src="https://agentsignet.com/badge.js"]'
    );
    if (!existing) {
      const s = document.createElement('script');
      s.src = 'https://agentsignet.com/badge.js';
      s.async = true;
      document.body.appendChild(s);
    }
  }, []);

  return (
    <div
      data-signet-badge
      data-sid={sid}
      data-theme={theme}
      data-size={size}
    />
  );
}

Customization

Control appearance with data attributes on the badge element:

  • data-theme -- "light" (default) or "dark". Light uses a white background with dark text; dark uses a deep navy background with white text.
  • data-size -- "md" (default) or "sm". The sm variant is a more compact badge suited for sidebars, footers, or tight layouts.

Example with all options:

<div
  data-signet-badge
  data-sid="SID-0x7a3f...e91d"
  data-theme="dark"
  data-size="sm"
></div>

Static image

If you cannot run JavaScript (e.g. in an email or a Markdown README), use the static image endpoint instead. The image is generated server-side and returns a PNG badge:

https://api.agentsignet.com/badge/SID-0x7a3f...e91d.png
https://api.agentsignet.com/badge/SID-0x7a3f...e91d.png?theme=dark&size=sm

Embed the image with a standard <img> tag or Markdown image syntax. The image refreshes every 15 minutes.

Show the world your agent is verified

Register your agent with Signet to receive a permanent identity (SID) and start displaying a verified trust score on your site.