Get your setup working faster. Join our Discord for optimisation tips from elite testers.
Join our Discord
SIM enabled devices
This feature is available only under Desktop and Mobile Pro, and Enterprise Pro plans. For more details, check out our pricing page .
Currently, eSIMs are supported on iPhone 13 and iPhone 14 devices only.
To use this feature on dedicated devices, refer to the Custom Device Lab documentation.
BrowserStack Automate provides access to SIM-equipped devices and enables you to test SIM-related use cases such as:
Receiving SMS on the allocated device during your test session.
Composing and sending SMS from the allocated device during your test session.
In this guide, you will learn about:
Supported OS and devices
OS Version Supported Devices
Android 16
Samsung Galaxy S26
Android 15
Samsung Galaxy S25
Android 14
Samsung Galaxy S24 Ultra
Android 13
Samsung Galaxy S23 Ultra
Android 12
Samsung Galaxy S22 Ultra
OS Version Supported Devices
iOS 26
iPhone 17
iOS 18
iPhone 16 Pro
iOS 17
iPhone 15 Pro
iOS 16
iPhone 14 Pro Max
iOS 15
iPhone 13 Pro Max
iOS 14
iPhone 12 Pro
iOS 13
iPhone 11
Obtain a SIM enabled device
Use the following capability in your test scripts to obtain a device with SIM.
To enable sim options for Android devices use the following code examples:
If you are using BrowserStack SDK, you can set the following capability within the browserstack.yml file:
Capability
Description
enableSimSet this capability to "true" to obtain a device with SIM.
simOptionsSet the configuration “region” to the below mentioned country name to obtain a SIM device for that country. Australia, India, USA Australia, India, Ireland, USA.
The esim capability is not supported for Android devices.
Example:
```yml
platforms:
- platformName: android
deviceName: Samsung Galaxy S22 Ultra
platformVersion: '12.0'
enableSim: true
simOptions:
region: USA
```
Copy icon
Copy
BrowserStack SDK is a plug-n-play solution that takes care of all the integration steps for you. Using the BrowserStack SDK is the recommended integration method for your project. To know more, visit the SDK core concepts page .
Capability
Description
enableSimSet this capability to "true" to obtain a device with SIM.
simOptionsSet the configuration “region” to the below mentioned country name to obtain a SIM device for that country. Australia, India, USA Australia, India, Ireland, USA.
DesiredCapabilities capabilities = new DesiredCapabilities ();
HashMap < String , Object > browserstackOptions = new HashMap < String , Object >();
browserstackOptions . put ( "enableSim" , "true" );
HashMap < String , String > simOptions = new HashMap < String , String >();
simOptions . put ( "region" , "USA" );
browserstackOptions . put ( "simOptions" , simOptions );
capabilities . setCapability ( "bstack:options" , browserstackOptions );
capabilities . setCapability ( "platformName" , "android" );
capabilities . setCapability ( "platformVersion" , "12.0" );
capabilities . setCapability ( "deviceName" , "Google Pixel 6" );
var capabilities = {
" platformName " : " android " ,
" appium:platformVersion " : " 12.0 " ,
" appium:deviceName " : " Google Pixel 6 " ,
' bstack:options ' : {
" enableSim " : " true " ,
" simOptions " : {
" region " : " USA " ,
}
}
}
AppiumOptions capabilities = new AppiumOptions ();
capabilities . AddAdditionalCapability ( "osVersion" , "12.0" );
capabilities . AddAdditionalCapability ( "deviceName" , "Google Pixel 6" );
Dictionary < string , object > browserstackOptions = new Dictionary < string , object >();
browserstackOptions . Add ( "enableSim" , "true" );
Dictionary < string , string > simOptions = new Dictionary < string , string >();
simOptions . Add ( "region" , "USA" );
browserstackOptions . Add ( "simOptions" , simOptions );
capabilities . AddAdditionalCapability ( "bstack:options" , browserstackOptions );
capabilities . AddAdditionalCapability ( "platformName" , "android" );
capabilities . AddAdditionalCapability ( "platformVersion" , "12.0" );
capabilities . AddAdditionalCapability ( "appium:deviceName" , "Google Pixel 6" );
desired_cap = {
'bstack:options' : {
"platformName" : "android" ,
"platformVersion" : "12.0" ,
"deviceName" : "Google Pixel 6" ,
'enableSim' : true ,
'simOptions' : {
"region" : "India" ,
}
}
}
capabilities = {
'bstack:options' => {
"osVersion" => "12.0" ,
"deviceName" => "Google Pixel 6" ,
'enableSim' : true ,
'simOptions' : {
"region" : "India" ,
}
}
}
Capability
Description
browserstack.enableSimSet this capability to "true" to obtain a device with SIM.
browserstack.simOptionsSet the configuration “region” to the below mentioned country name to obtain a SIM device for that country. Australia, India, USA Australia, India, Ireland, USA esim to true to enable esim option for the device.
DesiredCapabilities desiredcapabilities = new DesiredCapabilities ();
desiredCapabilities . setCapability ( "os_version" , "12.0" );
desiredCapabilities . setCapability ( "device" , "Google Pixel 6" );
desiredCapabilities . setCapability ( "browserstack.enableSim" , "true" );
HashMap < String , String > simOptions = new HashMap < String , String >();
simOptions . put ( "region" , "USA" );
desiredCapabilities . setCapability ( "browserstack.simOptions" , simOptions );
var capabilities = {
" os_version " : " 12.0 " ,
" device " : " Google Pixel 6 " ,
" browserstack.enableSim " : " true " ,
" browserstack.simOptions " : {
" region " : " USA "
}
}
AppiumOptions capabilities = new AppiumOptions ();
capabilities . AddAdditionalCapability ( "os_version" , "12.0" );
capabilities . AddAdditionalCapability ( "device" , "Google Pixel 6" );
capabilities . AddAdditionalCapability ( "browserstack.enableSim" , "true" );
Dictionary < string , string > simOptions = new Dictionary < string , string >();
simOptions . Add ( "region" , "USA" );
capabilities . AddAdditionalCapability ( "browserstack.simOptions" , simOptions );
desired_cap = {
"os_version" : "12.0" ,
"device" : "Google Pixel 6" ,
"browserstack.enableSim" : "true"
"browserstack.simOptions" : {
"region" : "USA"
}
}
caps = Selenium :: WebDriver :: Remote :: Capabilities . new
caps [ "os_version" ] = "12.0"
caps [ "device" ] = "Google Pixel 6"
caps [ "browserstack.enableSim" ] = "true"
caps [ "browserstack.simOptions" ] = { "region" => "USA" }
To enable sim options for iOS devices use the following code examples:
If you are using BrowserStack SDK, you can set the following capability within the browserstack.yml file:
Capability
Description
enableSimSet this capability to "true" to obtain a device with SIM.
simOptionsSet the configuration “region” to the below mentioned country name to obtain a SIM device for that country. Australia, India, USA Australia, India, Ireland, USA esim to true to enable esim option for the device.
Example:
```yml
platforms:
- platformName: ios
deviceName: iPhone 14 Pro Max
platformVersion: '16'
enableSim: true
simOptions:
region: USA
esim: true
```
Copy icon
Copy
BrowserStack SDK is a plug-n-play solution that takes care of all the integration steps for you. Using the BrowserStack SDK is the recommended integration method for your project. To know more, visit the SDK core concepts page .
Capability
Description
enableSimSet this capability to "true" to obtain a device with SIM.
simOptionsSet the configuration “region” to the below mentioned country name to obtain a SIM device for that country. Australia, India, USA Australia, India, Ireland, USA esim to true to enable esim option for the device.
DesiredCapabilities capabilities = new DesiredCapabilities ();
HashMap < String , Object > browserstackOptions = new HashMap < String , Object >();
browserstackOptions . put ( "enableSim" , "true" );
HashMap < String , String > simOptions = new HashMap < String , String >();
simOptions . put ( "region" , "USA" );
simOptions . put ( "esim" , "true" );
browserstackOptions . put ( "simOptions" , simOptions );
capabilities . setCapability ( "bstack:options" , browserstackOptions );
capabilities . setCapability ( "platformName" , "ios" );
capabilities . setCapability ( "platformVersion" , "14.0" );
capabilities . setCapability ( "deviceName" , "iPhone 14" );
var capabilities = {
" platformName " : " ios " ,
" appium:platformVersion " : " 16.0 " ,
" appium:deviceName " : " iPhone 14 " ,
' bstack:options ' : {
" enableSim " : " true " ,
" simOptions " : {
" region " : " USA " ,
" esim " : " true "
}
}
}
AppiumOptions capabilities = new AppiumOptions ();
Dictionary < string , object > browserstackOptions = new Dictionary < string , object >();
browserstackOptions . Add ( "enableSim" , "true" );
Dictionary < string , string > simOptions = new Dictionary < string , string >();
simOptions . Add ( "region" , "USA" );
simOptions . Add ( "esim" , "true" );
browserstackOptions . Add ( "simOptions" , simOptions );
capabilities . AddAdditionalCapability ( "bstack:options" , browserstackOptions );
capabilities . AddAdditionalCapability ( "platformName" , "ios" );
capabilities . AddAdditionalCapability ( "platformVersion" , "14.0" );
capabilities . AddAdditionalCapability ( "appium:deviceName" , "iPhone 14" );
desired_cap = {
'bstack:options' : {
"platformName" : "ios" ,
"platformVersion" : "16.0" ,
"deviceName" : "iPhone 14" ,
"enableSim" : "true" ,
"simOptions" : {
"region" : "USA" ,
"esim" : "true"
}
}
}
capabilities = {
'bstack:options' : {
"platformName" : "ios" ,
"platformVersion" : "16.0" ,
"deviceName" : "iPhone 14" ,
"enableSim" : "true" ,
"simOptions" : {
"region" : "USA" ,
"esim" : "true"
}
}
}
Capability
Description
browserstack.enableSimSet this capability to "true" to obtain a device with SIM.
browserstack.simOptionsSet the configuration “region” to the below mentioned country name to obtain a SIM device for that country. Australia, India, USA Australia, India, Ireland, USA.
DesiredCapabilities desiredcapabilities = new DesiredCapabilities ();
desiredCapabilities . setCapability ( "os_version" , "16.0" );
desiredCapabilities . setCapability ( "device" , "iPhone 14" );
desiredCapabilities . setCapability ( "browserstack.enableSim" , "true" );
HashMap < String , String > simOptions = new HashMap < String , String >();
simOptions . put ( "region" , "USA" );
simOptions . put ( "esim" , "true" );
desiredCapabilities . setCapability ( "browserstack.simOptions" , simOptions );
var capabilities = {
" os_version " : " 16.0 " ,
" device " : " iPhone 14 " ,
" browserstack.enableSim " : " true " ,
" browserstack.simOptions " : {
" region " : " USA " ,
" esim " : " true "
}
}
AppiumOptions capabilities = new AppiumOptions ();
capabilities . AddAdditionalCapability ( "os_version" , "16.0" );
capabilities . AddAdditionalCapability ( "device" , "iPhone 14" );
capabilities . AddAdditionalCapability ( "browserstack.enableSim" , "true" );
Dictionary < string , string > simOptions = new Dictionary < string , string >();
simOptions . Add ( "region" , "USA" );
simOptions . Add ( "esim" , "true" );
capabilities . AddAdditionalCapability ( "browserstack.simOptions" , simOptions );
desired_cap = {
"os_version" : "16.0" ,
"device" : "iPhone 14" ,
"browserstack.enableSim" : "true"
"browserstack.simOptions" : {
"region" : "USA" ,
"esim" : "true"
}
}
caps = Selenium :: WebDriver :: Remote :: Capabilities . new
caps [ "os_version" ] = "16.0"
caps [ "device" ] = "iPhone 14"
caps [ "browserstack.enableSim" ] = "true"
caps [ "browserstack.simOptions" ] = { "region" => "USA" , "esim" => "true" }
Retrieve SIM properties of the allocated device
Use the following executor command in your test scripts to retrieve SIM properties of the allocated device such as the phone number and region during session run time:
driver . execute_script ( "browserstack_executor:{\"action\": \"deviceInfo\", \"arguments\" : \"deviceProperties\" : [" simOptions " ]})
await driver . execute ( " browserstack_executor: { \" action \" : \" deviceInfo \" , \" arguments \" : \" deviceProperties \" : [ " simOptions " ]})
(( IJavaScriptExecutor ) driver ). ExecuteScript ( "browserstack_executor: {\"action\": \"deviceInfo\", \"arguments\" : \"deviceProperties\" : [" simOptions "]});
driver . execute_script ( "browserstack_executor: { \" action \" : \" deviceInfo \" , \" arguments \" : { \" deviceProperties \" : [ \" simOptions \" ]}}" )
driver . execute_script ( "browserstack_executor: { \" action \" : \" deviceInfo \" , \" arguments \" : { \" deviceProperties \" : [ \" simOptions \" ]}}" )
Sample response :
{
“simOptions“ : { “Phone Number“:“XXXXX”, “Region“:”USA”, "esim" :true }
}
Check our list of various JavaScript Executors that BrowserStack offers.
Is this page helping you?
Thank you for your valuable feedback!
Join our Discord