UiPath Documentation
delegate
latest
false
Delegate user guide

Local security configuration

Security controls an individual user sets directly from the chatbox — approval mode, screen context, and execution mode — plus OS-level permissions and advanced security settings.

This page covers the security controls you set yourself, as an individual user, starting with the three controls available directly from the chatbox.

Security checklist

These are the main tasks to configure Delegate locally, in order:

Approval mode

Set from the mode selector next to the chatbox, and applies to all chats:

ModeBehavior
CautiousAsks for all operations; strict process isolation with allowlist-only access
Balanced (recommended)Runs safe tools automatically; asks before high-impact operations; protects credentials and sensitive files
AutonomousFull system access, no prompts

Approval mode sets the defaults for the granular, per-tool, per-file, and per-app/site controls — tool permissions, terminal and files, protected files, and UI automation — described in Security settings reference.

Computer use settings

Screen context and execution mode both govern Delegate's computer use — what it can see, and how it acts on your screen.

Screen context

Governs what Delegate can see. Set from the screen icon next to the chatbox:

OptionWhat Delegate sees
DefaultOnly the apps attached to the current chat
All appsEvery visible app
NoneNothing — Delegate can ask you to turn it on when it needs to

The chatbox also shows which apps are currently attached to the chat, since Delegate only sees what's listed there when capturing your screen.

First message of each turn

A related setting under SettingsGeneralGeneral:

In Default mode, each user message gets one full-screen capture so "do this for me" works on cold start. Subsequent turns within the turn mask to attached apps. On by default.

Execution mode

Governs how Delegate acts — whether it takes over your screen or works without touching it. Set from the computer icon next to the chatbox:

ModeBehavior
AutonomousTakes over your screen to perform actions; only asks for approval when security policy requires it
GuidedTakes over your screen to perform actions; asks for your approval before interacting with each app
OffscreenWorks in its own environment without taking over your screen — you keep working, and it notifies you when it needs input

Offscreen expands into three sub-modes:

Sub-modeBehavior
Local (new session)Creates a separate Windows session via RDP (requires setup)
Web onlyRuns browser tasks in a minimized window via CDP — parallel-friendly for browser work
Native BackgroundRuns web and desktop tasks together in the background

A separate Always plan before toggle, next to execution mode, has Delegate review its plan with you before executing the task — this may consume more token units.

For Autonomous and Guided mode, where Delegate takes over your screen, two auto-minimize settings keep it out of the way while it works:

SettingDefaultWhat it does
Enable Auto-MinimizeOnMinimize the Delegate window during UI automation
Maximize Target AppOnBring the target application to full screen during automation

For the Web only and Native Background sub-modes, you can select which named browser profile to use — this determines which cookies, logins, and extensions are available.

Advanced security settings

Beyond approval mode, SettingsSecurity holds four areas of fine-grained, per-tool, per-file, and per-app/site controls:

AreaCovers
Tool permissionsAllow, Ask, or Block for individual tools, connectors, and operations
Terminal and filesThe shell command sandbox, its allowed paths, capabilities, and blocked commands
Protected filesFiles Delegate needs approval to access — secrets, keys, cloud credentials, config, and data files
UI automationTrusted and blocked apps and websites

See Security settings reference for the full breakdown of each.

Conversation storage

A user-selectable, security-relevant setting that lives outside Settings → Security: New tasks, under SettingsGeneralGeneral.

ModeBehavior
LocalChat history stays on the device only (SQLite).
RemoteA PostgreSQL database stores chat session metadata, message content, delegation requests, user settings, daily usage, and product settings.

Message content, including attachments and screen context screenshots, transits the UiPath backend for inference regardless of storage mode, but is not persisted server-side in Local mode.

OS-level permissions

Beyond approval mode, screen context, and execution mode, the operating system controls what Delegate can do — and always takes precedence: if macOS or Windows denies a permission, Delegate cannot do that thing regardless of what you have set above.

macOS permissions

The following table lists the permissions Delegate requires on macOS.

PermissionWhere to GrantWhat It Enables
Screen RecordingSystem Settings → Privacy & Security → Screen RecordingDelegate can see your screen for context
AccessibilitySystem Settings → Privacy & Security → AccessibilityDelegate can click, type, and control applications
Files and FoldersGranted per-folder when first accessedReading and writing specific directories
MicrophoneSystem Settings → Privacy & Security → MicrophoneVoice input (optional)

To revoke: Go to the same settings and uncheck Delegate. The app will continue to work but with reduced capabilities.

Windows permissions

The following table lists the permissions Delegate requires on Windows.

PermissionWhere to GrantWhat It Enables
UI AutomationUser Account Control during installControlling applications
File SystemStandard user permissionsReading/writing files in accessible locations
NetworkWindows Firewall (if prompted)Web access, cloud integrations
Note:

On Windows, running as Administrator grants broader access but is not required for normal operation, and prevents Delegate from driving applications you have launched as administrator.

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated