Core features - Browserbase Documentation

Contexts

Persist cookies, authentication state, and application data across sessions, so you don’t need to log in on every run.

Viewports

Configure the screen size and resolution of your browser sessions to match any device or layout requirement.

Session metadata

Tag sessions with custom key-value data to organize, filter, and query your automation runs.

Browser Extensions

Load your own Chrome extensions into sessions to augment browser behavior or bypass site-specific challenges.

Quick reference

Feature	What it does	When to use it
Contexts	Persists cookies, auth tokens, and browser storage across sessions	Any workflow that requires login: avoids re-authenticating on every run
Viewports	Sets the browser window width and height	Visual testing, screenshots, or layouts that are viewport-dependent
Session metadata	Attaches custom JSON to a session for querying later	Organizing sessions by test run, environment, team, or status
Browser extensions	Loads a Chrome extension into the session	Custom page behavior, ad blocking, or site-specific workarounds

All features are set at session creation

Every core feature is configured when you create a session. Pass your settings in the browserSettings object:

const session = await bb.sessions.create({
  browserSettings: {
    viewport: { width: 1920, height: 1080 },
    solveCaptchas: true,
  },
  context: { id: contextId, persist: true },
});

See the Create Session API reference for the full list of options.

ContextsReuse cookies, authentication, and application data across browser sessions.

⌘I