User Guide: FormStatus Chrome Extension
Table of Contents
- Introduction
- Installation
- Signing In
- Recording a Form Session
- Manually Stopping a Recording
- Understanding the Recording File
- Toolbar Badge Indicators
- Signing Out
- Changing the API Server
- Tips & Best Practices
- Troubleshooting
What is FormStatus Chrome-extension?
It records user interactions with web forms.
As you complete and submit a form, FormStatus chrome extension captures:
- Clicks and field selections
- Keystrokes and field updates
- Navigation between form pages
- Time spent interacting with fields
- Form submission actions
Once the form is submitted, FormStatus automatically generates a JSON recording file.
Installation
Step 1: Open Chrome Extensions
- Open Google Chrome.
- In the address bar, enter:
- chrome://extensions/
- Press Enter.
Step 2: Enable Developer Mode
- Locate the Developer mode toggle in the upper-right corner.
- Turn it ON.
Step 3: Load the Extension
- Click Load unpacked.
- Select the formstatus-chrome-extension folder.
- Click Open.
The FormStatus extension should now appear in your extensions list.
Step 4: Pin the Extension (Recommended)
- Click the Extensions (puzzle piece) icon in Chrome's toolbar.
- Locate FormStatus.
- Click the Pin icon.
The FormStatus icon will remain visible in your browser toolbar for quick access.
Signing In
- Click the FormStatus icon in your Chrome toolbar.
- Enter your:
- Email Address
- Password
- Click Sign In.
Successful Login
After signing in, you will see:
- Your account email address
- A green Start Recording button
Recording a Form Session
Step 1: Open the Target Form
Navigate to the webpage containing the form you want to record.
Wait until the page has fully loaded before starting.
Step 2: Start Recording
- Click the FormStatus icon.
- Click Start Recording.
Once recording starts:
- The button changes to Stop Recording
- The toolbar badge displays REC
Step 3: Complete the Form
Fill out the form normally.
FormStatus automatically records:
- Field selections
- Text input
- Field changes
- Navigation events
- Button clicks
- Time spent on fields
For Multi-Page Forms
If the form contains multiple pages or steps:
- Continue through each page as normal.
- FormStatus automatically tracks activity across all pages.
Step 4: Submit the Form
After clicking the final Submit button:
- Recording stops automatically.
- A JSON recording file is generated.
- The file is downloaded to your computer.
Example Filename
formstatus_example_com_1717400000000.json
If the Download Does Not Start
- Click the FormStatus icon.
- Click Stop Recording.
The recording file will download immediately.
Manually Stopping a Recording
If you need to stop recording before submitting:
- Click the FormStatus icon.
- Click Stop Recording.
The JSON recording file will be downloaded immediately.
Understanding the Recording File
The downloaded JSON file contains several sections.
Section | Description |
|---|---|
Recording Info | Recording ID, start time, end time, and duration |
Pages | Pages or form steps visited during the session |
Actions | Detailed list of recorded interactions |
Field Summaries | Statistics for each field interacted with |
Form Structure | Field names, labels, types, and required status |
Statistics | Totals and usage metrics collected during the session |
Toolbar Badge Indicators
The FormStatus badge indicates the extension's current status.
Badge | Meaning |
|---|---|
ON | Signed in and ready to record |
REC | Recording is currently active |
Empty | Not signed in |
Signing Out
- Click the FormStatus icon.
- Click Sign Out.
- Confirm the action when prompted.
Changing the API Server
By default, FormStatus connects to the Production environment.
Open Extension Settings
- Navigate to: chrome://extensions/
- Locate FormStatus.
- Click Details.
- Select Extension Options.
Alternatively:
- Right-click the FormStatus icon.
- Select Options.
Available Environments
Environment | URL | Purpose |
|---|---|---|
Production | Live environment | |
Staging | Pre-release testing | |
Develop | Development testing | |
Local | localhost:8080 | Local development |
Switch Servers
- Choose the desired environment from the dropdown menu.
- The change is applied immediately.
- Reopen the FormStatus popup.
- Sign in again if prompted.
Tips & Best Practices
Refresh the Page
If the extension appears unresponsive, refresh the webpage and try again.
Record One Form at a Time
Only one active recording is supported per browser tab.
Sensitive Information Protection
FormStatus does not record values from sensitive fields such as:
- Password fields
- Credit card fields
- Other protected inputs
Universal Compatibility
FormStatus can record forms on most websites accessible through Chrome.
Locate Downloaded Files
Recording files are saved to your browser's default Downloads folder.
Troubleshooting
Issue | Resolution |
|---|---|
Extension icon is missing | Open Chrome Extensions and pin FormStatus |
"Could not communicate with tab" error | Refresh the webpage and try again |
Recording will not start | Verify that you are signed in and the badge shows ON |
JSON file did not download | Click Stop Recording manually |
Unable to sign in | Verify credentials and test login on the FormStatus web application |
Badge shows REC unexpectedly | Refresh the page and stop the recording to reset the extension |
Updated on: 20/07/2026
Thank you!