Lightspeed POS Inventory Sync Badge

WHAT IT DOES

This userscript adds visual sync status indicators to your Lightspeed POS inventory list. It reads each inventory item's sync status—whether it's synced, pending, or has an error—and displays a compact, color-coded badge directly on each item row. Green badges indicate successful sync, yellow shows pending sync, and red highlights items with sync errors. Beyond individual badges, the script provides a summary panel showing counts and percentages of items in each sync status, giving you an instant snapshot of your inventory sync health. A status filter bar lets you click any status to show only items with that status, helping you quickly identify and troubleshoot items that aren't syncing properly. This helps retail managers, inventory specialists, and IT staff monitor synchronization between Lightspeed and external systems, identify problematic items, and ensure accurate inventory data across all sales channels.

WHERE IT RUNS

The script runs on all Lightspeed POS web application pages at *.lightspeedhq.com/*, with automatic detection of inventory list views including the main inventory screen, item catalog, and any page displaying inventory items in table or list format. It works across all Lightspeed interfaces by using multiple selector strategies to find item rows, sync status indicators, and item names. The script detects dynamic content loading and re-applies badges whenever the inventory list changes, including after filtering, sorting, or pagination. It runs across the entire Lightspeed domain, ensuring coverage whether you're viewing your full catalog, searching for specific items, or reviewing a particular category.

HOW TO USE

Install the script via the BotGentz extension and navigate to any inventory list in Lightspeed POS. Sync status badges will appear automatically on every item row. Each badge shows the status name (Synced, Pending, or Error) with a distinct color. Use the panel controls to toggle badges on or off, show or hide the summary panel, or enable the status filter bar. The summary panel appears above your inventory list showing total items and breakdowns by status with counts and percentages. The filter bar appears as a sticky row with buttons for each status—click any button to show only items with that status, or click "All" to reset the view. You can customize the color for any status using the color picker in the panel. The "Refresh badges" button manually reapplies all badges if the page updates.

THE MECHANISM - STATUS DETECTION, AGGREGATION, AND VISUAL FILTERING

This script identifies sync statuses by scanning each inventory row using a cascading selector strategy. It first looks for Lightspeed's specific status elements including .sync-status, .status, .inventory-status, and [data-test="sync-status"]. When those fail, the script scans for visual indicators like icons or symbols that commonly represent sync states—checkmarks for synced, spinners for pending, and X marks for errors. Status strings are normalized to standard keys (synced, pending, error, unknown) for consistent mapping. Each status is mapped to a color using either the user's custom color mappings or the default scheme (green for synced, yellow for pending, red for error). The badge is created as a DOM element with inline styles and inserted into the item's name cell. For the summary, the script aggregates counts by status and calculates percentage distributions. The filter bar works by toggling the display property of item rows based on whether their status matches the selected filter, providing instant visual filtering without page reloads.

THE PANEL

The control panel appears as a floating, draggable element that you can position anywhere on the Lightspeed 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 inventory 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 management controls, and action buttons. Press the Escape key to quickly collapse the panel to its minimized state. The panel remains visible across page navigation within Lightspeed, with status badges updating automatically as you move between views.

PLEASE NOTE

This script requires the free BotGentz extension to function. It is designed for Lightspeed POS users who need to monitor inventory sync status and troubleshoot syncing issues. The script reads only visible inventory data from the DOM—it does not access Lightspeed's API, your account credentials, or any sensitive information. All settings (status colors, toggle states, and panel position) are stored locally using GM_setValue and never leave your browser. The script does not modify your Lightspeed data—it only enhances the visual presentation of the inventory list. The sync status detection relies on visible DOM elements; if Lightspeed updates its website structure, the script may need to be updated to match new selectors. The summary counts are based on items currently visible in the view and may not reflect your entire inventory if the list is paginated. For complete inventory audits, ensure you load all items before using the script.