Overview
IT Admin may choose to install Zoom with preconfigured settings on the Zoom Client for Mac. This installation requires configuring a .plist file and installing it along with the Zoom for IT Admins Installer for Mac.
Settings can be enforced and/or set as just the default settings, which the end-user can still modify after deployment.
Note: Boolean values for plist keys can be noted as the following:
- The value for False can be represented by either 0, NO, no, false, or FALSE
- The value for True can be represented by either 1, YES, yes, true, or TRUE
This article covers:
- Downloading the installer
- Priority of settings
- Creating and configuring the .plist file
- Deploying Zoom
Learn how to install with preconfigured settings on a Windows machine.
Downloading the Installer
Go to Download Center, and click on Download for IT Admin; or download directly from https://zoom.us/client/latest/ZoomInstallerIT.pkg
Priority of settings
Settings can be configured in multiple places. While some can only be configured by the Zoom Admin or IT Admin, some settings can be configured by the end-user as well. If settings conflict, Zoom will use the following priority:
- Priority 1: Setting deployed via us.zoom.config.plist NOT set under PackageRecommend
- Priority 2: Web setting locked for the account or group
- Priority 3: Client setting selected by the user
- Priority 4: Settings deployed via us.zoom.config.plist set under PackageRecommend
- Priority 5: Web settings that are not locked
Creating and configuring the .plist file
If you want to configure options for the Zoom desktop client on Mac, you need to create a .plist file. If you don't configure the .plist file, Zoom will be deployed with the default configuration.
Recommended default settings
Settings can be configured via plist, either as enforced or as recommended defaults using the PackageRecommend key. If the settings are listed under the PackageRecommend key, the Mac client will install with those settings configured, but users will be able to change those options after deployment.
To set the settings as recommended settings, move or add the settings under <key>PackageRecommend</key>. For example, if you want to have the Mac client "Automatically enter full screen when viewing shared content" by default, but not allow Google or Facebook login, the plist file would be:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>nogoogle</key>
<true/>
<key>nofacebook</key>
<true/>
<key>PackageRecommend</key>
<dict>
<key>ZAutoFullScreenWhenViewShare</key>
<true/>
</dict>
</dict>
</plist>
General settings
The .plist file can contain the following keys:
Description | Default | Plist key | Value |
Default to login with SSO | Disabled | ZAutoSSOLogin | Boolean |
Preconfigured SSO URL | Disabled | ZSSOHost | String |
Configures and locks the SSO URL | Disabled | forcessourl | String |
Disable Google login option | Disabled | nogoogle | Boolean |
Disable Facebook login option | Disabled | nofacebook | Boolean |
Disable Email login option | Disabled | disableloginwithemail | Boolean |
Disable SSO login option | Disabled | nosso | Boolean |
Require new SSO login upon client start | Disabled | DisableKeepSignedInWithSSO | Boolean |
Require new Google login upon client start | Disabled | DisableKeepSignedInWithGoogle | Boolean |
Require new SSO login upon client start | Disabled | DisableKeepSignedInWithFacebook | Boolean |
Launches SSO login within the app instead of using the default browser | Disabled | enableembedbrowserforsso | Boolean |
Sets the web domain for logging in or joining a meeting, by default the values is https://zoom.us or https://zoom.com | Disabled | setwebdomain | String |
Remember the last login type used | Disabled | LastLoginType | Boolean |
Client automatically logs in to the last account used | Disabled | keepsignedin | Boolean |
Allow updates through the client by users | Disabled | ZAutoUpdate | Boolean |
Set the email address domain that users can login with |
Disabled | login_domain | String |
Default to Portrait Mode upon opening Zoom |
Disabled | DefaultUsePortraitView | Boolean |
Disables the direct share option in the Zoom client |
Disabled | disabledirectshare | Boolean |
Allows presenting to a Zoom Room with audio content |
Enabled | presenttoroomwithaudio | Boolean |
Enables HID control of USB audio devices from the Zoom client |
Disabled | enablehidcontrol | Boolean |
Automatically minimizes the Zoom client to the Dock when the app is closed |
Disabled | min2tray | Boolean |
Displays the "Call Room System" button on the home screen of the Zoom app |
Disabled | enablestartmeetingwithroomsystem | Boolean |
Adds participant names when viewing a room systems video feed |
Disabled | appendcallernameforroomsystem | Boolean |
Set account IDs* that the client is restricted to join meetings hosted by specific accounts |
Disabled | account | String |
Shows video preview when joining a meeting |
Enabled | alwaysshowvideopreviewdialog | Boolean |
Disables GPU acceleration |
Disabled | legacycapturemode | Boolean |
The client will block connections to untrusted SSL certificates |
Disabled | blockuntrustedsslcert | Boolean |
Allows embedding text in the Zoom using agent, for tracking |
Disabled | embeduseragentstring | String |
*Note: Please have an account admin or owner contact Support to acquire your account ID.
Meeting Settings
The .plist file can contain the following keys:
For the following settings, all value types are Boolean.
Description | Default | Plist Key |
Always use PMI for instant meetings | Disabled | usepmi |
Disable Camera by default | Disabled | ZDisableVideo |
Disable sending video from the Zoom Client | Disabled | zdisablesendvideo |
Disable receiving video from the Zoom Client | Disabled | zdisablerecvvideo |
Disable use of computer audio on the Zoom Client | Disabled | disablecomputeraudio |
Enable Orginal Sound for audio | Disabled | enableoriginalsound |
Automatically join VoIP | Disabled | ZAutoJoinVoip |
Automatically adjust microphone levels | Enabled | audioautoadjust |
Enables echo cancellation for the microphone audio | Disabled | EnableEchoCancellation |
Uses the system default speaker when using computer audio | Enabled | setusesystemdefaultspeakerforvoip |
Uses the system default speaker when using microphone audio | Enabled | setusesystemdefaultmicforvoip |
Automatically enable dual monitor | Disabled | ZDualMonitorOn |
Automatically enter full screen when viewing shared content | Enabled | ZAutoFullScreenWhenViewShare |
Automatically fit to window when viewing shared content | Enabled | ZAutoFitWhenViewShare |
Disables annotation when screen-sharing or viewing a screen share | Disabled | zdisableannotation |
Enables Do Not Disturb when sharing | Enabled | EnableDoNotDisturbInSharing |
Disables the use of the Whiteboard feature in-meeting | Disabled | disablewhiteboard |
Allows sharing of video clips when screen sharing | Enabled | enablesharevideo |
Allows the sharing of audio only when screen sharing | Enabled | enableshareaudio |
Full Screen when starting or joining a meeting | Disabled | FullScreenWhenJoin |
Always show meeting controls (Disable auto-hide toolbar) | Disabled | AutoHideToolbar |
Enable HD Video by default | Disabled | ZUse720PByDefault |
Remote control all applications |
Enabled | ZRemoteControllAllApp |
Hide non-video participants by default |
Disabled | ZHideNoVideoUser |
Always mute microphone when joining a meeting |
Disabled | MuteVoipWhenJoin |
Show the length of time that the user has been in a meeting | Disabled | ShowConnectedTime |
Confirm before leaving a meeting |
Enabled | ConfirmWhenLeave |
Disable Screen Share when starting or joining a meeting |
Disabled | DisableScreenShare |
Disables Remote Control when screen sharing |
Disabled | disableremotecontrol |
Disables 1:1 remote support when screen sharing |
Disabled | disableremotesupport |
Enable mirroring of shared video |
Disabled | EnableMirrorEffect |
Enables side-by-side mode by default |
Disabled | enablesplitscreen |
Disables Local Recording from the Zoom Client | Disabled | zdisablelocalrecord |
Disables Cloud Recording from the Zoom Client | Disabled | zdisablecmr |
Disables use of the Virtual Background feature | Disabled | disablevirtualbkgnd |
Disable video filters |
Disabled | DisableVideoFilters |
Split traffic across different ports for easier identification |
Disabled | EnableIndependentDataPort |
The Zoom Client will verify the server certificate |
Disabled | EnableSSLVerification |
Enables a reminder for upcoming meetings |
Disabled | EnableRemindMeetingTime |
Enables Gallery View to display up to 49 participants per screen |
Disabled | Enable49Video |
Enables spotlight of your video when speaking |
Disabled | EnableSpotlightSelf |
The following Meeting Settings are String values:
Description |
Default | Plist Key |
Limit the Maximum amount of bandwidth by the Mac client |
Disabled | bandwidthlimitup |
Limit the Minimum amount of bandwidth used by the Macclient |
Disabled | bandwidthlimitdown |
Set path for local meeting recording files |
/Users/User Name/Documents/Zoom | recordpath |
Set proxy bypass rule for the Zoom Client | Disabled | proxybypass |
Set the proxy server for the Zoom Client | Disabled | proxy |
Set proxy server to client with PAC URL for the Zoom Client |
Disabled | proxypac |
Set noise suppression level Auto - 0 |
Auto (0) | SetSuppressBackgroundNoiseLevel |
Chat settings
The .plist file can contain the following keys:
Description | Default | Plist key |
Disables the group chat function in the Zoom client | Disabled | zdisablechat |
Disable Link Preview | Disabled | DisableLinkPreviewInChat |
Disables file transfer | Disabled | zdisableft |
Disable the option to send voice messages | Enabled | ShowVoiceMessageButton |
Note: The above key value is Boolean.
Deploying Zoom
An example .plist file with settings from above enabled by default can be found here.
Once the .plist file is complete, it will need to be named us.zoom.config.plist. When deploying, as long as this file is in the same folder as the ZoomInstallerIT.pkg, the installation will automatically put the .plist file into the /Library/Preferences folder.
You can also deploy IT packages through JAMF, Intune, AirWatch and other solutions, and push the .plist through them. The Zoom client will also try to read the us.zoom.config.plist. located in the /Library/Managed Preferences folder.