Square Bulk Inventory Price Updater

WHAT IT DOES

Square Bulk Inventory Price Updater solves a common retail management challenge: updating prices for multiple Square inventory items is tedious when done one at a time. While Square allows individual item editing, there is no native way to apply consistent price changes across many items simultaneously. This tool reads your current Square inventory items list page, detects all visible inventory items, and displays them in a scrollable checklist with item names, SKUs, current prices, and stock quantities. You can select multiple items and apply a price change: increase by percentage, decrease by percentage, or set a fixed price. The tool also supports updating prices for different variations of the same item. A preview shows the old vs. new prices for selected items before you apply the change. Progress tracking shows each item as it's updated, and you can export a report of all inventory price data as CSV or JSON.

WHERE IT RUNS

This extension panel runs directly inside your browser as an overlay on Square's inventory management page. It works on the Items list, Inventory dashboard, and catalog views. The tool detects items from the page's DOM and uses Square's official API (via GM_xmlhttpRequest) for price updates. It requires no additional API keys beyond your existing authenticated session — the tool extracts your access token from the page.

HOW TO USE

After installing the BotGentz extension and activating Square Bulk Inventory Price Updater, navigate to your Square inventory items list page. Click the extension icon in your browser toolbar to open the panel. The tool automatically detects all inventory items displayed on the current page. Each item appears with its name, SKU, current price, stock quantity, and variation alongside a checkbox. Choose your price change method: Increase by Percentage, Decrease by Percentage, or Set Fixed Price. Enter the value accordingly. The preview section shows how many items are selected and the price change that will be applied, including a sample of old → new prices. Click "Update Prices" to apply the changes. The tool processes each item sequentially with a 500ms delay through Square's Catalog API, showing progress as each item is updated. Click "Export Report" to copy a report of all item data to your clipboard in CSV or JSON format. Click "Refresh" to reload the list.

TECHNICAL OPERATION — Square Catalog API Price Updates

This tool uses Square's Catalog API (version 2024-01-17) to perform price updates reliably. It first extracts the user's access token and location ID from the page (using regex to find `access_token` in scripts or meta tags), then constructs a PUT request to `/v2/catalog/objects/{itemId}` with a payload containing the updated `price_money` amount for the item variation. The price is converted to cents (multiplied by 100) as required by Square's API. The tool calculates the new price based on the user's chosen method (percentage increase, percentage decrease, or fixed price) and preserves all other item data. The API approach is more reliable than DOM-based simulation because it works independently of Square's UI structure, supports proper error handling with HTTP status codes, and can handle large numbers of items efficiently without triggering UI event delays. A 500ms delay between updates prevents rate limiting and API congestion.

THE PANEL

The extension panel is fully draggable and remembers its position per site session. It snaps to the nearest edge of the browser viewport when dragged within 50 pixels of any side. You can collapse the panel to a compact title bar using the minimize button, preserving your selection state. The panel resizes vertically by dragging the bottom edge. Press the Escape key to close the panel instantly without losing your item selection. The preview updates in real-time as you select items or change the price settings.

PLEASE NOTE

This tool requires the free BotGentz extension to function. The script uses Square's Catalog API and requires your session to be authenticated. It does not store, transmit, or log any item data, prices, or user activity. All API requests are made locally from your browser session. The tool relies on extracting your access token from the page, which may expire if your session times out. Square may update its DOM structure over time, which could affect item detection; we monitor and release compatibility updates as needed. Price updates are permanent and affect your live inventory — review the preview carefully before confirming. The tool supports item variations but may not handle all complex catalog structures. Export formats include CSV and JSON for maximum compatibility with analysis tools. Ensure you're on Square's inventory page for the tool to detect items correctly.