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=smEmbed 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.