HubSpot Bulk List Membership Updater

WHAT IT DOES

This tool helps HubSpot users efficiently manage contact list memberships in bulk. It scans the current contacts list view, extracts contact details including names, emails, and current list memberships, and displays them in a scrollable list with checkboxes. You specify a static list name and choose whether to add or remove contacts from that list, then select which contacts to update. The script navigates to each selected contact's detail page, locates the lists section, and performs the add or remove operation automatically. This is especially useful for segmenting contacts into lists for email campaigns, updating contact lists after events, or cleaning up outdated list memberships without manually editing each contact.

WHERE IT RUNS

The script runs directly inside the HubSpot web interface (hubspot.com) on contacts list pages. It does not require a separate extension popup, background process, or external server. Everything happens within the page context, interacting with HubSpot's React-based DOM components.

HOW TO USE

1. Navigate to a HubSpot contacts list page (Contacts > Contacts or Contacts > Lists).

2. Open the BotGentz panel.

3. Enter the exact name of the static list you want to add contacts to or remove contacts from.

4. Select the action: "Add to List" or "Remove from List".

5. Click "Scan & Apply" to start the process.

6. The script will scan the current view and display matching contacts in a list with checkboxes, showing names, emails, and current list memberships.

7. Select the contacts you want to modify (all are checked by default).

8. Click the apply button (e.g., "Apply List Changes (Add to 'Newsletter')") to begin. The script will process each selected contact, adding or removing them from the specified list.

9. Use "Ignore Selected" to add contacts to an ignore list so they are not shown in future scans.

TECHNICAL MECHANISM

Unlike HubSpot's built-in list operations which may be limited to list pages or require complex workflows, this script operates purely on the public DOM of the HubSpot contacts interface. It identifies contacts using selectors like `tr[data-contact-id]` or `.hs-table-row`, extracting contact IDs from data attributes or URLs. It captures contact names, emails, and existing list memberships from the list view. For each contact update, the script clicks into the contact detail page, locates the lists section (using class patterns like `[class*="lists"]` or `[aria-label*="Lists"]`), and performs the add or remove operation. For adding contacts, it searches for the list by name in the list selector, clicks the list to add it, and saves. For removing contacts, it finds the list chip and clicks the remove button. The script uses exact name matching to ensure the correct list is targeted. All actions include retry logic with spacing to account for HubSpot's dynamic rendering and avoid rate limiting.

THE PANEL

The tool appears as a draggable, resizable panel on the side of your screen. You can drag it to any position by clicking and holding the header, resize it by dragging the bottom-right corner, and collapse it to a small bubble when not in use. Press the Escape key to close the panel. The panel remembers its position and size per site so it stays where you left it on your next visit.

PLEASE NOTE

This script requires the free BotGentz extension to run. It does not store any personal data except for a list of ignored contact IDs, which is saved locally in your browser using GM_setValue. No data is sent to any external server. HubSpot frequently updates its interface, which may break the script. If you encounter issues, check for updates or contact support. The script works only with static lists (not active/contact-based lists). The list name must match exactly as it appears in HubSpot. The script processes contacts one at a time and may be slow for large batches.