Configuring Permissions

By default, all permissions are set to allow by the launchApp command. It is possible to launch an app with custom permissions behaviour by passing the permissions argument to launchApp.
Permission Name
Maestro has standardised names for most permissions.
For example, on Android: bluetooth targets both android.permission.BLUETOOTH_CONNECT and android.permission.BLUETOOTH_SCAN.
Permission
iOS support
Android support
calendar
​✅
​
​✅
​
camera
​✅
​
​✅
​
contacts
​✅
​
​✅
​
health
❌
❌
homekit
​✅
​
❌
location
​✅
​
​✅
​
medialibrary
​✅
​
​✅
​
microphone
​✅
​
​✅
​
motion
​✅
​
❌
notifications
​✅
​
​✅
​
photos
​✅
​
❌
reminders
​✅
​
❌
siri
​✅
​
❌
speech
​✅
​
❌
usertracking
​✅
​
❌
bluetooth
❌
​✅
​
phone
❌
​✅
​
storage
❌
​✅
​
sms
❌
​✅
​
my.custom.permission
❌
​✅
​
Note: Use all as a permission name to represent all the permissions that the app can ask for.
Supporting permission IDs for Android
There are permissions on Android that are not listed in the table above. Use the permission IDs in place of the permission name to set these permissions.
For example, to allow the "add voicemail" permission, use:
- launchApp:
    permissions:
        com.android.voicemail.permission.ADD_VOICEMAIL: allow
Permission Value
Every permission can be set to: allow, deny or unset
Permission Value
iOS
Android
allow
Permission granted
Permission granted
deny
Permission denied
Permission will be asked during flow run
unset
Permission will be asked during flow run
Permission will be asked during flow run
Some iOS permissions can have other values
Permission
Value
Description
location
always
Same as allow
​
inuse
Only allow location whilst using the app
​
never
Same as deny
photos
limited
Allow limited access to photos
Examples
Permissions are set by passing them to the launchApp command as follows:
Deny all permissions
- launchApp:
    permissions: { all: deny } 
Deny all permissions but allow the medialibrary permission
- launchApp:
    permissions:
        all: deny
        medialibrary: allow
Deny all permissions but allow adding voicemails
- launchApp:
    permissions:
        all: deny
        com.android.voicemail.permission.ADD_VOICEMAIL: allow

Permission	iOS support	Android support
calendar	✅	✅
camera	✅	✅
contacts	✅	✅
health	❌	❌
homekit	✅	❌
location	✅	✅
medialibrary	✅	✅
microphone	✅	✅
motion	✅	❌
notifications	✅	✅
photos	✅	❌
reminders	✅	❌
siri	✅	❌
speech	✅	❌
usertracking	✅	❌
bluetooth	❌	✅
phone	❌	✅
storage	❌	✅
sms	❌	✅
my.custom.permission	❌	✅

Permission Value	iOS	Android
allow	Permission granted	Permission granted
deny	Permission denied	Permission will be asked during flow run
unset	Permission will be asked during flow run	Permission will be asked during flow run

Permission	Value	Description
location	always	Same as allow
	inuse	Only allow location whilst using the app
	never	Same as deny
photos	limited	Allow limited access to photos

Last modified 1mo ago