Yotpo Review Sync Status Badge

WHAT IT DOES

This userscript adds real-time sync visibility to your Yotpo review dashboard. It reads review sync status data from the page—extracting sync status (synced, pending, in progress, failed), sync timestamps, and review metadata—and displays a color-coded badge on every review row. The badge shows the sync status with a color indicator: green for synced, yellow for pending/in progress, and red for failed. Sync delay (time since last sync) is displayed in minutes, hours, or days. A summary panel shows total reviews, sync success rate, average sync delay, and counts of synced, pending, and failed reviews. This is invaluable for ecommerce managers, marketing teams, and customer experience professionals who need to monitor review synchronization between Yotpo and their ecommerce platform, ensure reviews are properly synced, and troubleshoot failed syncs.

WHERE IT RUNS

The script runs on all Yotpo web application pages at *.yotpo.com/*, with automatic detection of review lists, the sync dashboard, and any page displaying review sync status information. It works across all Yotpo interfaces by using multiple selector strategies to find review rows, sync status indicators, timestamps, and review metadata. The script detects dynamic content loading and re-applies sync status badges when the review list updates. It runs across the entire Yotpo domain, ensuring coverage whether you're viewing your main review dashboard, a specific product's reviews, or the sync log.

HOW TO USE

Install the script via the BotGentz extension and navigate to your Yotpo review dashboard. Sync status badges will appear automatically on every review row. Each badge shows the sync status with a color-coded label and sync delay time. The summary panel shows total reviews, sync success rate, average sync delay, and counts of synced, pending, and failed reviews. Use the panel controls to customize your experience: toggle sync status badges on or off, show or hide the summary metrics, enable or disable sync delay display, or set auto-refresh on page load. You can customize the colors for each sync status using the color pickers in the panel. The "Refresh" button manually rescans the page for updated sync data, and the "Copy summary" button exports the sync summary to your clipboard.

THE MECHANISM - SYNC STATUS EXTRACTION, DELAY CALCULATION, AND METRICS AGGREGATION

This script identifies sync data by scanning each review row using a cascading selector strategy. It extracts sync status from status badges (.sync-status, .status, .review-status) using text matching and class analysis, normalizing status to "synced," "pending," "in_progress," or "failed." Sync timestamps are extracted from time elements or parsed from relative time strings ("2 hours ago," "3 days ago"), and sync delay is calculated as the time since the last sync in minutes. The script aggregates metrics including total reviews, synced count, pending count, failed count, success rate, and average sync delay. The badge is created as a DOM element with inline styles and inserted into the review row. The summary panel provides a quick overview of sync health with color-coded metrics.

THE PANEL

The control panel appears as a floating, draggable element that you can position anywhere on the Yotpo page. Drag by the header to reposition it, and the position is saved per site using GM_setValue so it stays where you left it across sessions. Release the panel near any edge and it snaps into place, keeping your workspace organized. Click the panel header to collapse it into a small bubble showing only the chart emoji (📊), minimizing distraction while keeping controls accessible. Drag from the bubble to restore the full panel. The panel automatically resizes to fit its content and includes all setting toggles, color controls, action buttons, and a sync legend. Press the Escape key to quickly collapse the panel to its minimized state. The panel remains visible across page navigation within Yotpo, with sync badges updating automatically as you move between views.

PLEASE NOTE

This script requires the free BotGentz extension to function. It is designed for Yotpo users who need to monitor review synchronization and ensure data accuracy. The script reads only visible sync data from the DOM—it does not access Yotpo's API, your account credentials, or any sensitive information. All settings (badge visibility, summary toggle, delay toggle, auto-refresh, color mappings, and panel position) are stored locally using GM_setValue and never leave your browser. The script does not modify your Yotpo data—it only reads and visualizes visible sync information. Sync delay calculations are based on your system's current time and the timestamps visible on the page; if Yotpo updates its website structure or sync indicators, the script may need to be updated to match new selectors. The success rate is calculated as synced reviews divided by total reviews and should be used as a general health indicator.