TC
The Comparator
Academy Wiki / Integration Guide

Widget Embed Guide for Publishers

Step-by-step documentation on embedding Deal Monitors, Value Meters, and Comparison Widgets into WordPress, Ghost, and custom CMSs.

Widget Embed Guide for Publishers

The Comparator provides lightweight, interactive hardware value widgets that publishers can embed directly into tech reviews and buyer guides.

1. Widget Types & Use Cases

Widget Type Ideal Article Placement What It Displays Preview Link
Deal Monitor Product Review Cards Live lowest market price, stock status, 30-day price trend View Demo
Value Meter Conclusion / Verdict Section Algorithmic $0-100$ Value Score gauge relative to market View Demo
Versus Comparison Head-to-Head Comparison Articles Side-by-side spec comparison table & winner verdict View Demo

2. Standard iFrame Embedding

Paste the standard responsive iFrame code directly into your article editor HTML block:

<!-- The Comparator Deal Monitor Widget -->
<iframe src="https://thecomparator.tech/static/embed/deal-ryzen-7-9800x3d.html" 
        width="100%" 
        height="450" 
        frameborder="0" 
        scrolling="no"
        loading="lazy" 
        title="AMD Ryzen 7 9800X3D Live Price & Value Score">
</iframe>

3. CMS Platform Specific Instructions

WordPress (Gutenberg Editor)

  1. Add a Custom HTML block inside your post editor.
  2. Paste the <iframe> snippet above.
  3. Save or publish your article.

Ghost CMS

  1. Click the + icon in the Ghost editor and select HTML Card.
  2. Paste the <iframe> snippet.

Webflow / Custom Platforms

Paste the code inside an Embed Component.

4. Customizing Widget Parameters

You can pass URL query parameters to customize widget behavior:

  • theme=dark or theme=light: Force specific color scheme.
  • currency=USD: Specify market currency.
  • subid=your_publisher_tag: Attach your custom affiliate tracking tag.

Example:

<iframe src="https://thecomparator.tech/static/embed/deal-ryzen-7-9800x3d.html?theme=dark&subid=techblog_review_2026" ...></iframe>