Query Params Reference
With query parameters on Appetize, users can easily switch between different device and operating system versions, languages, and many other options in order to customize their experience
Supported Query Parameters
Appetize's App and Embed links can contain several additional query parameters to help customize your experience with your app.
You may see these query parameters in action when you run our online demo, and observe changes to your browser's address bar.
11.4, 12.2, 13.3, 14.0
Note: It is recommended not to include osVersion
as a query parameter when embedding the app, as this will always use our latest default version.
a number between 10 and 100, or auto
Adjusts the size of the device shown on the page. auto
will scale to fit the size of the iframe (embeds only).
true, false
When true, starts streaming the app on page load. Default is false
Note: If you are making use of our JavaScript SDK, we recommend starting the session programmatically using client.startSession()
instead as this may cause the session to start before the SDK is ready.
top, bottom
Adjusts the position of Appetize toast messages used for displaying error or info messages.
Default is bottom
am start -a android.intent.action.VIEW -d https://appetize.io/
encoded as
am%20start%20-a%20android.intent.action.VIEW%20-d%20https%3A%2F%2Fappetize.io%2F
Executes an adb shell
command on the device.
true, false
When true, disables the on-screen keyboard.
Default is false
latitude, longitude, e.g. 39.903924,116.391432
Specifies the simulated location of the device.
https://www.appetize.io
encoded as https%3A%2F%2Fwww.appetize.io
Specifies a deep link to open when the app is launched.
["apple", "banana", "pear"]
encoded as
%5B%22apple%22%2C%20%22banana%22%2C%20%22pear%22%5D
Specifies a URL-encoded JSON array of strings to pass when launching the app.
encoded as
http%3A%2F%2Fexample.com%3A8080%2F
For Appetize's intercepting proxy, use intercept
.
Specifies a proxy server to route network traffic.
Note: Our current support is limited to HTTP Proxies. When your app makes HTTPS connections, the data remains encrypted despite the unencrypted connection to the proxy. The app sends a CONNECT request to the proxy for the destination HTTPS server, initiating an SSL handshake. The proxy acts as a TCP connection forwarder, ensuring end-to-end encryption for app data.
true,false
Enables audio output on the Appetize device. Note: This feature is currently in Alpha and might not always work as expected.
true, false
Allows installation of additional APKs after app launch.
Default is false
true, false
Reset or reinitialize aspects of the Google Messaging Service.
Default is false
us
,eu
Ensures that Appetize sessions are launched only from servers in a specific region.
Note: It is best to avoid setting this property unless absolutely necessary. Our system automatically directs requests to the closest servers for optimal performance. Using this property could lead to longer queues in busy regions.
light, dark
Applies the theme's appearance to the device.
Default is light
Last updated