UiPath Documentation
delegate
latest
false
Delegate user guide

Settings reference

All settings available in Delegate, organized by tab, including storage locations and configuration options for appearance, behavior, and integrations.

This page documents every setting available in Delegate, organized by the tab where you find it in the Settings panel. Open Settings by clicking the gear icon in the bottom-left corner of Delegate, or use the keyboard shortcut. See Settings file locations below for where these settings are stored on disk.

General

Default behavior for new tasks, language, startup, and how Delegate appears on your desktop.

SettingOptionsDescription
LanguageAny supported languageUI language
New tasksLocal, RemoteLocal keeps task messages on this device. Remote stores them on the server.
Sound effectsTogglePlay audio feedback for task completion, achievements, and more
Flash taskbar icon when approval is neededToggleFlash the taskbar icon when a task is waiting for your approval

Reset options

  • Reset Onboarding: Re-run the welcome tour on next launch
  • Reset Setup: Re-run the initial setup wizard on next launch

Neither option resets your connections, skills, or preferences.

Behavior preferences

Configure how Delegate communicates and acts. These preferences guide interaction style.

Some preferences may conflict with Delegate's default behavior or safety guidelines. In those cases, built-in defaults take precedence.

Work profile

A preset that adjusts all the preferences below at once — for example, an "Engineering" preset.

Communication

SettingWhat it controlsOptions
StyleHow verbose responses should beConcise, Balanced, Detailed
ToneThe tone of responsesProfessional, Friendly, Direct, Technical, Executive-ready

Behavior

SettingWhat it controlsOptions
ProactivityHow actively Delegate suggests actionsReactive only, Suggest next steps, Highly proactive
ClarificationHow Delegate handles unclear requestsAsk before assumptions, Make reasonable assumptions, Minimize questions

Action transparency

Three independent toggles, each off unless noted:

SettingWhat it does
Explain before executionDescribe intended actions before performing them
Summarize after executionProvide a summary after completing actions (on by default)
Highlight risksWarn about risks before sensitive actions

Additional notes

Free-text instructions Delegate follows going forward, up to 2500 characters — for example, "Always use bullet points" or "Respond in Spanish." Quick-add suggestions are offered (use code blocks for commands, always use bullet points, keep it under 3 sentences, include code examples, explain tradeoffs).

Custom preferences

Add your own name/value pairs beyond the built-in settings above — for example, Name: "Language", Value: "Always respond in Spanish".

Security

Privacy

Choose what diagnostic data Delegate sends to UiPath. You can change this any time.

SettingDefaultDescription
Usage analyticsOnTool usage, feature interactions, and session duration. The content of your tasks is never sent.
Crash reportsOnErrors and stack traces when something goes wrong. Helps fix bugs faster.
Essential telemetryAlways onLicense validation and security audit.

A link to the privacy policy is available directly on this tab.

Apps & defaults

Configure how Delegate hands off work to your operating system and applications.

The following table describes the application defaults you can configure.

SettingOptionsDescription
Default File OpenerSystem, Explorer, Cursor, VS Code, etc.Which application opens files when Delegate needs an editor
Default Mail HandlerSystem, Outlook, Gmail, CustomHow Delegate sends emails
Default Calendar HandlerFollow Mail, System, Outlook, Gmail, CustomHow Delegate manages calendar events
Default Office AppSystem, Office, iWork (macOS only)Preferred suite for document creation

Custom handlers

When selecting Custom for mail or calendar:

  • Enter the application name in the Custom Name field
  • Delegate uses system APIs to hand off to that application

Named browser profiles

Configure up to 3 browser profiles for Delegate to use in different contexts.

FieldDescription
NameFriendly label (e.g., "Personal", "Work")
ProfileBrowser and profile directory (e.g., chrome:Default, edge:Profile 1)

Format: <browserType>:<profileDirectory>

  • browserType: chrome or edge
  • profileDirectory: Default, Profile 1, Profile 2, etc.
