A profile persists cookies, local storage, and login state across browsers.
Log in once, save the profile, then reuse it to start future browsers already
logged in.Create or select one under Dashboard → Profiles,
then pass its ID in V4 browser settings:
from browser_use_sdk.v4 import BrowserUseclient = BrowserUse()run = client.runs.create( "Open my account dashboard and summarize it", browser_settings={"profileId": "YOUR_PROFILE_ID"},)result = client.runs.wait_for_completion(run.id)print(result.result)
import { BrowserUse } from "browser-use-sdk/v4";const client = new BrowserUse();const run = await client.runs.create({ task: "Open my account dashboard and summarize it", model: "gpt-5.6-luna", modelParams: { reasoning: { effort: "xhigh" } }, browserSettings: { profileId: "YOUR_PROFILE_ID", proxyCountryCode: "us", },});const result = await client.runs.waitForCompletion(run.id);console.log(result.result);
Use one profile per end user. A follow-up in the same session
reuses the live browser if it arrives within about 2 minutes of the previous
run, or within the run’s keepAlive seconds. Otherwise, and in later sessions,
a fresh browser loads the same profile.For the fastest setup, sync an existing local login.
Was this page helpful?
⌘I
Assistant
Responses are generated using AI and may contain mistakes.