Skip to main content

User Data Directory

Persist browser data between sessions.

Local Sessions

For local sessions, use the userDataDir option:
import { Stagehand } from "@browserbasehq/stagehand";

const stagehand = new Stagehand({
  env: "LOCAL",
  localBrowserLaunchOptions: {
    userDataDir: "./browser-data",
  },
});

await stagehand.init();

Browserbase Sessions

For Browserbase sessions, use contexts to persist browser data:
import { Stagehand } from "@browserbasehq/stagehand";

const stagehand = new Stagehand({
  env: "BROWSERBASE",
  browserbaseSessionCreateParams: {
    browserSettings: {
      context: {
        id: "my-context-id",
        persist: true,
      },
    },
  },
});

await stagehand.init();
console.log("Session ID:", stagehand.sessionId);