> ## Documentation Index
> Fetch the complete documentation index at: https://docs.porcia.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Using the Browser Extension
> How to use the Porcia browser extension effectively
# Using the Browser Extension
Once installed, the Porcia browser extension automatically detects logins to SaaS applications in the background. This guide covers how to use the extension effectively and manage your privacy settings.
## Extension Overview
The Porcia extension appears as an icon in your browser toolbar:
Detects logins to business applications automatically
Pause detection, exclude domains, and control what's detected
View your personal usage statistics in the extension popup
See sync status and last update time
## Daily Usage
### Automatic Detection
The extension works automatically in the background:
1. **Log into a SaaS application** (e.g., slack.com, salesforce.com)
2. **Extension detects** the login event (form submission, OAuth click, or SSO redirect)
3. **Event is queued** locally for batch sync
4. **Data syncs** to Porcia every 5 minutes
5. **View insights** in your Porcia dashboard
The extension detects login events, not page visits. Consumer domains like google.com, youtube.com, and reddit.com are automatically excluded.
### Viewing Your Usage
Click the extension icon to see your usage summary:
**Today's Activity:**
* Number of applications detected today
* Total applications tracked overall
* Most recent login event
**This Week:**
* Weekly usage trends
* Top 5 applications
* Usage comparison to last week
* Total applications discovered
**Quick Actions:**
* Pause/resume tracking
* View full dashboard
* Manage settings
* Report an issue
## Extension Settings
### Accessing Settings
1. Click the Porcia extension icon
2. Click the **Settings** gear icon
3. Configure your preferences
### Tracking Control
**Pause Detection**
* Temporarily stop all login detection
* Useful for personal browsing during work hours
* Resume anytime with one click
Pause detection during personal time to ensure only work-related logins are captured.
### Domain Management
**Exclude Domains**
Add domains you never want tracked:
1. Go to Settings → Excluded Domains
2. Click **Add Domain**
3. Enter domain (e.g., `personal-project.com`)
4. Click **Save**
**Common exclusions:**
* Personal projects
* Side businesses
* Non-work related tools
* Internal company tools (if desired)
### Privacy Settings
**Incognito Mode**
* Enable/disable detection in private browsing
* Default: Disabled (respects privacy)
* Can be enabled if needed for work
### Sync Settings
**Offline Mode**
* Continue detecting when offline
* Data syncs when connection restored
* Useful for travel or unreliable connections
## Usage Scenarios
### Scenario 1: Daily Work Detection
**Goal:** Detect all work-related SaaS logins
**Setup:**
1. Install extension and sign in
2. Leave detection enabled during work hours
3. Pause during personal time if desired
4. Review detected apps in dashboard
**Result:** Accurate picture of which tools your team actually logs into
### Scenario 2: Privacy-Conscious User
**Goal:** Detect logins but maintain privacy
**Setup:**
1. Exclude personal domains
2. Disable incognito detection
3. Pause detection during personal time
**Result:** Login detection for optimization without compromising privacy
### Scenario 3: Remote Worker
**Goal:** Detect logins across multiple locations
**Setup:**
1. Enable offline mode
2. Sync when on good connection
**Result:** Consistent detection regardless of location
### Scenario 4: Team Lead
**Goal:** Understand team's tool usage
**Setup:**
1. Deploy extension to team
2. Encourage team to keep detection enabled
3. Review team analytics in dashboard
4. Identify unused licenses
**Result:** Data-driven decisions about tool purchases
## Understanding Usage Data
### What Gets Detected
**Login Event Information:**
* Domain name (e.g., "slack.com")
* Detection method (login\_form, oauth\_google, oauth\_microsoft, saml\_sso, url\_pattern)
* Whether a work email was used (boolean only)
* Timestamp of the login event
**Usage Patterns:**
* Login frequency per domain
* Time of day of login events
### What Doesn't Get Tracked
**Never Tracked:**
* ❌ Page URLs or paths
* ❌ Page content or text
* ❌ Form inputs or passwords
* ❌ Keystrokes or mouse movements
* ❌ Personal browsing
* ❌ Consumer domains (google.com, youtube.com, reddit.com, etc.)
The extension only detects login events and authentication activity. No sensitive information like passwords, form data, or page content is ever captured.
## Viewing Usage in Dashboard
### Personal Usage Dashboard
Access your usage data in Porcia:
1. Go to **Dashboard → My Usage**
2. View usage statistics:
* Total time on SaaS applications
* Applications used this week/month
* Usage trends over time
* Most used applications
### Team Usage Analytics
If you're a workspace admin:
1. Go to **Dashboard → Team Analytics**
2. View team-wide usage:
* Most used applications across team
* Underutilized applications
* Usage by team member (if not anonymous)
* License optimization opportunities
### Usage Reports
Generate usage reports:
**Personal Report:**
* Your usage over time
* Application breakdown
* Productivity insights
* Export to CSV
**Team Report:**
* Team usage summary
* Application adoption rates
* License utilization
* Cost optimization opportunities
## Troubleshooting
### Extension Not Detecting
**Check detection status:**
1. Click extension icon
2. Verify detection is not paused
3. Check if domain is excluded
4. Ensure you're signed in
**Verify login detection:**
1. Log into a SaaS application
2. Check if the login event appears in the popup
3. Report issues to support if detection isn't working
### Data Not Syncing
**Check sync status:**
1. Click extension icon
2. View last sync time
3. Check internet connection
4. Try manual sync
**Force sync:**
1. Go to Settings
2. Click **Sync Now**
3. Wait for confirmation
4. Check dashboard for updated data
### High Memory Usage
**Optimize extension:**
1. Clear local cache
2. Restart browser
### Privacy Concerns
**Review what's detected:**
1. Go to Settings → Excluded Domains
2. Review list of excluded domains
3. Exclude any unwanted domains
**Delete detected data:**
1. Go to Settings → Privacy
2. Click **Clear Local Data**
3. Confirm deletion
4. Contact support to delete server data
**Need Help?** Contact [support@porcia.org](mailto:support@porcia.org) for assistance with extension issues.
## Best Practices
### For Individual Users
1. **Review detected apps weekly** - Check which tools you're logging into
2. **Exclude personal domains** - Keep work and personal separate
3. **Report unknown domains** - Help improve Porcia's database
### For Team Admins
1. **Communicate clearly** - Explain what's detected and why
2. **Respect privacy** - Allow pausing detection
3. **Review regularly** - Check team login data monthly
4. **Act on insights** - Cancel unused licenses, consolidate tools
### For Privacy-Conscious Users
1. **Exclude sensitive domains** - Add to exclusion list
2. **Pause when needed** - Pause detection during personal time
3. **Review settings regularly** - Ensure privacy preferences are maintained
## Extension Updates
### Automatic Updates
The extension updates automatically:
* Chrome Web Store pushes updates
* Extension updates in background
* No action required from you
* Check version in Settings
### Update Notifications
You'll be notified of major updates:
* New features
* Important bug fixes
* Privacy policy changes
* Breaking changes
### Manual Update Check
Force check for updates:
1. Go to `chrome://extensions/`
2. Enable **Developer mode**
3. Click **Update extensions**
4. Wait for update to complete
## Uninstalling the Extension
### Temporary Disable
To temporarily disable without uninstalling:
1. Go to `chrome://extensions/`
2. Find Porcia extension
3. Toggle off the switch
4. Re-enable when ready
### Permanent Removal
To completely remove the extension:
1. Go to `chrome://extensions/`
2. Find Porcia extension
3. Click **Remove**
4. Confirm removal
**Before uninstalling:**
* Export your usage data if needed
* Clear local data in settings
* Contact support to delete server data (if desired)
Uninstalling the extension stops login detection but doesn't delete your historical data in Porcia. Contact support if you want to delete all usage data.
## Next Steps
Learn more about privacy and data handling
See your usage data in Porcia dashboard
Deploy extension to your team
Common questions and answers