Skip to main content
Every environment includes a browser profile that stores persistent Chrome data: cookies, local storage, extensions, IndexedDB, cached credentials. When you attach an environment to a session, the browser starts with that saved state already loaded. Without a profile: every session opens a blank browser. You log in each time, re-accept cookie banners, and lose any site-specific data. With a profile: sessions pick up where you left off. Login cookies persist, preferences carry over, and previously saved data is available immediately.

​
Use Cases

​
Skip Repeated Logins

Log in once, then reuse that session state across future tasks:
  1. Create an environment and run a session with it attached
  2. Log in to the target site during the session
  3. The profile saves your login cookies automatically when the session ends
  4. Future sessions on the same environment start already authenticated

​
Preserve Site Preferences

Cookie consent choices, language settings, dark mode preferences, and other site-specific configuration carry over between sessions without any extra setup.

​
Maintain Application State

For e-commerce or SaaS workflows, keep cart contents, workspace configurations, or application state intact between sessions.

​
Profile Status

Each environment tracks the state of its browser profile:
You can attach an environment with status empty to a session. The session starts with a clean browser, and the profile is populated automatically when the session ends.

​
Populating a Profile

There are three ways to get browser data into an environment’s profile:

​
Using a Profile in a Session

Pass environmentId when starting a session or task. The browser loads the profile’s saved data before executing anything:
After the session ends, any changes to the browser state (new cookies, updated local storage) are saved back to the profile automatically.

​
Sync from Local Chrome

The sync command packages your local Chrome browser data and uploads it directly to an environment. This is the fastest way to populate a profile if you’re already logged into sites locally.

​
Sync to an Existing Environment

If you’ve already created an environment, sync your local browser data to it:
This replaces any existing profile data in the environment. The status changes to ready once the upload completes.

​
Create and Sync in One Step

To create a new environment and upload your local data in a single command, omit --environmentId:
This creates a new environment, uploads your Chrome profile, and returns the new environment ID.
Save the environment ID returned by the command. You’ll need it to pass as environmentId when starting sessions.

​
Limits

Environments Overview

What environments are and when to use them

Environments API

Create environments and upload profile data via the API