Universal Table Column Freeze

WHAT IT DOES

Universal Table Column Freeze allows you to freeze any column in an HTML table so it remains visible while scrolling horizontally. Click any column header to "pin" that column—it becomes sticky and stays in place as you scroll right through the table. A small pin icon appears next to the frozen column header, clearly indicating its frozen state. You can freeze multiple columns simultaneously, making it easy to keep several key data points visible while exploring the rest of the table. Click the pin icon again to unfreeze the column. A floating control panel shows the number of frozen columns and provides a quick way to reset all frozen columns.

WHERE IT RUNS

This script operates as a userscript within the BotGentz extension on any webpage that contains HTML tables, including data dashboards, spreadsheets, project management tools, comparison charts, and financial reports. It functions on any modern browser that supports the BotGentz extension, including Chrome, Firefox, Edge, Safari, and Opera. The script runs entirely client-side, modifying table styles locally without sending any data to external servers.

HOW TO USE

After installation, the script automatically detects tables on the page and adds pin icons to each column header. Click the 📌 icon on any column header to freeze that column—the column becomes sticky and a colored indicator highlights it. Click the pin icon again to unfreeze the column. The floating control panel in the bottom-left corner shows the number of frozen columns and includes a "Reset All" button to unfreeze everything at once. To adjust the maximum number of columns you can freeze, open the main panel and select your preferred limit (1-10 columns). Use the "Refresh Tables" button if new tables are added to the page dynamically.

THE MECHANISM THAT MAKES IT WORK

The script uses CSS position: sticky with computed left offsets to achieve the freezing effect. When a column is frozen, the script calculates the cumulative width of all previously frozen columns to position each one at the correct offset. For each row, the script identifies cells in frozen columns and applies position: sticky along with the computed left value. The script also manages z-index layering to ensure frozen columns appear above non-frozen content. Frozen column data is persisted per URL using GM_setValue, so your preferences are remembered across page visits. When a table structure changes dynamically, the script automatically detects and re-applies freeze settings. The pin icons are injected as interactive elements that toggle the freeze state using event listeners, with visual feedback including color changes and highlighting.

THE PANEL

The script panel is built using BotGentz's BGPanel framework and provides comprehensive control over the column freeze behavior. The panel opens as a floating overlay that can be dragged anywhere on your screen, with a clean dark theme matching the tool's aesthetic. It includes a dropdown menu for setting the maximum number of frozen columns (1-10), toggle switches for enabling the freeze feature, showing pin icons, and highlighting frozen columns. Action buttons allow you to refresh tables, unfreeze all columns, or reset all settings to defaults. The panel collapses to a small icon when not in use and expands when clicked, remaining accessible but unobtrusive. Press the Escape key at any time to close the panel.

PLEASE NOTE

This script requires the free BotGentz extension to be installed and activated in your browser. The extension is available from the official BotGentz website. The freeze feature works on standard HTML tables with proper structure—tables without thead or th elements may not be fully supported. Tables with complex colspan or rowspan may have inconsistent behavior when freezing columns. Frozen column data is stored per URL using GM_setValue; clearing your browser's local storage or GM storage will reset your frozen columns. The script modifies table styling using CSS position: sticky, which may interact with other styles on the page. If a table's content changes dynamically, you may need to click "Refresh Tables" to re-apply freeze settings. No data is collected, stored, or transmitted by this script; all processing is performed locally in your browser.