Substack Creator Dashboard Subscriber Growth Chart

WHAT IT DOES

This script scans Substack creator dashboard pages for subscriber metrics—total subscribers, new subscribers, paid subscribers, free subscribers, and growth over time—and displays a floating chart panel showing subscriber growth trends. It extracts numeric values from dashboard metrics, calculates daily/weekly/monthly growth rates, and shows a trend line chart of subscriber growth over time using sequential snapshots. The panel displays current subscriber counts (total, paid, free), period-over-period growth (green for up, red for down), and a summary of subscriber acquisition metrics including new subscribers, growth rate, total posts, and total revenue. A one-click export function saves growth data as CSV or JSON. All subscriber snapshots are stored per domain locally for tracking growth over time.

WHERE IT RUNS

Works on Substack creator dashboard pages—substack.com/dashboard, substack.com/posts, or any page displaying subscriber metrics. The script scans page content for subscriber counts, paid/free breakdowns, and growth metrics, making it compatible with Substack's dashboard layout.

HOW TO USE

The panel appears automatically when you visit your Substack dashboard. It detects subscriber metrics and displays a summary grid with total, paid, and free subscriber counts. Additional metrics show new subscribers, growth rate, total posts, and total revenue. The trend chart shows your subscriber growth over time based on saved snapshots—each visit saves a snapshot, building a history of your growth. The chart bars are color-coded: green for growth, red for decline, yellow for flat. Click "Refresh Data" to rescan for updated metrics. Export all growth data as CSV for spreadsheet analysis or as JSON for programmatic use. Use "Clear History" to reset stored snapshots for the current domain. The panel automatically saves a snapshot each time you visit, building a history of your subscriber growth trajectory.

TECHNICAL MECHANISM: MULTI-PASS SUBSCRIBER METRIC EXTRACTION WITH TREND CHART VISUALIZATION

The script uses a comprehensive detection strategy. First, it scans the page text for subscriber patterns using regex for "total subscribers," "paid subscribers," "free subscribers," "new subscribers," "growth rate," "total posts," and "total revenue." Second, it scans all tables on the page, checking each row for subscriber-related keywords and extracting numeric values from adjacent cells. Third, it scans elements with subscriber-related class names (subscriber-count, subscribers, members, stats, stat) and extracts numeric content, using parent element context to determine the metric type. Free subscribers are calculated as total minus paid when not directly available. Each snapshot stores all detected metrics with a timestamp, capped at 30 entries per domain. The trend chart displays the last 20 snapshots as a bar chart with color-coding based on whether the value increased, decreased, or stayed flat compared to the previous snapshot. The x-axis shows labels at the first, middle, and last data points. The summary grid displays current metrics in a clean card layout.

THE PANEL

The subscriber growth chart appears in a draggable, resizable panel that remembers its position per site. The panel shows a summary grid with total/paid/free counts, additional metrics, and a trend chart. Drag by the header to reposition, collapse to a compact icon with a click, and resize using the bottom-right corner. The panel snaps to screen edges for tidy placement and closes with the Escape key. All settings—panel position—persist per website using GM_setValue, so your view returns exactly as you left it.

PLEASE NOTE

This script requires the free BotGentz extension to run. Subscriber data detection relies on the page displaying metrics in a parsable format—Substack may update their dashboard layout, which could affect detection. The script does not access your Substack account credentials or modify your data—all data is read from the visible page and tracked locally. The trend chart uses snapshots saved on each page visit; visit the dashboard regularly to build a meaningful history. The growth rate is extracted if displayed on the page; if not, it may be calculated in a future update. All data is stored locally in your browser via GM_setValue and never transmitted.