---
title: Optional Settings Wizard
slug: solutions/optional-settings-wizard
docTags: 
createdAt: 2025-08-15T14:08:59.332Z
---

Drivers can have optional settings to change certain behaviours like publishing behaviour or adding a Watchdog.

To assist with the definition of these Optional Settings and ensure that the JSON Object is correctly formatted and includes all required entries, the Device Management Tool provides a Optional Settings Wizard.

# Access the Status Register Wizard

:::hint{type="info"}
**Notes**:

To access the Optional Settings Wizard it is required that:

- The entry in Column **Optional Settings **is not empty. -> The tool should automatically set the default Optional Settigns JSON Object in this case.
- A **Device Name** is defined
- A **Driver Name** is selected
- A **Driver Group Name** is selected
:::

Select the respective cell in Column **Optional Settings** for the Device you want to change Optional Settings.

If all conditions are met, the **Optional Settings Wizard** button is shown in the Help section of the **LitmusConfiguration **ribbon.

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/C88fgtsfaGWtojJsKr7S4_image.png)

Open the Optional Settings Wizard by pressing the **Optional Settings Wizard** button.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/j-zA246WmuEPBEWt4MStT_image.png" size="60" width="312" height="166" position="center" showCaption="false"}

The Optional Settings wizard will show.

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/aZI_yirCzGEdelfN8XQEI_image.png)

# Edit a Optional Settings

Select the Optional Setting you want to edit to open its **Edit **screen.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/FjHFMCPRq0LW75BMcg_4B_image.png" size="80" width="1003" height="641" position="center" showCaption="false"}

Edit the **Value **and press the **Modify **button.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/HhbgYGKXuFS9uM_kQqkUk_image.png" size="80" width="999" height="638" position="center" showCaption="false"}

:::hint{type="info"}
**Notes**:

If not both Name and Value are provided, the **Modify **button will remain grayed out and the property can not be saved.

The wizard also performs a verification for each entry and will show any violation in red. In this case the **Modify** button will also be grayed out to prevent the saving of any invalid Optional Settings.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/gzGfX950iyZF5IdbjpMoM_image.png" size="80" width="1005" height="596" position="center" showCaption="false"}
:::

:::hint{type="info"}
**Notes**:

Some Drivers can reqire additional Optional Settings based on what is select.

Example: The users changes the **WatchDog** setting to true.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/i08dbnFUJpdYDNNBVq6FT_image.png" size="80" width="993" height="574" position="center" showCaption="false"}

Which adds additional settings which the user can set.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/7tiRQw_oGUb_sZxhtkN6S_image.png" size="80" width="745" height="309" position="center" showCaption="false"}
:::

# Save the Optional Settings

To save all the Optional Settings as a new Optional Settings JSON Object, press the **Save **button.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/BzliMyWTqriXiEv8uJCaV_image.png" size="80" width="995" height="637" position="center" showCaption="false"}

This will create the correctly formatted Optional Settings JSON Object and store it in column **Optional Settings** for the device.

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/arknZOcsXA_gKpuQYIvDh_image.png)

:::hint{type="warning"}
**Important: **This will overwrite the current value in column **Optional Settings**.
:::

# Cancel the Optional Settings Wizard

If a user decides to not save the current Optional Settings Wizard configuration, they can press the **Cancel **button.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/4DWqXNVgt3kOURTMtQhkX_image.png" size="80" width="1233" height="693" position="center" showCaption="false"}

:::hint{type="info"}
**Notes**:

This will not overwrite the  current value in column **Optional Settings**.
:::