--- title: Add Topics to Connectors slug: litmusedge/product-features/integration/add-topics-to-connectors description: You have several options to add topics to integration connectors. docTags: createdAt: 2023-12-14T15:24:53.762Z --- After adding a connector, you can now add topics to it. You have several options for adding topics to connectors. :::hint{type="info"} **Notes**: - You can now only define local or remote topics without any spaces or special characters across all connectors. ::: # Video :::Iframe{iframeHeight="0" code=""} ::: # 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\:pal6ABPZbrimdU9LvGJ30) and [Add Tags](docId\:XgWOkQbTPevII7OR82LL0) 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 **icon and select **Add a new subscription**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/x6iO_2rGLqGRY-yhkbjFl_add-a-new-subscription.png" size="100" width="1173" height="522" position="center" caption="Add icon" darkWidth="1173" darkHeight="522" showCaption="true" indent="2"} 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 import tags from DeviceHub, Digital Twins, and Analytics, and convert them into 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 topics **icon. The *Manage Data Import* dialog box displays. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/EwB6F7DQ44lPzYqgte5FQ_import-tags.png" size="100" width="1173" height="465" position="center" caption="Import from DeviceHub tags icon" darkWidth="1173" darkHeight="465" showCaption="true" indent="2"} 4. In the *Select the source *pane, use the drop-down menu to choose the source of topics. Options include *DeviceHub*, *Digital Twins*, *Analytics* ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/AQt4BFTRvDm0lI4i03sgz_image.png" size="100" width="1108" height="282" position="center" caption="Manage Data Import dialog box " darkWidth="1108" darkHeight="282" showCaption="true" indent="2"} 5. Select the checkbox for individual devices to import all the tags for that device and select **Choose Topics**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/J-N6ah69fAOKrBc-sl98t_image.png" size="100" width="1429" height="396" position="center" caption="Manage Data Import dialog box " darkWidth="1429" darkHeight="396" showCaption="true" indent="2"} 6. Select the checkbox for *Name *to choose tags from all selected devices. Then click **Next**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/nryWxdXwz7ATByzNbUsuB_image.png" size="100" width="1413" height="558" position="center" caption="Manage Data Import dialog box " darkWidth="1413" darkHeight="558" showCaption="true" indent="2"} 7. On the *Review Selection *page, confirm the imported topics from *DeviceHub*, *Digital* *Twins*, and *Analytics *for their respective devices and tags. 8. When done reviewing tags, click **Import**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/9cccoBI4jw2n6eZrdE5uV_image.png" size="100" width="1433" height="573" position="center" caption="Manage Data Import dialog box " darkWidth="1433" darkHeight="573" showCaption="true" indent="2"} # Use CSV File You can upload a CSV file of topics and automatically add them to the connector. ## 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**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/B0bD-FMYBshLZB0R5faKW_image.png" size="80" width="1196" height="470" position="center" caption="Download a sample option" darkWidth="1196" darkHeight="470" showCaption="true"} ## 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/OfbT-1-EMlVMirUmbfr98_image.png" size="60" width="375" height="351" position="center" caption="Instance Identifier field" darkWidth="375" darkHeight="351" 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/I7hQoNbJaaXAmw4zBY5ZX_image.png" size="60" width="375" height="351" position="center" caption="Instance Name parameter" darkWidth="375" darkHeight="351" 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 Litmus 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 Litmus 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 on how 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 - Amazon AWS IoT Core over SSL - MQTT - Azure IoT Hub using Device Certificates - MQTT - Azure IoT Hub using SAS Key - MQTT Generic - MQTT - Generic over SSL - MQTT - IBM Watson 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**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/p8lHlbuxkTlvxDeAnl37A_add-a-new-subscription.png" size="100" width="1173" height="522" position="flex-start" caption="Add icon" darkWidth="1173" darkHeight="522" showCaption="true" indent="2"} 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"}