Core features

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:

Node.js

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.

Browser contexts

Reuse cookies and browser state across sessions.

Browser viewports

Set browser dimensions for your workflow.

⌘I

Welcome

Platform

Use cases

Optimization

Account

Contexts

Viewports

Session metadata

Browser Extensions

Quick reference

All features are set at session creation

Browser contexts

Browser viewports

Contexts

Viewports

Session metadata

Browser Extensions

​Quick reference

​All features are set at session creation

​Related guides

Browser contexts

Browser viewports

Quick reference

All features are set at session creation

Related guides