> ## Documentation Index
> Fetch the complete documentation index at: https://docs.browser-use.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Profiles

> Reuse cookies and browser state in API V4 runs.

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.

<img src="https://mintcdn.com/browseruse-0aece648/BCDzEtKfFmujvTtJ/cloud/images/browser-profile-light.svg?fit=max&auto=format&n=BCDzEtKfFmujvTtJ&q=85&s=157da6b254fdcccc0104dc2bf066268d" alt="One login saved as a profile and reused by multiple future browsers" noZoom className="block dark:hidden" width="1200" height="400" data-path="cloud/images/browser-profile-light.svg" />

<img src="https://mintcdn.com/browseruse-0aece648/BCDzEtKfFmujvTtJ/cloud/images/browser-profile-dark.svg?fit=max&auto=format&n=BCDzEtKfFmujvTtJ&q=85&s=a0e43cd2950a4a749949426bf05a18f9" alt="One login saved as a profile and reused by multiple future browsers" noZoom className="hidden dark:block" width="1200" height="400" data-path="cloud/images/browser-profile-dark.svg" />

Create or select one under [Dashboard → Profiles](https://cloud.browser-use.com/settings?tab=profiles),
then pass its ID in V4 browser settings:

<CodeGroup>
  ```python Python theme={null}
  from browser_use_sdk.v4 import BrowserUse

  client = 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)
  ```

  ```typescript TypeScript theme={null}
  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: "grok-4.5",
    browserSettings: {
      profileId: "YOUR_PROFILE_ID",
      proxyCountryCode: "us",
    },
  });
  const result = await client.runs.waitForCompletion(run.id);
  console.log(result.result);
  ```

  ```bash curl theme={null}
  curl https://api.browser-use.com/api/v4/runs \
    -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"task":"Summarize my account dashboard",
         "browserSettings":{"profileId":"YOUR_PROFILE_ID"}}'
  ```
</CodeGroup>

Use one profile per end user. Follow-ups in the same [session](/cloud/agent/sessions)
reuse the live browser; later sessions can load the same profile again.

For the fastest setup, [sync an existing local login](/cloud/guides/profile-sync).
