Skip to main content

How to Manually Allow macOS Permissions

Learn how to manually set up all the permissions needed for Insightful to function correctly on macOS

Marija Djurdjevic avatar
Written by Marija Djurdjevic
Updated this week

To find out more about macOS permissions and why they are needed for Insightful to function properly, please see the article on MacOS Permissions Required for Insightful.

If you are also interested in learning how to manage macOS permissions remotely and in bulk (for numerous users at once) via configuration profiles, please review our article on Handling macOS Permissions Remotely (MDM & Config Profiles).

Accessibility Permission

Steps to enable Accessibility Permission:

  1. Click the Apple logo in the top-left corner of your screen and select System Settings.

  2. Click Privacy & Security.

  3. Go to Accessibility permission

  4. Add Workpuls - in case Workpuls is not already listed

    • Click on the plus sign

    • Select Workpuls in the listed apps in the Applications section

  5. Confirm Changes:

    • Ensure that Workpuls is checked in the list of allowed apps. Close the window to save changes.

Automation Permission

This permission is essential for the full functionality of URL capturing.

Steps to Enable Automation Permission:

  1. Open System Preferences:

    • Click the Apple logo and select System Preferences.

  2. Go to Security & Privacy:

    • Click Security & Privacy.

  3. Select the Privacy Tab:

    • Click on the Privacy tab.

  4. Unlock Settings:

    • Click the lock icon and enter your password.

  5. Select Automation:

    • In the left sidebar, scroll down and select Automation.

  6. Allow Workpuls:

    • Check the box next to Workpuls to allow it to control other applications.

Screenshots and Screen Recording Permissions

This permission enables Insightful to capture your screen for screenshots and recordings.

Steps to Screen & System Audio Recording Permission:

  1. Click the Apple logo and select System Settings.

  2. Click Privacy & Security.

  3. Select Screen Recording:

    • In the left sidebar, select Screen Recording.

  4. Add Workpuls:

    • Check the box next to Workpuls to allow screen recording.

  5. Confirm Changes:

    • Close the window to save changes.

    • Make sure to quit Insightful and reopen it again for changes to be applied.

Screen Recording Permission on macOS Sequoia or newer

With the release of macOS Sequoia (version 15+), users may encounter prompts to grant or renew screen recording permissions while using Insightful. These prompts arise due to Apple’s new security protocols, which limit the duration of screen recording permissions.

MacOS Sequoia requires screen recording permissions to be renewed every 30 days, even if you've previously granted permission. This change only affects screen recording permissions, and other permissions remain unaffected.

The sample dialogue below illustrates what you might expect to see:

How to Grant Permission

To continue using Insightful screen recording features, you will need to click Allow for One Month when the system prompts you. This allows screen recording for 30 days, after which re-authorization will be required.

MacOS Permissions Visibility via API

Insightful provides detailed visibility into granted MacOS permissions via API at both the user and organization levels.

If you manage many devices, see How to Handle Permissions Remotely.

Still need help? Reach out to our support team anytime at support@insightful.io.

Did this answer your question?