Universal Stock Alert Badge

WHAT IT DOES

This script extracts and displays stock status on any e-commerce product page, giving you a quick visual indicator of product availability. When you visit a product page, the script scans for stock information—phrases like "In Stock," "Out of Stock," "Available," "Sold Out," "Pre-order," "Backordered," or "Low Stock"—and displays a color-coded badge near the product title or price. The badge shows a colored dot and the status label: green for In Stock, yellow for Low Stock, red for Out of Stock, blue for Pre-order, and orange for Backordered. You can customize the keywords and colors for each status type in the settings panel. The badge updates dynamically as you navigate or select product variations.

WHERE IT RUNS

The script runs on all websites (*://*/*), making it truly universal. It works on product pages from Amazon, Walmart, Target, Best Buy, eBay, and any other e-commerce site. It supports both desktop and mobile views.

HOW TO USE

After installation, the settings panel appears on the left side of the screen with the gear emoji (⚙️). Open the panel to configure the script:

- The "Show stock alert badge" toggle enables or disables the badge.

- Customize each stock status type (In Stock, Low Stock, Out of Stock, Pre-order, Backordered) with your own keywords, colors, and labels.

- Click "Refresh badge" to manually re-scan the page for stock information.

- Click "Reset custom keywords" to restore the default settings.

The badge appears automatically on product pages. It shows the stock status and a colored dot indicator.

TECHNICAL SECTION — REAL MECHANISM

The script detects product pages by scanning for common e-commerce elements. It finds stock status information using selectors like .stock-status, .availability, .stock, .in-stock, .out-of-stock, .product-availability, and [data-testid*="stock"]. It extracts the status text from these elements. If no specific stock element is found, it scans the page text for keywords associated with each status type. The default status types are In Stock, Low Stock, Out of Stock, Pre-order, and Backordered, each with a list of keywords and a color. Users can override these with custom keywords and colors. The badge is created as a styled span with a colored dot and status label, inserted near the product title or price using DOM insertion (insertBefore). A MutationObserver watches for DOM changes and updates the badge when the user navigates or selects variations. The custom keywords are stored as an object via GM_setValue.

THE PANEL

The settings panel is built with BotGentz's BGPanel component. It is draggable via its header, allowing you to reposition it anywhere on the screen. The panel snaps to the left edge by default but can be moved freely. Click the gear emoji to collapse the panel into a small bubble, and click the bubble to expand it again. The panel remembers its position per page session. Press the Escape key to quickly close or minimize the panel. The panel includes a status flash bar that provides visual feedback when settings are changed or actions are performed. All settings save automatically via GM_setValue.

PLEASE NOTE

This script requires the free BotGentz browser extension to run. It does not function as a standalone Chrome extension and does not use chrome.* APIs. The script works on most e-commerce sites, but some sites may use non-standard HTML structures that prevent automatic extraction. The stock status detection is based on text matching—if the site uses unusual phrasing, you may need to add custom keywords. The script stores only your preferences and custom keywords via GM_setValue. No data is sent externally—all data is stored locally in your browser. The script never reads or writes password fields, hidden inputs, or file inputs. All DOM operations use safe methods (style properties, textContent, appendChild) and never use innerHTML.