---
title: Add Topics to Connectors
slug: manufacturing-connect-edge-v1/add-topics-to-connectors
docTags: 
createdAt: 2023-11-20T19:23:41.687Z
---

After adding a connector, you can now add topics to it. 

You have several options for adding topics to connectors. 

:::hint{type="info"}
**Note**: If you add topic to a `CONNECTED` connector, the connector will need to restart. 
:::

# Add Individual Topics

You can add Outbound (Local to Remote) and Inbound (Remote to Local) topics to connectors. 

## Before You Begin

If you are adding individual outbound topics, you will need to connect the DeviceHub device and tags that will be used to create the topics. See [Connect a Device](docId\:RFVIJdxz7DBAd8mwbismA) and [Add Tags](docId\:iOaNZd2AwqnkuppgeE3Eh) to learn more. 

**To add a topic to a connector:**

1. From the *Integration *pane, click the connector tile you want to add the topic to. 
2. Click the **Topics **tab.
3. Click the **Add a new subscription **icon. The *Data Integration* dialog box appears.
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/Q4AqESe0B5eyGu0C6a29-_addconnectortopic.png" size="80" width="1288" height="486" caption="Add new subscription icon" position="center" showCaption="true"}
4. Select a data direction from the *Data Direction* drop-down list. 
   - **Local to Remote - Inbound**
   - **Remote to Local - Outbound**
5. In the **Local Data Topic** field, paste the *Raw Topic *for the tag or click the search icon and select the appropriate DeviceHub device and tag. 
6. The **Remote Data Topic** field may have a default value for the *Integration topic* parameter of the connector. If the field is blank,  enter the remote data topic name.  
7. Enter a short description in the **Description** field.
8. (If available) From the **Qos** dropdown menu, select a [Quality of Service](https://www.hivemq.com/blog/mqtt-essentials-part-6-mqtt-quality-of-service-levels/) value .
   Available values: `default`, `0`, `1`, `2`
9. Click the **Enable** toggle to enable the connection.
10. Click **OK**.
    If the connector is CONNECTED, the *Confirmation *dialog box appears.
11. Click **Yes**. Follow the prompt to restart the connector.
    The new topic appears on the Topics pane and is enabled.

# Import Tags from DeviceHub

You can automatically import tags from a device in DeviceHub and convert them to topics. 

**To import tags from DeviceHub:**

1. From the *Integration *pane, click the connector tile you want to add the topic to. 
2. Click the **Topics **tab. 
3. Click the** Import from DeviceHub tags** icon. 
   The *DeviceHub Import* dialog box displays.
   ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/qp_bVBmfuzr4_d-u9Nvrr_importfromdevicehubmce.png "Import from DeviceHub tags icon")
4. Select the checkbox for individual devices to import all the tags for that device. Alternatively, select the checkbox for **Raw / Alias** to select tags from all DeviceHub devices. 
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ViHX1vb3PmbvR9tlPjhaD_devicehubimportdialogmce.png" size="70" width="618" height="377" position="center" caption="DeviceHub Import dialog box" showCaption="true"}
5. When done select tags to import, click **Yes, proceed with import**. 

# Use CSV File

You can upload a CSV file of topics and automatically add them to the connector. 

:::hint{type="info"}
**Note**: This option is available for Manufacturing Connect Edge version 3.10.0 and later. 
:::

## Step 1: Download Sample CSV File

You will first need to download the sample file that will be used to upload the topics to add to the connector. 

To download the sample file:

1. From the *Integration *pane, click the connector tile you want to add the topic to. 
2. Click the **Topics **tab. 
3. Click the **Download **icon and select **Download a sample**. 

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/appnHd77EIkLQQzVMqrct_image.png "Download icon")

## Step 2: Create CSV File

After downloading the file, use the template to enter all the topics that will be added to the connector. 

### Required Parameters

:::hint{type="warning"}
**Important**: Review the following for configuring the Instance ID and Instance Name for the CSV file: 

- If the Instance ID and Instance Name aren't configured correctly, the entire CSV file will be rejected and no topics will be uploaded. 
- If the Instance ID isn't configured correctly but the Instance Name is configured correctly, the appropriate Instance ID will be retrieved from the associated Instance Name and the CSV file will upload topics successfully to the retrieved Instance ID. 
:::

You must enter data for the following parameters:

- **Instance ID**: This field must be entered correctly. See the *Important *note above. Retrieve this parameter by copying the Instance Identifier field from the connector tile. 

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/LKWsWBjB7-jm7jIvPi960_image.png" size="60" width="429" height="282" position="center" caption="Instance Identifier field" showCaption="true"}

- **Instance Name**: See the *Important *note above. Retrieve this parameter from the name configured for the connector. 

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/opodsJznINngbiF4l0H0j_image.png" size="60" width="429" height="282" position="center" caption="Instance Name parameter" showCaption="true"}

- **Direction**: Enter one of the following based on the direction of data for the topic: `Inbound` or `Outbound`. 
- **Local Remote Topic**: If the topic is `Outbound`, you will need to define the topic that will be sending the data our of Manufacturing Connect Edge. Enter the local topic name or click the copy icon for the topic name from **DeviceHub **> **Tags**. If the topic is `Inbound`, you can leave the field blank. 
- **Remote Data Topic**: If the topic is `Inbound`, you will need to define the topic that will be used to pull data into Manufacturing Connect Edge. Enter the name of the remote data topic. If the topic is `Outbound`, you can leave the field blank. 
- **Enable**: You must enter one of the following statuses depending if you want the topic enabled: `True` or `False`. 
- **QoS**: Only required for the following connectors. Enter one of the following values: `default`, `0`, `1`, `2`. 
  - MQTT Generic
  - MQTT - Generic over SSL
  - MQTT - System Protobuf SSL
  - MQTT - System Protobuf TCP

### Optional Parameters

The *Description *field is optional and can be left empty. 

Once you update the template CSV file, you can upload it.  

## Step 3: Upload CSV File

**To upload the CSV file: **

1. From the *Integration *pane, click the connector tile you want to add the topic to. 
2. Click the **Topics **tab. 
3. Click the **Add **icon and select **Upload CSV**. 
   ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/7C7z6RK3QM7RyIDzaIRZe_uploadcsviconmce.png "Add icon")
4. Select the file and click **Open**. 

## CSV File Example

Refer to the following CSV file example that includes one inbound topic and one outbound topic. 

::File{src="https://api.archbee.com/api/presign/SSUUxKZUk9bFTEPNn_6Zo/xAi8XNzUpmexqedYIA6DZ_csvfileexample.csv" label="CSV_File_Example.csv"}