Ko-fi Bulk Shop Item Updater

WHAT IT DOES

This shopping management tool revolutionizes Ko-fi shop inventory management by enabling bulk updates across multiple items simultaneously. It scans your current Ko-fi shop management page, extracting all visible items including their names, IDs, prices, categories, and current status (published or draft). You can then filter items by name, category, or status, select individual items or use the select-all-filtered feature, and apply bulk updates including price changes (fixed amount or percentage adjustment), status toggles (publish/unpublish), or category assignments. The script handles the entire workflow automatically, opening each item's edit modal and applying updates through Ko-fi's own UI controls with proper event propagation.

WHERE IT RUNS

This script operates on Ko-fi shop management pages at *://*.ko-fi.com/shop/, *://*.ko-fi.com//shop, and *://*.ko-fi.com/manage/shop. It integrates as a floating panel on the left side of your browser window when you navigate to your Ko-fi shop manager. The tool works with Ko-fi's dynamic React-based interface, detecting shop items regardless of how they're rendered on the page and adapting to Ko-fi's frequent UI changes. The panel automatically detects your shop ID from the page context for per-shop settings persistence.

HOW TO USE

Navigate to your Ko-fi shop management page (any of the supported URLs).

The panel appears automatically on the left side of the screen.

Click "Refresh" to load all visible items from the current page.

Use the filter input to search items by name.

Use the category filter to show only items in specific categories.

Use the status filter to show only published or draft items.

Check the boxes next to items you want to modify, or use "Select All Filtered".

Select the update action type: "Update Price", "Update Status", or "Update Category".

For price updates: choose "Fixed" or "Percent %" and enter the amount.

For status updates: select "Published" or "Draft" from the dropdown.

For category updates: select a category from the dropdown (auto-populated from your shop).

Click "Apply to Selected" to begin the batch update process.

The status bar shows progress and any errors encountered during processing.

REACT EVENT PROPAGATION MECHANISM

The tool succeeds where browser extensions fail because it operates directly within Ko-fi's own JavaScript context, bypassing cross-origin restrictions that prevent external extensions from accessing Ko-fi's internal React state. It uses React event propagation by dispatching both "input" and "change" events with proper bubbling flags (bubbles: true), ensuring Ko-fi's virtual DOM reconciles the updates correctly and persists the changes. The script implements a concurrency cap of 4 simultaneous operations with 300ms spacing between each, preventing Ko-fi's rate limiting from blocking requests while maintaining efficient throughput. The tool intelligently detects form fields by scanning for name attributes, placeholder text, and data-testid attributes, using comprehensive error recovery for each item operation. Price calculations support both fixed amounts and percentage-based adjustments, with automatic rounding to two decimal places for currency precision.

THE PANEL

The floating panel is draggable to any position on screen and remembers its location between sessions using GM_setValue. It automatically collapses to a small icon when minimized and expands on hover or click. The panel is resizable to suit your workspace needs and can be dismissed with the Escape key. It snaps to the left edge by default but can be positioned anywhere, with position persisted across browsing sessions for consistent placement. All settings persist automatically across sessions, including your recently used price adjustments (per shop) and category history.

PLEASE NOTE

This script requires the free BotGentz extension to run user scripts on Ko-fi. Ko-fi frequently updates its shop interface, which may temporarily break functionality; updates are released regularly to maintain compatibility. The script only reads visible item information from the page and does not store or transmit any data externally. All processing occurs locally in your browser. Updates are applied exactly as configured; verify your price changes, status toggles, and category assignments before bulk application to avoid unintended modifications. The script remembers your price adjustment history for quick reuse in future sessions.