CHOIVE Score Badge & Widget

Why display your CHOIVE Score?

Your CHOIVE Score measures whether ChatGPT, Claude, Perplexity, and Gemini pick your business when buyers ask for solutions in your category. A high score signals:

• Trust: AI platforms consistently select you based on public evidence
• Credibility: Third-party validation of your market position
• Transparency: You measure and share how AI sees your business

Displaying your score demonstrates you hold yourself to the same standard AI does: public, evidence-first, auditable.

Verified, not self-reported

A trust signal only means something if it can't be faked. Every CHOIVE badge is tied to your real 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 always reflect your current, measured score.

If anyone embeds a hand-typed number instead of a check ID, the badge renders as UNVERIFIED — so a made-up score can never masquerade as a measured CHOIVE Score. That protection is the whole point of the badge.

Three ways to embed

1. Card Widget (Recommended)

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 — 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

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 real, tamper-proof score.

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

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

The badge updates automatically when you re-run your diagnostic and your score changes.

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 — works on any domain.