---
title: Add an Instance
slug: bhdo/add-an-instance
createdAt: 2022-09-08T19:10:59.000Z
---

:::hint{type="info"}
**Note**: The Digital Twins feature is available for Belden Horizon Data Operations version 3.5.2 and later.
:::

You can add a Digital Twins Instance by navigating to **Digital Twins&#x20;**>**&#x20;Instances**.&#x20;

Instances are inherited from a model. They are the actual data objects that contain static and dynamic data from different sources. You must create a model before creating an instance.

# Before You Begin

Before you add an Instance, you will need to create a Digital Twins Model. See [Create and Import Models](https://public-docs.litmus.io/bhdo/create-and-import-models) for details.&#x20;

# Step 1: Add Instance

**To add an instance:**

1. Navigate to **Digital Twins&#x20;**> **Instances**.
   The *Instances&#x20;*&#x70;ane appears.
2. From the *Instances&#x20;*&#x70;ane, click the **Add an instance** tile.&#x20;
   Th&#x65;*&#x20;Add an Instance* dialog box appears.

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/-WlV6uORPMdQEqaoHRKG4_add-instance.png" size="80" width="1089" height="551" caption="Add an instance tile" position="center" showCaption="true"}
3. Select a model to associate with the instance. Either search for a model or select one from the list.

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/VGvExxbjyvHwMjbvQMJfO_add-instance-dialog.png" size="70" width="558" height="384" position="center" showCaption="false"}
4. Enter the details for the Instance.&#x20;
   - **Name**
   - **Interval**: The minimum interval allowed is one second.&#x20;
   - **Topic**: A default topic name is generated, but you have the option of entering a custom topic name.&#x20;
   - **Flatten hierarchy**: Select the check box to send hierarchy data in a flat JSON structure. When selected, it will take a nested JSON object and convert it into a JSON object with one layer using dot notation. This is useful when sending JSON objects to Influxdb, because Influxdb does not accept nested JSON objects.
5. Click **Add**.&#x20;

# Step 2: Configure Instance

After creating the instance, you can customize the model parameters it is associated with.&#x20;

Click the Instance tile (grid view) or Instance name (table view) to view the instance details.&#x20;

## Static Attributes

The *Static Attributes* tab displays the metadata values for the model the instance belongs to. You can customize the attribute values for the instance.&#x20;



::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/vN0nQTXf1ZeuLcBEJJm9H_image.png" size="80" width="1089" height="625" caption="Static Attributes tab" position="center" showCaption="true"}

\[1] Search for static attributes configured in the model the instance is associated with

\[2] Save all updated attribute values

\[3] Refresh attribute values

\[4] You have the option of adding topics from different data sources in Litmus Edge, such as from DeviceHub or from an integration. Click the **Topic search** icon, select the appropriate device in the **Device name** drop-down list, and then select the corresponding topic name in the **Topic&#x20;**&#x66;ield.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/QsfKJMtOX4tdIoxDVLSLN_image.png" size="50" width="405" height="251" caption="Topic search icon" position="center" showCaption="true"}

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/xec7uPsvMKQwr32jj8rhn_image.png" size="80" width="809" height="279" caption="Search topics dialog box" position="center" showCaption="true"}

&#x20;\[5] Save updated attribute value for individual attribute

## Dynamic Attributes

The *Dynamic Attributes* tab displays the variable data attributes configured in the model the instance belongs to. You can map one-to-one relationships with data topics and attributes by updating the topic field for the instance.&#x20;

:::hint{type="warning"}
**Important**: To view data from a topic in the instance payload, you must map the topic to a dynamic attribute.&#x20;
:::

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/txFmynYS0pYQQKZQkq00s_image.png" size="80" width="1197" height="625" caption="Dynamic Attributes tab" position="center" showCaption="true"}

\[1] Search for dynamic attributes in the model the instance is associated with.&#x20;

\[2] Save all updated topic values.&#x20;

\[3] Refresh attribute values.&#x20;

\[4] You have the option of adding topics from different data sources in Belden Horizon Data Operations, such as from DeviceHub or from an integration. For example, navigate to **DeviceHub&#x20;**> **Tags**, copy a raw topic for a device, and then paste the topic in instance **Topic&#x20;**&#x66;ield.

\[5] Save updates to the dynamic attribute.&#x20;

## Data Access

The *Data Access* tab allows you to view real-time data for the instance.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ZHtGNtpZJkTHWMYRF1uHj_image.png" size="80" width="1197" height="625" caption="Data Access tab" position="center" showCaption="true"}

\[1] Review the topic name and interval configured for the instance. Click the **Copy&#x20;**&#x69;con to copy the topic name.&#x20;

\[2] Subscribe and unsubscribe for data access to view real-time data for the instance.&#x20;

