Retool Web App Usage Analytics Overlay

WHAT IT DOES

Retool Web App Usage Analytics Overlay automatically scans Retool app editor and dashboard pages to extract comprehensive usage analytics data including app view counts, user sessions, average session duration, and active users. The tool displays a floating overlay panel showing a summary of app usage metrics with color-coded indicators—total views in white, unique users in blue, and active users in green. Summary statistics show app name and last updated time. Session metrics display total sessions and average session duration with color-coded values. Usage trend is shown with an icon and color-coded indicator (green for Increasing, red for Decreasing, yellow for Stable). Quick stats calculate engagement rate and average views per user. This provides a complete, organized view of your Retool app usage analytics.

WHERE IT RUNS

This extension operates exclusively on retool.com domain pages that contain app editor and dashboard content—specifically pages with "/apps", "/dashboard", "/editor", or "/analytics" in the URL path, or pages that display usage analytics and app performance data. It works alongside the free BotGentz companion extension, which provides the necessary DOM access and page interaction capabilities. The usage analytics overlay runs entirely within your local browser instance and does not communicate with any external servers or APIs. All analytics data extraction, metric calculation, and preference storage are processed and stored on your machine, ensuring your app data and tracking preferences remain private. It supports all modern Chromium-based browsers (Chrome, Edge, Brave, Opera) and Firefox when paired with the BotGentz bridge.

HOW TO USE

After installing both BotGentz and this analytics overlay, navigate to any Retool app editor or dashboard page. Within 1-2 seconds, a panel appears in the bottom-right corner displaying the app name and last updated time. The "Usage Overview" section shows total views, unique users, and active users with color-coded values. The "Sessions" section displays total sessions and average session duration. The "Trend" section shows the usage trend with an icon and color-coded indicator. Quick stats display engagement rate and average views per user. The panel provides a complete, organized view of your app usage analytics.

USAGE ANALYTICS DATA EXTRACTION AND METRIC CALCULATION

The usage analytics overlay uses a multi-strategy extraction system to locate and parse analytics data from Retool pages. It first attempts to find structured analytics elements using selectors based on the site's typical class naming patterns, including app name containers, view count displays, and user metrics. When these selectors fail due to site updates, the tool falls back to text-based parsing, scanning the page for analytics-related patterns using pattern matching for view counts, user counts, session metrics, and duration formats. Total views are extracted through pattern matching for "total views" or "views" labels with numeric values. Unique users are extracted through pattern matching for "unique users" labels with numeric values. Active users are extracted through pattern matching for "active users" labels with numeric values. Average session duration is extracted through pattern matching for duration formats (MM:SS or HH:MM:SS). Total sessions are extracted through pattern matching for "sessions" labels with numeric values. Usage trend is determined through keyword detection for "Increasing," "Decreasing," or "Stable." Engagement rate is calculated as (active users / unique users) × 100. Average views per user is calculated as (total views / unique users). All data is presented in a clean, organized panel with color-coded indicators.

THE PANEL

The usage analytics overlay panel is a compact, functional overlay that integrates into the Retool app page. It can be dragged by clicking and holding the title bar, positioning the panel anywhere on the screen for optimal visibility while you monitor app performance. The panel includes a built-in snap feature that automatically aligns to the nearest screen edge when released within 48 pixels, keeping your workspace organized. Click the collapse arrow in the top-right corner to minimize the panel to a small icon bubble showing a gear emoji, preserving screen space while keeping the tool accessible. The panel is not resizable in this version, maintaining a consistent compact size that works on all screen resolutions. Press the Escape key to instantly hide the panel; press Escape again to restore it. All position, collapse state, and analytics tracking preferences are saved locally using GM_setValue and persist across browsing sessions.

PLEASE NOTE

This extension requires the free BotGentz extension to function—the usage analytics overlay does not work standalone. Retool occasionally updates its page layouts and analytics presentation formats, which may temporarily affect analytics data extraction accuracy. The tool extracts analytics data from the visible page content; if analytics information is loaded dynamically after page load, you may need to wait a moment or refresh the page for the panel to populate. Engagement rate and average views per user are calculated from extracted data and are provided as reference metrics. The tool does not store or transmit any data; all analytics data extraction, metric calculation, and settings are processed and saved entirely within your browser. This tool is designed for personal app performance monitoring and is not affiliated with or endorsed by Retool or its parent company. Analytics data is subject to Retool's terms; always review your official Retool account for authoritative app usage information.