UiPath Documentation
studio
latest
false
Studio user guide

Extension for Safari

Install and configure the UiPath Extension for Safari to enable UI automation in Safari on macOS with Studio Web and local macOS Robot.

Starting with UiPath.UIAutomation.Activities version 24.10.0, Safari UI Automation support is available in preview. The extension for Safari lets you:

  • Design UI automations in Studio Web within the Safari browser on macOS.
  • Execute browser automations in Safari using a local macOS Robot, previously installed and connected to the Orchestrator.
  • Start attended browser automations in Safari via the macOS Assistant.

To create and run such automations, you must install the UiPath Browser Automation extension for Safari.

You can start from Studio Web by adding any UI Automation activities. When accessing Studio Web from Safari, you are prompted to install the UiPath extension for Safari from the App Store. Follow the setup guide to configure the extension, then start designing your workflows for browser automation in Safari.

Note:

To create browser automations in Safari on machines running macOS, the minimum supported version is macOS 12.

Install​

Installing the Safari extension also installs the Native Host component. This means that you can run automations from UiPath Assistant without the need for additional installation.

Install from App Store​

Install Steps​

  1. Access the UiPath extension for Safari directly in the App Store

  2. Select Get to install the extension, and then Open it.

  3. After you select Open, a configuration window appears.

  4. Select Open Safari settings to access the Extensions window, where you can set the right permissions for the newly installed extension.

    1. Enable the UiPath Browser Automation extension in the left-side panel.

    2. Select Always Allow on Every Website and confirm this choice.

    3. If you intend to use private browsing, enable the Allow Private Browsing setting.

Result: A message informs you that the extension is now available.

Install from UiPath Studio Web​

Install Steps​

  1. In UiPath Automation Cloud™, access Studio Web.

  2. Add a Use Browser activity to your project. You are prompted to install the UiPath extension for Safari.

  3. Select the Install extension button.

  4. The App Store opens with the UiPath Browser Automation extension.

  5. Continue the installation process from step 2 of the Install from App Store section.

Result: A message informs you that the extension is now available.

Install from UiPath Assistant​

Installation using UiPath Assistant requires no additional configuration, as long as UiPath Assistant is already installed. This method installs the latest extension version published to the Web Store for the current user only.

Install Steps​

  1. Access UiPath Assistant.

  2. Select the account icon.

  3. Select Preferences.

  4. Go to UiPath Extensions.

  5. Select Install for Safari.

Note:

Alternatively, select View on App Store to get the extension from the App Store, and then continue from step 2 of the Install from App Store section.

Result: The extension is installed and enabled in Safari.

Install from Terminal​

The installation from Terminal is performed via UiPath.ExtensionControl.Portable.dll.

UiPath provides a tool for managing extension installation: UiPath.ExtensionControl.Portable.dll. This tool is distributed with UiPath Assistant, which also includes the latest extension application packaged as an archive.

This method updates the Safari configuration so that the extension is recognized as installed. The extension is installed for the current user only.

Warning:

This method is not meant for production environments, as it relies on a mechanism that Apple might change in future updates. Use it only if no other alternative is available.

Prerequisites​
  • All instances of Safari are closed.
Install Steps​

  1. Open a Terminal and run the following command:

     dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install safari
 dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install safari

  2. Start Safari to design and run automations.

Result: The extension is installed and enabled in Safari.

Install using an MDM​

To install via an MDM (mobile device management) application, the machine has to be enrolled to be managed. More details on how device management works on Apple machines can be found on this page: Device Management | Apple Developer Documentation.

Examples of MDMs include:

This method relies on the new declarative management model to push configuration changes to the managed machine(s). The configuration for Safari extensions is detailed here: SafariExtensionSettings | Apple Developer Documentation.

Uninstall​

Uninstall from UiPath Assistant​

Uninstall Steps​

  1. Access UiPath Assistant.

  2. Select the account icon.

  3. Select Preferences.

  4. Go to UiPath Extensions.

  5. Select Uninstall for Safari.

Result: The extension is uninstalled and removed from the Applications folder.

Uninstall from Terminal​

The uninstallation from Terminal is performed via UiPath.ExtensionControl.Portable.dll.

UiPath provides a tool for managing extension installation: UiPath.ExtensionControl.Portable.dll. This tool is distributed with UiPath Assistant.

This method updates the Safari configuration so that the extension is uninstalled. The extension is uninstalled for the current user only.

Warning:

This method is not meant for production environments, as it relies on a mechanism that Apple might change in future updates. Use it only if no other alternative is available.

Prerequisites​
  • All instances of Safari are closed.
Uninstall Steps​

  1. Open a Terminal and run the following command:

     dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll uninstall safari
 dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll uninstall safari

Result: The extension is uninstalled and removed from the Applications folder.

Uninstall from Safari settings​

Uninstall Steps​

  1. Access Safari Settings.

  2. Navigate to the Extensions tab.

  3. Select the Uninstall button.

  4. Select the Show in Finder button. This opens the Finder with the application selected.

  5. Open the context menu for the UiPath for Safari application and select Move to the Bin.

    If a pop-up message states the application cannot be deleted because it is in use:

    1. Open Activity Monitor and search for UiPath Native Host for Safari.

    2. Select the application, choose Stop, then select Quit.

    3. Return to Finder and select Move to Bin again.

  6. Enter your Mac credentials and then select OK to authorize this deletion.

Result: The extension is uninstalled. It is removed from the Safari extension bar and from the Safari Settings Extensions tab.

Accessibility configuration​

To use the Hardware Events input mode, you must specifically grant UiPath Assistant access to your Mac using the Privacy & Security settings.

To do so, follow the steps below:

  1. Select the Apple menu.

  2. Select System Settings.

  3. Select Privacy & Security in the left sidebar.

  4. Go to Accessibility by selecting the arrow on the right-hand side.

  5. Enable UiPath Assistant from the list. If you do not see the application, select + at the bottom of the list, search for UiPath Assistant, select the application, and choose Open. Mac credentials are requested for this change.

Result: UiPath Assistant is now authorized to use Hardware Events input mode in Safari automations.

Full Disk Access configuration​

To install the Safari extension using UiPath Assistant, you must specifically grant UiPath Assistant access to your Mac files using the Privacy & Security settings.

To do so, follow the steps below:

  1. Select the Apple menu.
  2. Select System Settings.
  3. Select Privacy & Security in the left sidebar.
  4. Go to Full Disk Access by selecting the arrow on the right-hand side.
  5. Enable Full Disk Access from the list:
    • If UiPath Assistant is listed, enable it.
    • If UiPath Assistant is not listed, select + at the bottom of the list, search for UiPath Assistant, select the application, and choose Open.
Note:

Mac credentials are requested for this change.

Result: UiPath Assistant is now authorized to edit the files on your Mac.

Known limitations​

Consider the following limitations when creating browser automations for Safari:

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated