Box Bulk Folder Permission Auditor

WHAT IT DOES

Box Bulk Folder Permission Auditor is a file security and management tool that streamlines the process of auditing permissions across multiple Box folders and files. Instead of manually navigating to each item, checking its share settings, and noting permission levels—a process that can be tedious and error-prone—this script automates the preparation phase. It scans the current Box folder or file list page, identifies visible folders and files with their current permission/share status, and presents them as a scrollable checklist. You can select individual items, use Select All/Deselect All toggles, and bulk open selected items in new tabs for detailed permission review. The script displays permission indicators (e.g., "Company Only," "Shared Link," "External") directly in the list, making it easy to identify items that need attention. Once opened, you can use Box's native Share dialog to view and modify permissions. This is ideal for security officers, IT administrators, compliance teams, and anyone who needs to regularly audit file and folder permissions across their Box organization.

WHERE IT RUNS

This script operates exclusively on Box (*.box.com/*) as a userscript injected through the BotGentz extension. It runs within the context of your current browser tab and cannot access other tabs, bookmarks, history, or downloads. The script reads the page DOM to identify folders and files using Box's selectors (.file-item, .folder-item, .row-item), extracts item names and permission/share indicators, and opens selected items in new tabs for manual review. All operations occur locally in your browser; no data is sent to external servers.

HOW TO USE

1. Navigate to any Box folder containing files and folders you want to audit.

2. Click the BotGentz extension icon and select "Box Bulk Folder Permission Auditor" from the script list.

3. The panel opens on the right side of the page. It automatically scans the current folder for items.

4. Review the displayed items, showing names, type (folder/file), and current permission status.

5. Toggle "Include subfolders" to scan nested folders (if supported by the page view).

6. Adjust "Max concurrent opens" (default 4) to control how many tabs open simultaneously.

7. Toggle "Open in background" to keep your current tab focused while audit tabs open.

8. Check the boxes next to items you wish to audit. Use "Select All" or "Deselect All" for quick selection.

9. Click "Open for Audit" to open all selected items in new tabs.

10. In each tab, click the Share button to view and modify permission settings as needed.

11. Alternatively, click "Copy Item Info" to copy a summary of selected items to your clipboard.

WHY IT WORKS WHERE OTHERS FAIL

Many Box automation tools fail because they attempt to call Box's internal API endpoints or rely on brittle DOM selectors that change with every Box UI update. This script takes a different approach: it focuses on efficiently surfacing items for manual audit rather than attempting to modify permissions programmatically. It locates the actual DOM elements Box renders—file/folder rows, permission indicators, and share buttons—and presents them in a structured checklist. By opening items in new tabs rather than attempting to read permissions directly, it leverages Box's own reliable permission display interface and allows users to perform modifications using the official UI. The script's permission detection uses flexible selectors to identify permission status (Company Only, Shared Link, External, etc.) from visible elements, giving users a quick overview before diving deeper. By combining a high-level summary with the ability to deep-dive into individual items, it provides an efficient audit workflow.

THE PANEL

The script uses BotGentz's BGPanel system, which provides a floating, draggable panel on the right side of your screen. Drag the panel by its header to reposition it anywhere on the page—the panel remembers its position per site and snaps to the nearest edge when released. Click the minimize button to collapse the panel to a small floating bubble; click the bubble to expand it back. Resize the panel vertically by dragging its bottom edge. Press the Escape key to close the panel entirely. All panel state (position, collapsed/expanded) is persisted locally using GM_setValue, so your preferences survive page reloads.

PLEASE NOTE

This userscript requires the free BotGentz browser extension—it is not a standalone application. Box periodically updates its website layout and UI components; if the script stops working, an updated version may be released. The script opens items in new tabs for manual audit; it does not modify permissions automatically. Opening many tabs simultaneously may impact browser performance; adjust the concurrent limit accordingly. This script does not store, transmit, or process any of your Box data outside your local browser. It does not access your password, hidden inputs, or file inputs. All permission audits are performed through Box's own authenticated session using the official user interface. Use responsibly and verify permission settings before making changes.