User-Agent Switcher by Erin Schlarb

Easily pose as another browser by changing the User-Agent header.*

Pretending to be a different browser can be useful in a number of different situations:

• Some web pages require you to log in or buy a subscription to view their content, but give full read access to search engines.
• Some web pages determine whether you're using a mobile or desktop browser based on your user-agent.
• Some web pages require you to use a specific browser to access their site.
• And potentially more…

Note that your browser will not magically morph into a different piece of software just because it's pretending to be some other software. If a web site locks you out because your browser does not support a feature they require then changing the User-Agent will not make any difference.

* Also changes navigator.userAgent, as well generating convincing values for several of the other navigator.* properties.

– Translating “User-Agent Switcher” to a new language
Any help in translating this extension is greatly appreciated! To do so, simply visit our project on the WebLate hosted instance, create an account and either select an existing language or add a new one to get going. Thanks for helping out!

(Alternatively you may submit a merge request on GitLab with the updated translation files or send me the translations using the “Support E-mail”-Address.)

– Getting Help
Found a bug or want a new feature? Please use the GitLab issue tracker to submit these instead of just mentioning them as part of your reviews. This way it becomes much easier for me to keep track of reported issues and get back to you if additional information is needed to help you.

Please note however that “User-Agent Switcher” is mostly in maintenance-only mode now and new features will not be added by me (the primary author, Alexander Schlarb) anymore. I'm still open for patches from the community however and would also welcome your support through the linked BountySource buttons under each Feature Request issue in the tracker.

– Watching it work
If you want to watch User Agent Changer work, there are a few things you could try:

• Use a web service (such as UserAgentString.com) to see your currently sent User-Agent header.
• Use the built-in Network Analyzer (Ctrl-Shift-Q) to view the User-Agent header.
• Enter navigator.userAgent into the Scripting Console (Ctrl-Shift-K) to view the client-side User-Agent value.

– Frequently Asked Questions

• Why doesn't the extension work on this very site (Mozilla/Firefox Add-ons)?
  
  To find out more about why these restrictions exist and how disable them if you must, please take a look at the following blog article: https://ninetailed.ninja/extensions-modify-mozilla-sites.html
  
  (This information was moved from this extension's description to an external source, since a Mozilla reviewer felt that suggesting changes like the one proposed in the linked article are not acceptable for the listing of sandboxed browser extension.)
• Why is the extension file so large (4 MiB) compared to others?
  
  In order to provide almost perfect emulation of User-Agent values, User Agent-Switcher bundles a stripped-down version of BrowsCap. This allows us to derive all relevant JavaScript navigator.* browser/OS identification values from just a single value: The User-Agent value you enter (and a bit of magic behind the scenes). Other extensions with a similarly complete level of emulation used to store all these values in huge tables along with the User-Agent value itself, making it very hard to add new entries.
  
  Doing this kind of emulation without using BrowsCap would be extremely hard for us, as there are only few rules regarding the structure of User-Agent strings and the most interesting part end up in the extremely browser-specific comment section of the string. As such, we consider these extra 3MiB+ of data shipped with the extension a fair price to pay for having almost perfect out-of-the-box emulation of all these values with no extra user configuration required.
  
  And yes, the BrowsCap data is here to stay and if you cannot cope with the extra size this causes please kindly download a different extension and don't down-vote. Other people appreciate this decision even if you don't.
• Can this extension be installed on Firefox for Android?
  
  Unfortunately Mozilla decided to limit support for extensions on their new Fenix browser platform to just a limited set of recommended extensions. You can read their official “rational” for this on their add-on blog: https://blog.mozilla.org/addons/2020/02/11/faq-for-extension-support-in-new-firefox-for-android/
  
  If you want to use the extension anyways and are comfortable with switching to Firefox for Android Nightly, they added a convoluted process you can follow to install any extension not official endorsed by them for their new mobile platform: https://blog.mozilla.org/addons/2020/09/29/expanded-extension-support-in-firefox-for-android-nightly/. Note that I cannot test this myself as Mozilla dropped support for my device with the switch to the new platform, but user-feedback so far has been positive.