Support & Documentation

Guides, troubleshooting, FAQs, and tips for Upwork Skills Tracker & Auto-Refresher.

πŸš€ Getting Started

How do I install the extension?
Install directly from the Chrome Web Store by clicking "Add to Chrome". If installing in Developer Mode for testing, go to chrome://extensions/, enable "Developer mode", click "Load unpacked", and select the extension folder.
How do I start tracking Upwork jobs?
Simply open any Upwork job search page (for example: https://www.upwork.com/nx/search/jobs?jobs_feed=all-jobs&proposals=0-4&sort=recency). The on-page floating HUD will appear automatically in the bottom-right corner and begin tracking.

⏱️ Refresh Interval & Anti-Detection Jitter

How does the "Fixed Base + Random Element" interval work?
To avoid mechanical, predictable refresh timings, the next refresh delay is computed as:
Next Refresh = Fixed Base (e.g. 15s) + Random Element (0 to 35s) = 15 to 50 seconds
You can adjust both values in the extension toolbar popup at any time.
Can I pause the auto-refresher?
Yes! Click the ⏸️ Pause button on the floating HUD or toggle the switch in the toolbar popup. The page will not reload until you click ▢️ Resume.

🌐 Custom Upwork Search URLs

Can I track specific skills or categories (e.g. Python, AI, Translation)?
Yes! Open the toolbar popup and paste your custom filtered Upwork search link into the "Target Upwork Query URL" box. You can also click "🎯 Use Current Tab" to immediately capture whatever Upwork search query you currently have open in Chrome.

πŸ”§ Troubleshooting Common Issues

What causes "Extension context invalidated" in the console?
This message occurs when Chrome updates or reloads an extension in the background while an Upwork tab is already open. The extension automatically detects this and halts background timers. Simply refresh your Upwork tab (F5 or Cmd + R) to re-attach the extension.
Why did I see "+2", "+14", or "+4" on my histogram earlier?
Upwork renders "+N more" expander buttons using the same badge style as genuine skills. The scraper has built-in filters to reject expander tokens, and the dashboard automatically purges any older "+N" entries from your database upon load.
Why are navigation buttons like "Skip skills" or "Previous skills" filtered out?
Upwork includes hidden accessibility carousel buttons inside skill token groups. The extension automatically excludes screen-reader control tags so only genuine technical skills appear on your charts.

πŸ“ Data Storage, Date Files & Exports

Where is my project data stored?
All data is stored 100% locally on your computer inside Chrome's secure chrome.storage.local database. No data is ever transmitted to remote servers.
How do daily files work?
All scraping sessions on a given date are grouped into a daily file: upwork_skills_YYYY-MM-DD.json. When midnight passes, the extension automatically archives the previous day and begins a new daily file.
How can I export my data to Excel or Google Sheets?
Open the Histogram Dashboard and click πŸ“₯ Export CSV. This downloads a complete spreadsheet containing the Skill Frequency Table and the chronological Project Log.

Need More Help or Have a Feature Request?

Have an idea to make Upwork Skills Tracker even better, or spotted an issue on a new Upwork page layout? We'd love to hear from you.

πŸ’¬ Open an Issue / Feedback on GitHub

Support the Project

Upwork Skills Tracker is free, open, and privacy-first. If you find this tool helpful for your freelancing or agency business, consider buying a coffee to support maintenance and updates!

β˜• Buy me a coffee at buymeacoffee.com/bilalahsan