eBay Listing Photo Count Checker

WHAT IT DOES

eBay Listing Photo Count Checker automatically scans eBay listing pages to count the number of photos attached to the listing and evaluates your photo strategy against eBay's best practices. It analyzes the image gallery container, thumbnail elements, carousel indicators, and image meta-data to determine the total photo count. The tool displays a color-coded rating (Excellent, Good, Fair, Poor, or No Photos) based on eBay's recommendation of 12+ photos for optimal performance. You'll see a visual gallery preview with small thumbnails of the first 16 photos, a detailed breakdown of recommendations, and a checklist of recommended photo types including cover shot, back view, side view, close-ups, dimensions, condition details, and lifestyle shots. The script highlights which photo types are present and which are missing, giving you a clear roadmap to improve your listing's visual presentation and boost buyer confidence.

WHERE IT RUNS

This script runs exclusively on eBay listing pages (*.ebay.com/itm/*). It operates entirely within your browser tab, reading the page's DOM to locate image elements, galleries, and carousel indicators. The script cannot access other tabs, your browsing history, bookmarks, downloads, or any data outside the current eBay listing. All settings—including minimum recommended photos, thumbnail visibility, missing photo highlighting, and auto-analyze preference—are stored locally using GM_setValue and never transmitted anywhere.

HOW TO USE

After installing with the BotGentz extension, the script automatically analyzes any eBay listing you view. The panel displays your photo count in a large badge with a color-coded rating. A gallery preview shows small thumbnails of your photos—hover or scroll to see them all. The recommendations section provides specific, actionable advice like "Add more angles: front, back, side, and top views" or "Show condition details: tags, labels, and any wear or damage." The photo type checklist shows you exactly which types of photos you have (with a ✓) and which you're missing, so you know what to add next. You can adjust the minimum recommended photo count, toggle thumbnails on or off, highlight missing photo types, and disable auto-analyze. Click "Copy Report" to export the full analysis to your clipboard for easy reference when updating your listing.

THE REAL MECHANISM

The script uses a five-layer extraction strategy to find photos regardless of eBay's varying page structures across desktop, mobile, and different listing formats. First, it queries image gallery containers using multiple selectors including vi-image-gallery, image-gallery-item, and carousel__item. Second, it scans for main content images using selectors like itemMainImg and viewer-container. Third, it looks at thumbnail lists using thumb-list, thumbnails, and gallery-thumbnail selectors. Fourth, it counts carousel dots and indicators to infer total photo count when individual image URLs aren't accessible. Fifth, it scans page text for patterns like "X photos" or "image X of Y." The script then deduplicates photo URLs using a Set to avoid counting the same image multiple times. The rating system compares the count against the user-configured minimum (default 12) and applies a tiered rating scale. Recommendations are generated from a rule engine that checks count thresholds and missing photo types, with messages tailored to common eBay best practices including cover shots, multiple angles, close-ups, size references, condition details, and lifestyle imagery.

THE PANEL

The Photo Count Checker panel is a BGPanel component that you can drag anywhere on your screen by its header. It snaps to the nearest edge when released, keeping your workspace organized. The panel collapses to a small bubble showing only the emoji icon when minimised—click to expand it again. You can resize the panel horizontally to see more of the photo gallery and recommendations. Press the Escape key to collapse the panel instantly. Your panel position and size are saved per-site, so it remembers where you like it on your eBay listings.

PLEASE NOTE

This script requires the free BotGentz browser extension to function. eBay frequently updates its listing page layouts, which may change class names, data-testid attributes, and DOM structure. If the script cannot find photos, use the "Count Photos" button to retry extraction. The photo count may vary slightly depending on how eBay loads images dynamically—the script counts only images that are present in the DOM at the time of analysis. Listings with 12+ photos typically see higher conversion rates, but photo quality matters just as much as quantity. Use the recommendations as a guide for improving your visual presentation. The script never reads or writes password fields, hidden inputs, or file inputs. It stores only your minimum photo count, thumbnail visibility, missing photo highlighting, and auto-analyze preferences locally. No listing data, photo information, or personal information is ever collected, transmitted, or shared.