Skip to content

Create and Edit a Browser Profile

Create profiles individually when each one requires separate configuration. The page provides Quick Create and Advanced Configuration modes and remembers the mode used for the most recent successful submission.

Open the Creation Page

  1. Go to Browser Profiles.
  2. Click Create Profile in the upper-left corner.
  3. Select Quick Create or Advanced Configuration based on your requirements.

If the button is unavailable, the current member does not have permission to create profiles. Ask a team administrator to grant the required permission.

Use Quick Create

Quick Create includes the most frequently used fields and applies the default fingerprint from Preferences. Complete the fields in this order:

  1. Enter a Profile Name.
  2. Select a browser engine and version.
  3. Select an operating system and version.
  4. Select a profile group.
  5. Add notes.
  6. Select a method under Proxy Settings.
Quick creation for one profile
Quick creation for one profile

Quick Create does not show account, extension, common setting, or full fingerprint fields. The Profile Check and Primary Fingerprint Parameters remain available on the right. To address a warning, click View More or Switch to Advanced Configuration.

TIP

ZYBrowser remembers the creation mode used for your last successful submission and selects the same mode the next time you create a profile.

Select a Proxy Method

An individual profile supports four proxy methods:

MethodRequired informationUsage
No ProxyNoneUses the computer's direct network egress
CustomProxy protocol, IP protocol, host, and port; username and password are optionalClick Test Proxy in the desktop client to check connectivity. The host accepts an IP address or domain, and you can paste host:port
Proxy APIProxy protocol, IP protocol, fetch policy, and API URLThe URL must include http:// or https://; fetch a proxy on every launch or only when the previous IP is no longer valid
Saved ProxySelect an existing proxy from the proxy listA proxy must be selected before saving

Proxy testing and API validation require local client capabilities. The web app can save cloud configuration but cannot perform local tests or launch profiles.

Recommendation

Manage proxies in the Proxies module instead of entering proxy details directly on the profile creation page.

After configuration, select the saved proxy when creating the profile.

Warning

Proxy usernames, passwords, and API URLs may be sensitive credentials. Never expose real values in screenshots, notes, or public documentation.

Use Advanced Configuration

Switch to Advanced Configuration to access the complete form:

SectionAvailable settings
Basic InformationProfile name, window dimensions, browser, operating system, UA version, custom User-Agent, group, cookies, and notes
Proxy SettingsNo Proxy, Custom, Proxy API, or Saved Proxy
Account SettingsCreate an account record or select an existing account and assign it to the profile
Extension SettingsSelect personal, team, and global extensions
Common SettingsControl webpage behavior for images, audio, notifications, and more, and decide whether network changes should stop the launch
Fingerprint SettingsConfigure WebRTC, time zone, geolocation, language, resolution, fonts, hardware information, and other browser characteristics
Advanced configuration for one profile
Advanced configuration for one profile

Cookies must be a JSON array. Every item must be an object containing at least name and value:

json
[
  {
    "name": "session_id",
    "value": "example-value"
  }
]

Warning

Enter real cookies only in the local form. Never save active login sessions in public files or screenshots.

For centralized account or extension management, see Assign a Browser Profile and Select the Load Scope.

Select a Submission Action

The following actions are available for a new profile:

ActionResult
Create ProfileSaves the profile and returns to the profile list
Create and LaunchSaves and immediately launches the new profile in the desktop client, then returns to the list
Create and ContinueSaves the profile, resets the form, and remains on the page for the next profile
CancelDiscards the current form and returns to the profile list

Edit an Existing Profile

  1. Find the profile in the list.
  2. Open its More menu.
  3. Click Edit.
  4. Update settings in Quick or Advanced mode.
  5. Select Save Profile or Save and Launch.

If the profile is already open, the second action changes to Save and Restart. The client closes the old window and relaunches it with the latest configuration. Save-and-launch or restart is unavailable while the profile is running an RPA task. Wait for the task to finish or stop it under Task Management and Scheduling.

Actions for saving an edited profile
Actions for saving an edited profile

TIP

ZYBrowser remembers the edit mode used for your last successful submission and selects the same mode the next time you edit a profile.

Next Steps