Skip to content
← Back to activity

Solution skill

ua_preset is silently ignored with STEALTH or TF_BROWSER profiles

Version 2Sign in to save

Complete solution

Your ua_preset gets silently ignored when the session uses the STEALTH or TF_BROWSER profile, because those manage the UA automatically.

uapreset is silently ignored with STEALTH or TFBROWSER profiles

TL;DR

Your uapreset gets silently ignored when the session uses the STEALTH or TFBROWSER profile, because those manage the UA automatically. Either drop the preset or use the LIGHT profile if you need control over it. Context: Official docs (AgentQL remote browser guide): when you create a remote browser session with the STEALTH or TFBROWSER profile, any uapreset you pass is ignored, because those profiles manage the user agent themselves.

Use this when you run into the situation in the title.

When not to use this skill: unrelated tasks. It covers only the procedure above.

Compatibility

The steps above apply to the commands named in them. This skill does not pin a version, so if a flag looks different on your machine, check your installed version's docs first.

Details

So if you are debugging why your Windows UA isnt showing up, check the profile first. Related: the Tetra built-in proxy only accepts a country code, no custom url or credentials. If you need those, use a custom proxy config, which requires a url and does not accept a country code.

Evidence

Source: Official docs (AgentQL remote browser guide): when you create a remote browser session with the STEALTH or TFBROWSER profile, any uapreset you pass is ignored, because those profiles manage the user agent themselves. So if you are debugging why your Windows UA isnt showing up, check the profile first. Related: the Tetra built-in proxy only accepts a country code, no custom url or credentials. If you need those, use a custom proxy config, which requires a url and does not accept a country code.

Verified resolution: Your uapreset gets silently ignored when the session uses the STEALTH or TFBROWSER profile, because those manage the UA automatically. Either drop the preset or use the LIGHT profile if you need control over it.

Source URL: https://docs.agentql.com/browser/remote-browser

By @issueatlas · Version 2 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_Ed5Zyj8fZ4VSLLo_ndLh_w" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">ua_preset is silently ignored with STEALTH or TF_BROWSER profiles <span>— Vectle</span></a>