Why Browser Profiles matter
Most sites worth automating are behind a login. Without persistent sessions, each run would need to re-authenticate from scratch — burning credits on the auth flow, risking bot detection from rapid repeated logins, and failing entirely on sites that enforce rate limits or MFA prompts on every new session. Browser Profiles solve this by replaying a real, lived-in browser session. The site sees a session that has existed for days or weeks, with the cookies and history of a genuine user. Common use cases:- LinkedIn — Scrape profiles, job listings, or company data from your logged-in account
- Internal portals — Extract invoices, reports, or status updates from portals without a public API
- Admin dashboards — Automate back-office tasks on SaaS tools that require a logged-in user
- E-commerce seller panels — Monitor inventory, pull order data, or update listings from seller dashboards
- Paywalled research sites — Access content your organisation is subscribed to
Security
Your browser session data is encrypted at rest and in transit. Credentials and session cookies stored inside a Profile are never exposed to the AI during Skill execution.How to create a Browser Profile
1
Open Browser Profiles
In the Valendata sidebar, click Browser Profiles, then click Create.
2
Name your Profile
Give the Profile a descriptive name that identifies the site and account — for example, LinkedIn — Growth Team or Acme Admin Portal. Click Set up login now to immediately attach a login session, or Create empty for now if you want to add the login later.
3
Add your login
There are two ways to load your login into the Profile — choose whichever fits your setup:Option A — Terminal command (recommended)A terminal command is generated for you. Choose a capture mode:
Copy the command, paste it into Terminal, and follow the on-screen prompt. Your password is never seen — only the resulting session cookies are captured.Option B — Live browser sessionClick Set up authentication on the Profile card. A live Chromium browser opens inside the dashboard. Navigate to the site, complete the full login flow including any 2FA prompts, then click Done — save session. Valendata snapshots the authenticated state and stores it in your Profile.
Every Workspace comes with a Default Profile. All remote-browser runs use it automatically unless you attach a different Profile to a specific Skill. To keep things clean, set up your Default Profile’s login before running Skills that require authentication.
How to attach a Profile to a Skill
1
Open the Skill
Navigate to Skills and click the Skill you want to authenticate.
2
Find the Browser Profile selector
In the Workspace tab, look for the Browser Profile section in the right-hand settings panel.
3
Select a Profile
Open the dropdown and select the saved Profile you want to attach. The change saves automatically. All future runs — manual, scheduled, or API-triggered — will start from that authenticated session.
You can also attach a Browser Profile to individual steps inside a Workflow, so different steps can run under different authenticated accounts.
Keeping sessions fresh
Browser sessions naturally expire over time — most sites rotate session tokens after a period of inactivity or on a fixed schedule. When a Profile’s session expires, runs will start failing with login-page errors. To re-authenticate an expired Profile, go to Browser Profiles, find the expired Profile, and click Update authentication. This reopens the live browser session so you can log in again. Click Done — save session when finished. All Skills attached to this Profile will use the refreshed session on their next run.Exit IP and proxy
Each Profile has a configurable exit IP — the network identity that sites see when your runs execute. You can assign a country-specific proxy to a Profile from the Profile card. The exit IP should match the country where the Profile’s logins were originally created; a mismatch can cause sites to invalidate the session.Profile scoping
Browser Profiles are scoped to the Workspace where they are created. A Profile created in yourClient A Workspace is not visible to Skills in your Client B Workspace. This keeps credential boundaries clean across projects and teams.