Discovery
  • Chrome profiles: ~/Library/Application Support/Google/Chrome/ (macOS) or %LOCALAPPDATA%\Google\Chrome\User Data\ (Windows)
  • Edge profiles: ~/Library/Application Support/Microsoft Edge/ (macOS) or %LOCALAPPDATA%\Microsoft\Edge\User Data\ (Windows)

Use case: Separate work and personal browsing contexts. Each profile has its own cookies, logins, and extensions.

Recordings

Record yourself performing a task on your screen, to use afterward as the basis for a routine, a skill, or as source material for documentation such as a PDD.

Each recording captures your steps and which apps you used:

From a recording, you can:

  • Build routine — turn the recording directly into a Routine.
  • Add optional notes describing what the recording is for.
  • Show in Explorer — locate the recording file on disk.
  • Delete — remove the recording.

Keyboard shortcuts

Customize keyboard shortcuts for common Delegate actions.

Default shortcuts

The following table lists the default keyboard shortcuts.

ActionmacOSWindowsDescription
Toggle WindowCmd+Shift+SpaceCtrl+Shift+SpaceShow or hide Delegate
New ConversationCmd+NCtrl+NStart a new chat
New WindowCmd+Shift+NCtrl+Shift+NOpen Delegate in a new window

Customizing shortcuts

To customize keyboard shortcuts, take the following steps:

  1. Go to SettingsKeyboard Shortcuts.
  2. Find the action to modify.
  3. Select the shortcut field.
  4. Press your desired key combination.
  5. Select Save.

Avoiding conflicts

If your chosen shortcut conflicts with a system or application shortcut, it may not work reliably. Use combinations with Cmd+Shift (macOS) or Ctrl+Shift (Windows) to minimize conflicts.

Advanced

Settings for power users and developers.

SettingDefaultDescription
Use Deferred ToolsOffSend lightweight tool stubs; activate full tools on demand
Context Grounding IndexesEnable or disable specific context sources
Window PiP PreferenceChildSessionPicture-in-picture mode (Windows only)
Auth TCP Port (Windows)Fallback port for Windows elevation authentication

Context grounding indexes

Enable or disable specific context sources that feed into Delegate's understanding:

  • Web Search Index: Recent web search results
  • File System Index: Recently accessed files
  • Conversation Index: Past conversation content
  • Custom Indexes: Organization-specific knowledge bases

Privacy note: Disabling indexes reduces context awareness but increases privacy.

Centrally governed: An administrator can control this at the policy level under Skills & Knowledge, with a single Enable context grounding knowledge toggle that allows or blocks the agent from using organization knowledge bases and document indexes for grounded responses. Built-in skills, such as the Excel and PowerPoint document-generation capabilities, are core product capabilities and are not configurable through this policy tab. See Governance with Automation Ops.

Settings file locations

For power users who want to edit settings directly or back up configurations.

Main settings file

The following table lists the settings file location for each supported platform.

PlatformPath
macOS~/Library/Application Support/UiPath/Delegate/settings.json
Windows%APPDATA%/UiPath/Delegate/settings.json
Linux~/.config/UiPath/Delegate/settings.json
  • Plain JSON format; human-readable and editable
  • Changes take effect immediately (Delegate watches for file changes)
  • Invalid JSON is rejected; Delegate uses the last valid configuration

Secure settings file

The following table lists the secure settings file location for each supported platform.

PlatformPath
macOSSame directory, secure-settings.enc (Keychain encryption)
WindowsSame directory, secure-settings.enc (Data Protection API (DPAPI) encryption)
  • Contains: tool categories, Approval Mode, authentication tokens
  • Only modifiable through the Settings UI
  • Agents cannot read or modify this file

Other files

The following table lists other files stored in the settings directory.

FileContents
WindowState.jsonWindow position, size, sidebar state
conversations.dbLocal conversation history (when using Local storage)
LocalSkills/Installed skills and routines

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated