For Businesses

CHOIVE Score Badge & Widget

Add your CHOIVE Score to your website. The badge shows the score from one completed CHOIVE check. People can open the result and see when the check was run. The score shows how clear, trusted, different and easy to choose your business looked during that check. It does not mean every AI tool recommends your business.

Why display your CHOIVE Score?

Your CHOIVE Score shows how clearly explained, trusted, different and easy to choose your business looked during that check. A high score signals:

Clarity: your business is explained clearly for people and AI tools
Credibility: the score links to the CHOIVE result behind it
Transparency: you share how your business looked during the check

Displaying your score shows you check your business in the open, with public information anyone can look at.

Verified, not self-reported

A trust signal only means something if it links back to the real result. Every CHOIVE badge is tied to your check by its check ID. The score you display is read live from CHOIVE, not typed into the embed code. Verified badges carry a ✓ VERIFIED mark and link to the CHOIVE result behind the score.

If anyone embeds a hand-typed number instead of a check ID, the badge renders as UNVERIFIED, so a made-up score does not show as a CHOIVE Score. That is the whole point of the badge.

Three ways to embed

1. Card Widget (Recommended)

(Preview only - your live embed will show VERIFIED once you add your diagnostic ID.)

Full score display with description and link to your verified result. Best for landing pages, about pages, and trust sections. Replace your-diagnostic-id with the ID from your report.

<div id="choive-score" 
     data-job="your-diagnostic-id"></div>
<script src="https://choive.com/choive-widget.js" async></script>

2. Badge (Static Image)

Simple SVG badge, read live from CHOIVE by diagnostic ID. Lightweight, cacheable, works anywhere images work. (The preview above has no ID, so it renders as UNVERIFIED, but yours will show your real score with a ✓.)

<a href="https://choive.com/result?jobId=your-diagnostic-id">
  <img src="https://choive.com/.netlify/functions/badge?job=your-diagnostic-id" 
       alt="CHOIVE Score">
</a>

3. Inline Widget

(Preview only - your live embed will show VERIFIED once you add your diagnostic ID.)

Compact inline display. Perfect for headers, footers, and tight layouts.

<div id="choive-score" 
     data-job="your-diagnostic-id" 
     data-style="inline"></div>
<script src="https://choive.com/choive-widget.js" async></script>

Customization options

Widget attributes

data-job: Your CHOIVE diagnostic ID (verified, the score is fetched live from CHOIVE). Recommended.
data-style: Display style: card, badge, or inline (default: card)
data-theme: Color theme: light or dark (default: light)
data-link: Link to result: true or false (default: true)
data-score: Legacy manual score 0-100. Renders UNVERIFIED (no ✓). Use data-job for a score that links to the real CHOIVE result.

Badge URL parameters

job: Your CHOIVE diagnostic ID (verified, score read live from CHOIVE)
slug: Your diagnostic slug (verified alternative to job)
token: A signed badge token from your report (verified, CDN-cacheable)
style: Badge style: default, flat, or minimal
label: Custom label text (default: "CHOIVE Score")

Example: Dark theme card

<div id="choive-score" 
     data-job="your-diagnostic-id" 
     data-theme="dark"></div>
<script src="https://choive.com/choive-widget.js" async></script>

How to get your score & ID

Run the diagnostic: Visit choive.com and enter your business information
Review your report: See your CHOIVE Score and the full breakdown across all four platforms
Get your embed code: Your report includes your unique business ID and current score
Add to your site: Copy the code and paste it into your HTML

This badge shows one completed check. Run CHOIVE again when your business changes. You will receive a new result. Replace the badge ID if you want to show the new score.

Best practices

Keep it honest: Only display your actual CHOIVE Score, never inflate or round up
Update regularly: Re-run your diagnostic quarterly to keep your score current
Link to your report: Let visitors see the full breakdown (default behavior)
Context matters: Pair your score with evidence: case studies, testimonials, results
Don't hide low scores: A fair score + transparent improvement plan > no score at all

Technical details

Performance: Widget loads async and doesn't block page rendering. Badge is a cacheable SVG (~2KB).
Privacy: No tracking, no cookies, no analytics. Just displays your score.
Accessibility: Both badge and widget include ARIA labels and semantic HTML.
Browser support: Works in all modern browsers. Widget requires JavaScript; badge is a static image.
CORS: Badge endpoint allows cross-origin requests, so it works on any domain.

Questions about the badge

Where do I find my diagnostic ID?

Your Job ID is in the URL of your paid Analysis result. It looks like this: choive.com/?jobId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Copy the part after jobId= and use it as your data-job value.

Can I run CHOIVE again to update my badge score?

Yes. Each new CHOIVE Analysis produces a new Job ID and a new score. Replace the data-job value in your embed code with the new ID to show the updated score. Your old badge will continue to work until you replace it.

Do I need a paid Analysis to use the badge?

Yes. The badge reads your score live from a completed paid Analysis. A free check does not produce a Job ID, so the badge cannot link to it. Run the free check first to see your score, then pay for the full Analysis to get the embeddable badge.