# Configuration steps

> To use UI Automation on macOS, you must grant **UiPath Assistant** the required permissions in **System Settings > Privacy & Security**.

To use UI Automation on macOS, you must grant **UiPath Assistant** the required permissions in **System Settings > Privacy & Security**.

**UiPath Assistant** requires the following permissions:

- **Accessibility** — to automate desktop applications or to use the **Hardware Events** input mode.
- **Screen Recording** — to take screenshots of the target UI elements.
- **Full Disk Access** — to work with files on disk.

:::note
* The **Screen Recording** permission is not mandatory. If this permission is not set, the solution works, but with limited functionality. You will be able to indicate, but informative screenshots won't be taken, and you won't be able to use Computer Vision.
* Even when **Screen Recording** permission is granted, macOS security policies may inform the user that the entire screen is being captured by **UiPath Assistant**. For more information, refer to [Known issues](https://docs.uipath.com/activities/other/latest/ui-automation/macos-configuration-steps#known-issues).
:::

## Grant the permissions

To grant **UiPath Assistant** the required permissions, take the following steps:

1. Select **System Settings** in the **Apple** menu.
2. Select **Privacy & Security**.
3. Select **Accessibility**.
4. Do one of the following:
    - If **UiPath Assistant** is already listed, turn the toggle on.
    - If **UiPath Assistant** does not appear in the list:
        1. Select the **+** button.
        2. Search for **UiPath Assistant** and select it.
        3. Select **Open**.
        4. Make sure the **UiPath Assistant** application is listed and the toggle is on.
5. Return to **Privacy & Security** and select **Screen & System Audio Recording**.
6. Enable **UiPath Assistant** in the list.
7. Return to **Privacy & Security** and select **Full Disk Access**.
8. Enable **UiPath Assistant** in the list.
9. Changing any of these permissions require a **UiPath Assistant** restart.

### Accessibility settings

![macOS Privacy & Security Accessibility pane with the UiPath Assistant entry enabled in the list](https://dev-assets.cms.uipath.com/assets/images/activities/activities-docs-image-444590-402f3a5e.webp)

### Screen Recording settings

![macOS Privacy & Security Screen and System Audio Recording pane with the UiPath Assistant entry enabled in the list](https://dev-assets.cms.uipath.com/assets/images/activities/activities-docs-image-574330-e5ca21e2.webp)

### Full Disk Access settings

![macOS Privacy & Security settings showing the Full Disk Access pane with UiPath Assistant in the list of applications](https://dev-assets.cms.uipath.com/assets/images/activities/uia-macos-full-disk-access-1d3f084d.webp)

## Known issues

Even when **Screen Recording** permission is granted, macOS security policies may inform the user that the entire screen is being captured by **UiPath Assistant**.

![macOS system dialog showing UiPath Assistant requesting to bypass the system private window picker and directly access screen and audio, with Allow and Open System Settings buttons](https://dev-assets.cms.uipath.com/assets/images/activities/uia-macos-screen-recording-alert-4e391e72.webp)

This pop-up may appear at design time when building UI automations that save screenshots. In this case, the user can close the alert. However, this could also affect automations at runtime when using the **Take Screenshot** activity.

The best solution is to disable the screen capture alert pop-up on macOS through an MDM configuration: set the **Force bypass screen capture alert** setting to **On** in your configuration profile. Use a device management service that supports this restriction. For more information, refer to [Device management restrictions for Mac computers](https://support.apple.com/en-gw/guide/deployment/depba790e53/web).

## Browser extension installation

To generate web selectors for browser automations, install the required [extensions](https://docs.uipath.com/studio-web/automation-cloud/latest/user-guide/using-ui-automation).