TrackForcePro - Quick Start Guide

1 Installation

Option 1: Install from Chrome Web Store (Recommended)

Easiest Method! Install directly from the official Chrome Web Store with one click:

🛒 Add to Chrome - It's Free

Option 2: Manual Installation (Developer Mode)

For developers or if you want to use the latest development version:

Download the Extension

Download the TrackForcePro extension package (.zip file) from the official source.

Extract the Files

Right-click the downloaded .zip file and select "Extract All" (Windows) or double-click to extract (Mac).

Open Chrome Extensions Page

Open Google Chrome and navigate to chrome://extensions/

Screenshot: Chrome Extensions Page

Shows the chrome://extensions/ page with extension cards

Enable Developer Mode

Toggle the "Developer mode" switch in the top-right corner of the extensions page.

Screenshot: Developer Mode Toggle

Shows the Developer mode toggle switch enabled (blue)

Load the Extension

Click "Load unpacked" button, navigate to the extracted TrackForcePro folder, and select it.

Pin the Extension

Click the puzzle piece icon (🧩) in Chrome's toolbar and pin TrackForcePro for easy access.

Screenshot: Extension Installed

Shows TrackForcePro in the extensions list with icon visible in toolbar

After installation, you'll see the TrackForcePro icon in your Chrome toolbar. If you don't see it, click the puzzle piece icon and pin it!

2 First Launch

Click the TrackForcePro icon in your Chrome toolbar to open the extension popup.

Screenshot: TrackForcePro Main Interface

Shows the main popup window with tab navigation (Audit, GraphQL, SOQL, Data, Platform, Settings)

Interface Overview

📑 Tab Navigation

Switch between tools: Audit Trails, GraphQL Builder, SOQL Builder, Data Explorer, Platform Events, Settings

🔌 Connection Status

Shows whether you're connected to a Salesforce org (green = connected, red = not connected)

📊 API Version

Select your preferred Salesforce API version from the dropdown

⧉ Pop Button

Open TrackForcePro as a tab (click) or window (Shift+click)

3 Connecting to Salesforce

TrackForcePro automatically detects your Salesforce session from open browser tabs.

Open Salesforce

Open a new browser tab and navigate to your Salesforce org. Log in if needed.

Keep the Tab Open

Keep the Salesforce tab open in your browser (don't close it).

Open TrackForcePro

Click the TrackForcePro icon. The extension will automatically detect your session.

Connection Status Indicators

Indicator	Status	What to Do
🟢 Green	Connected	You're ready to use all features!
🔴 Red / "Not Connected"	Disconnected	Open a Salesforce tab and log in

Screenshot: Connected State

Shows the extension with green "Connected" status and org name displayed

The extension requires an active Salesforce tab with a valid login session. If you see "Not Connected," ensure you're logged into Salesforce in another tab.

4 Features Overview

🔍 Audit Trail Extractor

Extract and export Salesforce Setup Audit Trail logs for compliance and analysis.

Screenshot: Audit Trail Tab

Shows the audit trail interface with search, filters, and export buttons

🔗 GraphQL Query Builder

Build and execute GraphQL queries against Salesforce's UI API with a visual interface.

Screenshot: GraphQL Builder

Shows object selection grid, field checkboxes, query preview, and results panel

📊 SOQL Query Builder

Build and run SOQL queries with field selection, filters, and ordering.

Screenshot: SOQL Builder

Shows object dropdown, field selection, filter builder, and query output

💾 Data Explorer

Three powerful sub-tools for data exploration and org management.

🎨 Sandbox & Favicon Manager

Customize browser tab icons to visually identify different orgs

👤 User Manager

View current user, search users, update profiles/roles

🔍 Record Lookup

Auto-detect, search by ID, and view recent record history

Screenshot: Data Explorer - Favicon Manager

Shows org info panel, color picker, label input, and saved favicons list

📡 Platform Events & 📢 LMS

Monitor and publish Platform Events and Lightning Message Service channels.

Screenshot: Platform Events Monitor

Shows event subscription panel, real-time event log, and publish form

5 Tab & Window Modes

TrackForcePro offers flexible ways to open for more screen space.

🗂️ Open as Browser Tab (Single Click)

Click the pop button ⧉ in the header to open TrackForcePro as a new browser tab.

Screenshot: TrackForcePro in Browser Tab

Shows extension running as a full browser tab with tab bar visible

🪟 Open as Standalone Window (Shift+Click)

Hold Shift and click the pop button to open in a separate window.

Screenshot: TrackForcePro Standalone Window

Shows extension in a separate popup window with org name in title bar

Quick Reference

Current Mode	Action	Result
Popup	Click pop button	Opens as browser tab
Popup	`Shift` + Click pop button	Opens as standalone window
Tab	Click pop button	Closes the tab
Window	Click pop button	Opens as tab, closes window

Your session and query state are automatically transferred when switching between modes!

6 Keyboard Shortcuts

General

Action	Windows/Linux	Mac
Copy	`Ctrl` + `C`	`Cmd` + `C`
Paste	`Ctrl` + `V`	`Cmd` + `V`
Select All	`Ctrl` + `A`	`Cmd` + `A`

Window & Tab Actions

Action	Shortcut
Pop-out Window	Click pop button

Query Editors

Action	Key
Execute Search	`Enter`
Move to Next Field	`Tab`
Move to Previous Field	`Shift` + `Tab`

7 Troubleshooting

Common Issues

❌ "Not Connected" Error

Screenshot: Not Connected State

Shows red status indicator

Solutions:

Open a new tab and log into Salesforce
Make sure the Salesforce tab stays open
Refresh the Salesforce page
Close and reopen the extension

❌ Objects Not Loading

Solutions:

Check your internet connection
Verify you're logged into Salesforce
Click "Refresh Objects" button
Check the browser console for errors (F12 → Console)

❌ Favicon Not Appearing

Solutions:

Refresh the Salesforce page after applying
Try closing and reopening the Salesforce tab
Verify the favicon was saved (check Saved Favicons list)

Error Messages

Error	Meaning	Solution
"No access token"	Session expired	Log into Salesforce again
"Invalid ID length"	Wrong ID format	Use 15 or 18 character ID
"Handshake failed"	Streaming connection issue	Refresh and reconnect

✅ Quick Start Checklist

☐ Downloaded and extracted TrackForcePro

☐ Enabled Developer Mode in Chrome

☐ Loaded the extension using "Load unpacked"

☐ Pinned TrackForcePro to toolbar

☐ Logged into Salesforce in a browser tab

☐ Opened TrackForcePro and verified "Connected" status

☐ Tried opening as a tab (single click on pop button)

☐ Explored the main features!