Etsy Shipping Cost Aggregator

WHAT IT DOES

This script aggregates shipping costs on Etsy cart and checkout pages, giving you a clear overview of all shipping charges. When you're on the cart or checkout page, the script identifies shipping costs for each item, totals them, and displays a breakdown in the settings panel. You can see the total shipping cost, a per-item breakdown (item title, quantity, shipping cost, and delivery estimate), and a comparison of available shipping options. The display updates dynamically as you change quantities, add or remove items, or select different shipping methods. A toggle lets you enable or disable the aggregator, and an option controls whether the per-item breakdown is shown.

WHERE IT RUNS

The script runs on all Etsy pages (*.etsy.com). It works on the cart page (/cart), checkout page (/checkout), and purchase page (/purchase). 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 "Enable shipping aggregator" toggle enables or disables the script.

- Toggle "Show item breakdown" to show or hide the per-item shipping cost breakdown.

- Click "Refresh shipping costs" to manually update the display.

The shipping cost breakdown appears in the panel when you're on the cart or checkout page. It updates automatically as you make changes.

TECHNICAL SECTION — REAL MECHANISM

The script detects Etsy cart and checkout pages by checking the URL for /cart, /checkout, or /purchase. It finds cart items using selectors like .cart-item, .cart-item-row, .checkout-item, and .purchase-item. For each item, it extracts the title from .cart-item-title, .item-title, or .listing-title, the price from .cart-item-price or .item-price, and the shipping cost from .shipping-cost, .item-shipping, or .delivery-cost. Quantity is extracted from .cart-item-quantity or .quantity. Delivery estimates are extracted from .delivery-estimate or .shipping-estimate. The total shipping cost is extracted from .shipping-total, .total-shipping, or .cart-total-shipping. Shipping options are extracted from .shipping-option, .shipping-method, or .delivery-option, with the option name, cost, and delivery estimate extracted from child elements. The display is rendered using style properties and textContent (never innerHTML). A MutationObserver watches for DOM changes and updates the display when the cart or checkout page changes.

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. Etsy frequently updates its cart and checkout interface, which may affect the selectors used to find shipping costs and item information. If the script stops working, please check for updates. The script aggregates shipping costs from the page—if shipping costs are not visible or are displayed differently, they may not be detected correctly. The script stores only your preferences 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.