Custom Properties

Custom Properties option allows admins to create one or multiple custom properties and assign values to those properties at Group Level/ Sub-Group Level/ Device Level. These custom properties and their values will be sent to the SureMDM Agent for the future use. 

To create Custom Properties, follow these steps:

1. Navigate to SureMDM Web Console > Settings > Account Settings > Device Properties > Properties > Custom Device Properties

2. Click on Add. 

3. Enter the following details to add the custom properties and click OK.

• Key: Enter the name of the custom property.

• Datatype: Select one of the data types from the following:

Type	Description
String	Values will be text only
Numbers	Values will be numbers only
Date	Values will be dates only
Boolean	Values will be true/false
Enum	The list of comma-separated values

• Platform: Select one of the platforms from the following. All, Android, Linux, macOS, iOS, WearOS and Windows

• Masked: This option is only available for the Linux platform. When enabled, the property values will be hidden by default and will require adequate permissions to access.

• Retrieve Value Using Script: Select this option to retrieve the value of the custom property using script.

• Script: Enter a script that will produce a single output, which will be used as the value for the custom property. This option is only available when the "Retrieve Value Using Script" checkbox is enabled.

• Execute in: Select the execution context for the script to run on the target device i.e. System Context and Currently Logged in User Account. This option is only available when Retrieve Value Using Script checkbox is enabled.

• Frequency to retrieve the value: Specify the frequency in minutes to run the script used while creating custom device property to retrieve the value.

note

This feature is available only for Linux, Windows, macOS and Android.

The newly created custom properties will be listed under Custom Properties section.

In the Key text field, admins can search for the following predefined custom properties and select them.

Device Property	Wildcards	Platform
wifi_ssid	String	Windows
cell_signal_strength	String	Windows
agentversion	String	Windows
imsi_id	String	Android
macaddress	String	All
simserialnumber	String	All
local_ipaddress	String	All
serial_number	String	All
device_name	String	All
device_id	String	Android
devicemodel	String	All
ipaddress	String	All
osversion	String	All
imei_2	String	Android
imei_1	String	Android
meid	String	Android
networkoperator	String	Android

Assign and Send Values to the Device at Group/Sub-Group Level

To assign values at the group/sub-group level, follow these steps:

1. Navigate to the SureMDM Console.

2. Select a Group/Sub-Group and click Properties. 

3. On the Device Properties Tab, select the created custom property and click Send to Device. Admins can also select the Device Property, and edit the values before sending it to the devices.

note

• The values of Default Device Properties will be pushed automatically to the devices and the values cannot be changed.
• The values for Masked Custom Properties will only be visible if the user has adequate permissions.

Custom Properties for the Approved Apps

Admins can add the required applications under the Approved Apps section to which SureMDM Agent shares the custom properties.

note

The custom properties can be shared with approved apps only if admins select Send to Device Agent when assigning values at the Group/Sub-group level.

To add the applications, follow these steps:

1. Navigate to SureMDM Web Console > Settings > Account Settings > Custom Properties > Approved Apps.

2. On the Approved Apps screen, click Add. 

3. Enter the App Name and Package Name. 

4. Enter the Signature Key Hash for the application.

5. Select the privacy policy and click Add. 

Approved applications will be listed in the data grid.

Group-Level Assignment of Script-Based Custom Properties

SureMDM allows administrators to manage Script-Based Custom Properties Assignment at the group level, providing control over their deployment. Instead of applying these properties globally to all devices, administrators can assign them to specific groups, ensuring that only the intended devices receive the configuration.

Create Script-Based Custom Properties and Viewing at the Group Level

Create Script-Based Custom Properties using the following steps:

1. Log in to SureMDM Console.

2. Navigate to Settings > Account Settings > Device Properties > Properties > Custom Device Properties.

3. Click Add.

4. In the Add Custom Properties dialog, select the platform.

5. Enter the Key and choose the Data Type.

6. Enable Retrieve Value Using Script.

7. Enter the script manually or import it using the Import option.

8. Set the frequency (in minutes) for data retrieval.

9. Click Save.

Once a Script-Based Custom Property is created, it becomes visible under: Group Properties > Device Properties

• The Property Type column will display “Custom Script” for script-based properties.
• From this section, properties can be assigned or unassigned for each group.

note

All existing Script-Based Custom Properties will remain assigned. However, newly created Script-Based Custom Properties will appear in the unassigned state by default.

Assigning and Unassigning Script-Based Custom Properties

Assign or unassign a Script-Based Custom Property using the following steps:

1. Log in to SureMDM Console.

2. Navigate to Group Properties > Device Properties.

3. Select the desired Script-Based Custom Property.

4. Depending on its assignment status:

   • If the property is unassigned, click Assign to apply it to the group.
   • If the property is assigned, click Unassign to remove it from the group.

note

When a Script-Based Custom Property is assigned to a parent group, it is automatically applied to all subgroups. Properties inherited from a parent group cannot be unassigned at the subgroup level.