Table of Contents
Notifications
When notifications are enabled, your OS will display a notification with the user agent of the current spoofed profile. Depending on how often you change your profile, this can be a lot of notifications!
Profiles
By selecting a specific browser (ex Firefox 60 Win 10), your browser will only use that user agent. Script injection must be enabled if you want to fully spoof your browser profile.
Browser profile without script injection:
- Headers User Agent: Firefox 60 Android
- Javascript detection: your real browser, Your real screen resolution
Browser profile with script injection:
- Headers User Agent: Firefox 60 Android
- Javascript detection: Firefox 60 Android, a mobile device screen resolution
- Depending on the site, script injection may not be spoof the browser profile in time. To learn more read these issues.
Custom user agent
You can use a custom user agent for your browser profile. Certain values may not be spoofed if you use an uncommon platform.
Exclusions
If a certain profile causes issues for you, you can exclude it from being used. If there are no profiles that can be used (you excluded everything!), your browser profile will not be spoofed.
Random Profiles
You can choose to use your real browser profile or a random browser profile (by device, OS, or any).
When using a random browser profile, you can choose the interval (if you want to use one) of how often to change your profile.
For example, if you want to use Random Profile (Desktop), your browser profile will use a Windows, macOS, or Linux browser and the screen resolution will be a desktop resolution.
Script Injection
When script injection is enabled and you are using a profile, several navigator properties are automatically spoofed:
- userAgent
- platform
- productSub
- hardwareConcurrency
- oscpu
- vendor
- vendorSub
- appVersion
- buildID
If you spoof the accept headers, the spoofed values will also match the selected browser profile.
Custom User Agent
Chameleon tries to identify the platform from the user agent of the profile. If you use a custom user agent of a major browser on a major platform, it should be able to correctly spoof the above values. If Chameleon can't identify the platform, the values will not be spoofed.

