Miro Board Element Count Badge

WHAT IT DOES

Miro Board Element Count Badge provides real-time visibility into your Miro board's composition by displaying a compact count badge showing the total number of elements on the board, along with a detailed breakdown by type. The script automatically scans the board and counts stickies, shapes, text elements, cards, frames, widgets, images, and connectors, then presents this information in an easily accessible badge positioned on your board. A density indicator shows how packed your board is—low, medium, high, or very high—helping you assess board complexity at a glance. The badge updates in real-time as you add or remove elements, and you can export board statistics with a single click.

WHERE IT RUNS

This script operates on all Miro board pages, including individual board views, dashboard previews, and shared board links. It works within Miro's single-page application architecture, automatically detecting changes to the board and updating element counts accordingly without requiring manual refreshes.

HOW TO USE

After installing through the BotGentz extension, simply open any Miro board. The count badge appears automatically—by default positioned in the bottom-right corner or integrated into the toolbar. Hover over the badge to see additional details, or click it to toggle between compact and expanded views. The configuration panel lets you customize which elements appear in the badge, toggle density indicators, choose between compact or expanded mode, and control the auto-refresh interval. Use the "Scan Board Now" button to manually trigger a count update, or export board statistics to your clipboard for reporting or analysis.

DOM TRAVERSAL WITH SMART ELEMENT CLASSIFICATION

This script implements a sophisticated DOM traversal engine that identifies and classifies Miro board elements using multiple detection strategies. The engine first attempts to locate elements by their data attributes, which Miro uses to identify widget types internally. When data attributes are unavailable or inconsistent, the engine falls back to class name analysis, inspecting CSS classes that Miro applies to different element types. Finally, the engine examines SVG path geometry to distinguish between shapes, connectors, and other vector elements. This multi-layered classification ensures accurate counts across different Miro board versions and UI updates. The engine also tracks board dimensions to calculate density scores, providing meaningful context for large, complex boards.

THE PANEL

The configuration panel is fully draggable and remembers its position per-site using GM_setValue. It snaps to screen edges when dragged near them, collapses to a compact bubble when minimized, and supports Escape key for quick collapse. All settings—including badge visibility, type breakdown preferences, density indicators, auto-refresh interval, and compact mode—are persisted across sessions.

PLEASE NOTE

This script requires the free BotGentz extension to run. Miro periodically updates their page structures, which may affect the script's ability to detect elements—we actively maintain the script and release updates to ensure compatibility. The script reads only publicly visible board element data and does not access private content, user information, or sensitive data. All board statistics stay local in your browser and are never transmitted to external servers. This tool is designed to help you understand board composition and is not affiliated with or endorsed by Miro.