PayPal Bulk Transaction Categorizer

WHAT IT DOES

PayPal Bulk Transaction Categorizer lets you assign categories to multiple transactions in a single operation. Instead of opening each transaction individually, selecting a category, and saving — repeating this for every single transaction — this tool provides a unified checklist of all transactions on the current page. You can filter transactions by description or transaction ID to quickly find the ones you want to categorize. Select any number of transactions using checkboxes, choose a category from the dropdown, and click Apply. The tool then automatically processes each selected transaction — opening the categorization modal, setting the selected category, and saving the change. This turns what could be dozens of manual operations into a single batch action, making expense tracking and financial organization significantly faster and more consistent.

WHERE IT RUNS

This script runs exclusively on the PayPal web application in your browser. It activates on the transaction list page, activity reports, and transaction history views. It requires the BotGentz extension to inject and execute the script. The tool does not work on the PayPal mobile app, the API, or any third-party PayPal clients — only the web-based PayPal interface accessed through a Chromium-based or Firefox browser. It specifically targets pages under *.paypal.com, including the PayPal activity and transaction history views.

HOW TO USE

After installing the script via BotGentz, log in to your PayPal account and navigate to the Activity or Transaction History page. The tool automatically detects the transaction list and displays a floating panel on the right side. The panel shows all transactions on the current page, with checkboxes next to each transaction entry. Each transaction displays its ID, date, description, amount, and status. Use the search box to filter by description or transaction ID to narrow down your selection. Check the boxes for every transaction you want to categorize. Below the transaction list, select a category from the dropdown — common categories include Business, Personal, Travel, Food, Utilities, Entertainment, Shopping, Income, and Tax. Click "Apply Category" and confirm the action. The tool will process each selected transaction one by one — opening the categorization modal, setting the selected category, and saving. A status message appears when the operation completes, showing how many transactions were successfully categorized.

THE ACTUAL MECHANISM — WHY IT WORKS

PayPal's web interface is built with React and uses a component-based rendering system for its transaction management. The transaction list is rendered as table rows or list items, each containing transaction metadata and action buttons. This tool scans the DOM for transaction items using multiple selector patterns that PayPal consistently uses across versions. For each transaction, it extracts the ID, date, description, amount, and status from the visible text content and data attributes. Each transaction is assigned a unique identifier from data attributes or checkbox values. When categorizing, the tool locates the category button within each transaction item or accesses it through the action menu. The tool then opens the categorization modal, selects the chosen category from the dropdown using React-friendly event dispatching — setting the value via the native setter and dispatching both "input" and "change" events to ensure React registers the update. The tool then clicks the modal's save/confirm button, waits for the modal to close, and proceeds to the next transaction. This approach works without making direct API calls, which would require authentication credentials and knowledge of PayPal's internal API structure. By using the existing UI, the tool works within PayPal's own permission and validation system, and continues to function even if the underlying API changes.

THE PANEL

The floating panel is fully draggable — click and drag the header to reposition it anywhere on the page. The panel's position is saved per site in localStorage, so it reappears exactly where you left it when you return to the activity page. Double-click the header to snap the panel to the nearest edge (left or right). A collapse button minimizes the panel to a small tab showing a dollar emoji badge, keeping it out of the way while still accessible. The transaction list inside the panel is scrollable and resizes vertically based on the number of transactions. Pressing Escape while the panel is focused closes it completely; reopening is done via a small button injected near the page toolbar. All panel interactions are non-blocking — PayPal's main UI remains fully responsive while the panel is open, and the panel updates automatically when you navigate between pages or date ranges.

PLEASE NOTE

This script requires the BotGentz extension (free) to run user scripts on PayPal. PayPal frequently updates its web interface and modal structures; if the tool stops working, check for an updated version within BotGentz's script repository. This tool does not store, transmit, or log any transaction data, financial information, or category assignments — all operations occur locally in your browser with no external network requests except those made by PayPal itself. Category assignments are applied through PayPal's own UI event system, so all changes respect your account preferences and categorization settings. The tool does not bypass PayPal's security or permission system; it simply automates the clicks you would otherwise perform manually. For accounts with a large number of transactions, the tool may take several minutes to complete the operation, as each transaction is processed sequentially with delays to avoid overwhelming the UI. A progress indicator shows which transaction is currently being processed. Always double-check your selections and category choice before applying changes, as categorized transactions may affect reports and financial tracking. The tool only affects transactions visible on the current page; to categorize all transactions, use PayPal's built-in pagination controls or adjust your date range filters to show all relevant transactions. The category dropdown is populated from categories detected on the page, with fallback defaults for common use cases. Categories may vary depending on your PayPal account settings.