Sam's Club Web Instant Savings Overlay

WHAT IT DOES

This tool helps you track instant savings on Sam's Club purchases by extracting product pricing data from the page. It reads item names, regular prices, instant savings discounts, sale prices, savings amounts and percentages, and member-only pricing flags. The panel displays total instant savings for the current shopping trip, highlights items with active savings, and shows how many items are on sale. Potential savings are calculated if all sale items were added to your cart. Savings are tracked by product category, giving you insight into where you're saving the most money. Cumulative savings persist across browsing sessions.

WHERE IT RUNS

The script activates on Sam's Club pages (samsclub.com), including product listings, shopping cart pages, and product detail views. It automatically detects product pricing data using multiple extraction strategies that work across different Sam's Club layouts. The panel appears as a draggable overlay that stays accessible as you browse and add items to your cart.

HOW TO USE

Navigate to a Sam's Club product listing or shopping cart page. The panel will appear showing the current trip's instant savings total, sale item count, and a product list with regular and sale prices. Sale items are highlighted with a green border. The summary shows total items, sale items, cumulative savings, and member-only product count. Set the "Min $" threshold to control which savings amounts are tracked cumulatively (default $1). Toggle "Auto-track on/off" to enable or disable automatic cumulative savings tracking. Select your membership tier (Plus/Business/Standard) for reference display. The "Scan" button manually updates the product data, "Reset Savings" clears cumulative savings history, and "Export" copies all savings data as JSON to your clipboard.

THE TECHNICAL MECHANISM

The script employs a multi-strategy DOM extraction approach for Sam's Club's product interface. It first attempts structured selectors targeting known class names like .product-card, .item-card, and .product-tile, then falls back to heuristic detection of product containers based on content patterns including currency symbols and pricing indicators. Price extraction identifies multiple price points in the text—the highest value is treated as the regular price, and the lowest as the sale price. Savings are calculated as regularPrice - salePrice, and savings percentage is derived from this difference. Instant savings detection uses pattern matching for keywords like "instant savings", "save", and "sale". Member-only pricing detection checks for "member only" or "members only" text. Category extraction attempts to find product categories from dedicated elements or by parsing text patterns like "in [Category] savings". Cumulative savings are stored using GM_setValue with a structured data object containing totalSavings, individual item records, and a category-based breakdown. Auto-track functionality only records savings that exceed the user-defined minimum threshold. All settings are persisted using GM_setValue.

THE PANEL

The panel is fully draggable by its header and remembers its position on the page across sessions. It can be collapsed to a small bubble using the minimize button, then restored by clicking the bubble. The panel resizes automatically to fit its content and can be closed with the Escape key or by clicking the close button. The panel's position and state persist globally, so it returns to the same location on subsequent visits.

PLEASE NOTE

Requires the free BotGentz extension to run. Sam's Club may update its site structure, which could affect the script's ability to detect pricing data — updates will be released as needed. All savings data is stored locally in your browser and is never transmitted externally. This tool is for informational purposes only and does not provide financial advice. The script does not modify your Sam's Club account or perform any transactions. Savings calculations are based on the prices displayed on the page and may not reflect final checkout prices, taxes, or fees. Always verify final savings and costs with your Sam's Club receipt.