> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.formstatus.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# User Guide: FormStatus Chrome Extension

### Table of Contents
* [Introduction](#3-what-is-formstatus-chrome-extension)
* [Installation](#3-color800000installation)
* [Signing In](#3-color800000signing-in)
* [Recording a Form Session](#3-color800000recording-a-form-session)
* [Manually Stopping a Recording](#3-color800000manually-stopping-a-recording)
* [Understanding the Recording File](#3-color800000understanding-the-recording-file)
* [Toolbar Badge Indicators](#3-color800000toolbar-badge-indicators)
* [Signing Out](#3-color800000signing-out)
* [Changing the API Server](#3-color800000changing-the-api-server)
* [Tips & Best Practices](#3-color800000tips-best-practices)
* [Troubleshooting](#3-color800000troubleshooting)
---

### ${color}[#800000](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.
---

### ${color}[#800000](Installation)

###### Step 1: Open Chrome Extensions
1. Open Google Chrome.
2. In the address bar, enter:
3. chrome://extensions/
4. Press **Enter**.

###### Step 2: Enable Developer Mode
1. Locate the **Developer mode** toggle in the upper-right corner.
2. Turn it **ON**.

###### Step 3: Load the Extension
1. Click **Load unpacked**.
2. Select the **formstatus-chrome-extension** folder.
3. Click **Open**.
The FormStatus extension should now appear in your extensions list.

###### Step 4: Pin the Extension (Recommended)
1. Click the **Extensions** (puzzle piece) icon in Chrome's toolbar.
2. Locate **FormStatus**.
3. Click the **Pin** icon.
The FormStatus icon will remain visible in your browser toolbar for quick access.
---

### ${color}[#800000](Signing In)

1. Click the **FormStatus** icon in your Chrome toolbar.
2. Enter your:
    * Email Address
    * Password
3. Click **Sign In**.
${color}[#00a35c](**Successful Login**)
After signing in, you will see:
* Your account email address
* A green **Start Recording** button
---

### ${color}[#800000](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
1. Click the FormStatus icon.
2. 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:
1. Continue through each page as normal.
2. FormStatus automatically tracks activity across all pages.

###### Step 4: Submit the Form
After clicking the final **Submit** button:
1. Recording stops automatically.
2. A JSON recording file is generated.
3. The file is downloaded to your computer.

**Example Filename**
*formstatus_example_com_1717400000000.json*

**If the Download Does Not Start**
1. Click the FormStatus icon.
2. Click **Stop Recording**.
The recording file will download immediately.
---

### ${color}[#800000](Manually Stopping a Recording)

If you need to stop recording before submitting:
1. Click the **FormStatus** icon.
2. Click Stop Recording.
The JSON recording file will be downloaded immediately.
---

### ${color}[#800000](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 |

---

### ${color}[#800000](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 |

---

### ${color}[#800000](Signing Out)
1. Click the **FormStatus** icon.
2. Click **Sign Out.**
3. Confirm the action when prompted.
---

### ${color}[#800000](Changing the API Server)
By default, FormStatus connects to the Production environment.

###### Open Extension Settings
1. Navigate to: chrome://extensions/
2. Locate **FormStatus**.
3. Click **Details**.
4. Select **Extension Options**.

Alternatively:
* Right-click the FormStatus icon.
* Select **Options**.
---

### Available Environments
| Environment | URL | Purpose |
| ---- |
| Production | app.formstatus.co | Live environment |
| Staging | stg-app.formstatus.co | Pre-release testing |
| Develop | dev-app.formstatus.co | Development testing |
| Local | localhost:8080 | Local development |
---

### Switch Servers
1. Choose the desired environment from the dropdown menu.
2. The change is applied immediately.
3. Reopen the FormStatus popup.
4. Sign in again if prompted.
---

### ${color}[#800000](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.
---

### ${color}[#800000](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 |