> ## Documentation Index
> Fetch the complete documentation index at: https://docs.browsepilot.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Browser Profiles

> Create, manage, and customize browser profiles with remote browser connections for seamless automation across different accounts and contexts

## What are Browser Profiles?

Browser profiles in Browsepilot work just like Chrome profiles - they maintain separate sessions, cookies, login states, and settings. Each profile acts as an isolated browser identity that you can use across multiple conversations and automation tasks.

## Creating a New Profile

<Steps>
  <Step title="Start Profile Creation">
    1. Go to your Browsepilot dashboard
    2. Click the **Manage** button
    3. Select **New Profile**
  </Step>

  <Step title="Connect to Remote Browser">
    1. Click **Connect to Remote Browser** 2. A new remote browser window will
       open in your dashboard 3. This browser is completely isolated and ready for
       setup
  </Step>

  <Step title="Set Up Your Profile">
    1. **Sign into accounts**: Navigate to sites like notion.com, LinkedIn, Gmail,
       etc. 2. **Configure settings**: Adjust any browser preferences you need 3.
       **Test functionality**: Make sure everything works as expected

    <Tip>
      **Pro tip**: Sign into all the accounts you'll need for automation tasks.
      The profile will remember all login states and cookies.
    </Tip>
  </Step>

  <Step title="Save Your Profile">
    1. Give your profile a **descriptive name** (e.g., "Work Notion", "Personal LinkedIn", "E-commerce Testing")
    2. Add a **description** of what this profile is for
    3. Click **Save Profile**
  </Step>
</Steps>

## Using Profiles in Conversations

Once saved, your profile is ready to use across any automation task:

```
"Using my Work Notion profile, create a new page titled 'Q1 Planning' and add today's meeting notes"
```

```
"Switch to my E-commerce Testing profile and check out with the items in my Amazon cart"
```

The AI agent will automatically use the saved login states, cookies, and settings from your specified profile.

## Editing Existing Profiles

Need to update a profile? No problem:

<Steps>
  <Step title="Select Profile to Edit">
    1. Go to **Manage** → **Profiles**
    2. Find the profile you want to modify
    3. Click **Edit Profile**
  </Step>

  <Step title="Connect to Associated Remote Browser">
    1. Click **Connect to Remote Browser** 2. The browser will open with all your
       existing profile settings 3. You'll see all your saved logins and
       configurations
  </Step>

  <Step title="Make Changes">
    * **Add new accounts**: Sign into additional services - **Update
      credentials**: Change passwords or login to different accounts - **Modify
      settings**: Adjust browser preferences - **Test new workflows**: Ensure
      everything works for your automation needs
  </Step>

  <Step title="Save Updates">
    1. Once you've made your changes, click **Save Changes**
    2. The profile will update with your new configurations
    3. All future conversations using this profile will have the updated settings
  </Step>
</Steps>

## Profile Management Best Practices

<AccordionGroup>
  <Accordion icon="user" title="Organize by Purpose">
    Create profiles based on specific use cases: - **Personal Social**:
    Facebook, Instagram, personal Twitter - **Work Accounts**: Slack, Notion,
    company email, LinkedIn - **E-commerce**: Amazon, eBay, shopping sites with
    saved payment info - **Development**: GitHub, Stack Overflow, development
    tools - **Testing**: Clean profiles for testing user flows
  </Accordion>

  {" "}

  <Accordion icon="shield" title="Security Considerations">
    * **Separate sensitive accounts**: Keep banking/financial accounts in isolated
      profiles - **Regular updates**: Update profiles when you change passwords -
      **Clean testing**: Use separate profiles for testing to avoid affecting real
      data - **Access control**: Each profile maintains its own login states
      securely
  </Accordion>

  <Accordion icon="wrench" title="Profile Maintenance">
    * **Periodic refresh**: Reconnect profiles monthly to keep sessions active -
      **Clear descriptions**: Use clear names so you remember what each profile is
      for - **Test regularly**: Ensure profiles still work before important
      automation tasks - **Update as needed**: Add new accounts when your workflow
      changes
  </Accordion>
</AccordionGroup>

## Common Profile Use Cases

### Work Automation

```
Profile: "Work Setup"
- Signed into: Slack, Notion, Google Workspace, LinkedIn
- Use for: "Send weekly team updates", "Create project documentation", "Apply to similar companies on LinkedIn"
```

### E-commerce Management

```
Profile: "Shopping Assistant"
- Signed into: Amazon, Best Buy, Target, PayPal
- Use for: "Compare prices across sites", "Reorder monthly supplies", "Track package deliveries"
```

### Social Media Management

```
Profile: "Social Media Manager"
- Signed into: Twitter, LinkedIn, Facebook Business, Instagram
- Use for: "Post content across platforms", "Engage with followers", "Monitor brand mentions"
```

### Content Research

```
Profile: "Research Assistant"
- Signed into: Academic databases, News sites, Industry forums
- Use for: "Gather market research", "Find trending topics", "Compile competitive analysis"
```

## Troubleshooting Profiles

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="Profile Not Working">
    **Issue**: AI agent can't access accounts in profile **Solutions**: -
    Reconnect to remote browser and re-login to affected accounts - Check if
    passwords have changed since profile creation - Verify two-factor
    authentication isn't blocking access - Clear and rebuild the profile if
    issues persist
  </Accordion>

  {" "}

  <Accordion icon="clock" title="Sessions Expired">
    **Issue**: Accounts keep asking for login even with profile **Solutions**: -
    Some sites expire sessions quickly - this is normal - Use the AI agent to
    handle re-authentication: "If asked to login, use my saved credentials" - For
    frequently-used accounts, refresh the profile weekly
  </Accordion>

  <Accordion icon="ban" title="Blocked or Restricted">
    **Issue**: Websites are blocking the automated browser **Solutions**: -
    Create a new profile with different browser fingerprints - Use profiles
    intermittently rather than continuously - Contact support if legitimate
    automation is being blocked
  </Accordion>
</AccordionGroup>

## Need Help?

<CardGroup cols={2}>
  <Card title="Profile Setup Guide" icon="video">
    Watch our step-by-step video guide for creating your first profile
  </Card>

  {" "}

  <Card title="Discord Community" icon="discord" href="https://discord.gg/browsepilot">
    Get help from other users who've set up similar profiles
  </Card>

  {" "}

  <Card title="Contact Support" icon="envelope" href="mailto:support@browsepilot.ai">
    Need help with complex profile configurations? We're here to help
  </Card>

  <Card title="API Integration" icon="code" href="/api-reference/endpoint/get">
    Learn how to use profiles programmatically via our API
  </Card>
</CardGroup>