Amazon Return Window Countdown

WHAT IT DOES

This script adds visible countdown timers to your Amazon order history, showing exactly how many days you have left to return each item. When you view your orders page, the script identifies each order, extracts the delivery date, calculates the return window end date (typically 30 days from delivery), and displays a color-coded badge next to each order showing the remaining days. The badge colors indicate urgency: green for more than 15 days remaining, yellow for 7-15 days, orange for 3-7 days, and red for less than 3 days. Orders with expired return windows show a red "Expired" badge. A summary banner at the top of the order history page shows how many orders have return windows expiring within the next 7 days, helping you prioritize returns before it's too late. The countdowns update automatically every minute, so you always see accurate remaining time without refreshing the page.

WHERE IT RUNS

The script runs on all major Amazon domains, including .com, .co.uk, .ca, .de, .fr, .it, .es, .com.au, and .co.jp. It works on order history pages (/orders/, /order-history/, /gp/order-history/, /your-orders/) and individual order detail pages (/order-details/, /gp/order-details/). It handles both desktop and mobile views and processes orders as they load.

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 return window countdowns" toggle enables or disables the countdown badges.

- Toggle "Show summary banner" to display or hide the summary banner at the top of the order history page.

- Click "Refresh countdowns" to manually recalculate all countdowns and update the display.

- Click "Clear cached dates" to remove all stored return date data and force re-parsing of order information.

The script works automatically—just visit your Amazon order history and the countdown badges will appear next to each order. The summary banner shows a warning when orders are approaching their return window expiration.

TECHNICAL SECTION — REAL MECHANISM

The script detects order history pages by checking the URL for patterns like /orders/, /order-history/, /gp/order-history/, /your-orders/, /order-details/, or /gp/order-details/. It finds order containers using selectors such as .order-card, .a-box-group .a-box, .a-section.a-spacing-base, and .a-fixed-left-grid, filtering for elements that contain links or price information. For each order container, the script extracts the delivery date by searching for text containing "Delivered," "delivery," "Arrived," or "Ship" followed by a date pattern. It uses multiple date parsing strategies to handle various Amazon date formats, including "January 15, 2024," "15 Jan 2024," and "2024-01-15." The return window end date is calculated as the delivery date plus 30 days. The script stores parsed dates locally using GM_setValue with keys like 'bg_return_dates_' + orderId to avoid re-parsing on subsequent page visits. A countdown badge is inserted into each order container using style properties and textContent (never innerHTML). The script uses setInterval to update all badges every 60 seconds, recalculating days remaining and updating colors. A MutationObserver watches for new orders being loaded via pagination or dynamic content and processes them automatically. The summary banner counts orders with 7 or fewer days remaining and displays a warning message.

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 and cached dates 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. Amazon's return window policy is typically 30 days from delivery, but this may vary by product category, seller, or region. The script uses the standard 30-day window; it does not account for extended holiday return periods or special exceptions. Amazon frequently updates its order history page structure, which may break the selectors used to find orders and extract delivery dates. If the script stops working, please check for updates. The script stores only cached return dates and 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.