Home Assistant Bulk Entity Renamer

WHAT IT DOES

Home Assistant Bulk Entity Renamer lets you rename multiple entities in a single operation. Instead of opening each entity's settings individually, navigating to the name field, editing the text, and saving — repeating this for every single entity — this tool provides a unified checklist of all entities on the current page. You can filter entities by domain or state to quickly find the ones you want to rename. Select any number of entities using checkboxes, choose your rename pattern (Add prefix, Add suffix, or Replace), enter the pattern text, and click Rename. The tool then automatically processes each selected entity — opening the settings modal, applying the name pattern, and saving the changes. This turns what could be dozens of manual operations into a single batch action, making Home Assistant entity organization and management significantly faster and more consistent.

WHERE IT RUNS

This script runs exclusively on the Home Assistant web application in your browser. It activates on the Entities page and configuration views within the Home Assistant interface. It requires the BotGentz extension to inject and execute the script. The tool does not work on the Home Assistant mobile app, the API, or any third-party Home Assistant clients — only the web-based Home Assistant interface accessed through a Chromium-based or Firefox browser. It specifically targets pages under *.home-assistant.io, including the Home Assistant entities and configuration views.

HOW TO USE

After installing the script via BotGentz, navigate to your Home Assistant dashboard and open the Entities page (Settings → Devices & Services → Entities). The tool automatically detects the entity list and displays a floating panel on the right side. The panel shows all entities on the current page, with checkboxes next to each entity entry. Each entity displays its friendly name, entity ID, domain, and current state with a color indicator. Use the search box to filter by name or entity ID, or use the domain filter dropdown to show only entities from a specific domain. Check the boxes for every entity you want to rename. Below the entity list, select your rename pattern — "Add prefix" to add text before the existing name, "Add suffix" to add text after the existing name, or "Replace" to replace part of the name (use the format "old|new"). Enter the pattern text in the input field. Click "Rename Entities" and confirm the action. The tool will process each selected entity one by one — opening the settings modal, applying the name pattern, and saving. A status message appears when the operation completes, showing how many entities were successfully renamed.

THE ACTUAL MECHANISM — WHY IT WORKS

Home Assistant's web interface is built with LitElement and uses a component-based rendering system for its entity management. The entity list is rendered as table rows or cards, each containing entity metadata and action buttons. This tool scans the DOM for entity items using multiple selector patterns that Home Assistant consistently uses across versions. For each entity, it extracts the friendly name, entity ID, domain, and state from the visible text content and data attributes. Each entity is assigned a unique identifier from data attributes or checkbox values. When renaming, the tool locates the settings/edit button within each entity item and triggers a click event that opens the entity's settings modal. The tool then applies the selected pattern — adding a prefix or suffix, or performing a text replacement using JavaScript's replace method. The tool sets the new name value using React-friendly event dispatching — setting the value via the native setter and dispatching both "input" and "change" events to ensure the framework registers the update. The tool then clicks the modal's save/update button, waits for the modal to close, and proceeds to the next entity. This approach works without making direct API calls, which would require authentication credentials and knowledge of Home Assistant's internal API structure. By using the existing UI, the tool works within Home Assistant'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 entities 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 home emoji badge, keeping it out of the way while still accessible. The entity list inside the panel is scrollable and resizes vertically based on the number of entities. 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 — Home Assistant's main UI remains fully responsive while the panel is open, and the panel updates automatically when you navigate between pages.

PLEASE NOTE

This script requires the BotGentz extension (free) to run user scripts on Home Assistant. Home Assistant 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 entity data, names, or state information — all operations occur locally in your browser with no external network requests except those made by Home Assistant itself. Rename operations are applied through Home Assistant's own UI event system, so all changes respect your user permissions and entity settings. The tool does not bypass Home Assistant's security or permission system; it simply automates the clicks you would otherwise perform manually. For instances with a large number of entities, the tool may take several minutes to complete the operation, as each entity is processed sequentially with delays to avoid overwhelming the UI. A progress indicator shows which entity is currently being processed. Always double-check your selections and pattern before applying changes, as bulk renames can affect automations, scripts, and dashboard configurations. The tool only affects entities visible on the current page; to rename all entities, use Home Assistant's built-in pagination controls or adjust your view to show all relevant entities. The replace pattern uses the format "old|new" where "old" is the text to find and "new" is the replacement text (case-insensitive).