--- title: Import Tag(s) Wizard slug: solutions/import-tags-wizard docTags: createdAt: 2025-08-15T11:29:12.872Z --- The Import Tag(s) Wizard allows users to search for Tag(s) defined for DeviceHub devices on a Litmus Edge and select which on these Tag(s) they want to import the Tag settings into the Tag Management tool. # Open the Import Tag(s) Wizard To open the Import Tag(s) Wizard, press the **Import Tag(s)** button from the **LitmusConfiguration **Ribbon. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/UdidUfcYYMIyzvyUz_UVm_image.png" size="80" width="391" height="156" position="center" showCaption="false"} :::hint{type="info"} **Notes**: To open the Import Tag(s) Wizard, the tool will verify that it is **not** in the Status: - Offline - DeviceHub not responding - No LE Set - No API Key If the Tool found to be in one of these states, a message is displayed. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/C6mqw5arIVTwfZifgdGi7_image.png" size="60" width="401" height="169" position="center" showCaption="false"} ::: # Setting up the Search Filter To search for DeviceHub devices, the user can setup a filter to apply to the search. This allows them to reduce the list for potentially imports to only the devices they are truly interested in. ## Select the LE Device IP ### Tool set to One LE If the tool is set to **Connect To** *One LE*, the user will not be able to change or select the LE Device IP. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/CxrtE-dukKxt9qmd1H38S_image.png" size="70" width="438" height="300" position="center" showCaption="false"} ### Tool set to Multiple LE If the tool is set to **Connect To** *Multiple LE,* the user can select which Litmus Edge to search for, provided that more than one **Target Litmus Edge IP** has been defined. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/VJE3-In4NCWncwV_1I1wU_image.png" size="80" width="1089" height="538" position="center" showCaption="false"} Additionally users can also enter a Litmus Edge IPv4 which is not yet present in the sheet The tool will check if it does have an API Key for the Litmus Edge IPv4 address. If no API Key is found, it will notify the user and request the API Key. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/gbmPPoaK7RmXzzHQNeopN_image.png" size="80" width="796" height="448" position="center" showCaption="false"} Press the **Yes** Button, provide the API Key and press the **Save **Button. ::Image[]{src="https://api.archbee.com/api/optimize/YJwzcjEno45QiDGu6Z815-I6qE4FU5i2QsjmbczYRk8-20250820-143009.png" size="80" width="759" height="542" position="center" showCaption="false"} ## Set Search Option The tool provides a number of Filter Options the user can select from. The include: - **ALL**: Do not apply any filter and return all tag(s) defined in DeviceHub on the selected Litmus Edge - **EQUAL TO**: Select all Tag(s) whith a Tag Name equal to my [Tag Name Mask](docId\:ruSqrggFFRw5fgW-jv0hw). - **NOT** **EQUAL TO**: Select all Tag(s) whith a Tag Name not equal to my [Tag Name Mask](docId\:ruSqrggFFRw5fgW-jv0hw). - **CONTAINS**: Select all Tag(s) where the Tag Name contains the value from my [Tag Name Mask](docId\:ruSqrggFFRw5fgW-jv0hw). - **DOES NOT CONTAIN**: Select all Tag(s) where the Tag Name does not contain the value from my [Tag Name Mask](docId\:ruSqrggFFRw5fgW-jv0hw). - **BEGINS WITH**: Select all Tag(s) where the Tag Name begins with the value from my [Tag Name Mask](docId\:ruSqrggFFRw5fgW-jv0hw). - **ENDS WITH**: Select all Tag(s) where the Tag Name ends with the value from my [Tag Name Mask](docId\:ruSqrggFFRw5fgW-jv0hw). ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/LHDI0Ut7tRGEGQO_ULUbH_image.png" size="70" width="758" height="383" position="center" showCaption="false"} :::hint{type="info"} **Notes**: All** Search Options** except *ALL*, require a value for the [Tag Name Mask](docId\:ruSqrggFFRw5fgW-jv0hw). ::: ## Define the Tag Name Mask For any **Search Option** except *ALL*, a mask is required to apply to the Tag Name. Example: Selected **Search Option** set to *EQUAL TO* and **Tag Name Mask** set to *Tag1* ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/sJGJTxA8ABEtftPt-eR2N_image.png" size="80" width="855" height="385" position="center" showCaption="false"} ## Define the DeviceHub Devices Select if you want to search for Tag(s) only on a specific DeviceHub Device or over all (field is empty) Device(s). ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/NCH0p4gCbfvf0ACm9jmIB_image.png" size="80" width="888" height="586" position="center" showCaption="false"} :::hint{type="warning"} **Important: ** If more than 50000 tags are defined on the selected Litmus Edge, a user can only search for tags for one single DeviceHub device. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/V4cDkdlVUjVV-ylXsa1qy_image.png" size="80" width="695" height="206" position="center" showCaption="false"} ::: The Import Wizard will show what Filter will be applied. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/uhoim6C5Sfrlp6pPryf8P_image.png" size="80" width="873" height="564" position="center" showCaption="false"} ## Initiate the Search If all settings are correctly set, the **Search **Button will be set to green and allows to initiate the search. To initiate the search press the green **Search** button. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/o2P3k6d1y5M2eD5MRjKC8_image.png" size="80" width="899" height="782" position="center" showCaption="false"} :::hint{type="info"} **Notes**: If the Filter is invalid, the Search button will be grayed out and can not be used. Example: No **Tag Name Mask** has been defined for the **Search Option ***EQUAL TO* ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/c2t_eA_YPsIJd2bI2AIL7_image.png" size="80" width="871" height="713" position="center" showCaption="false"} ::: # Importing Tag(s) After the Search has been initiated, the results are shown in a List Box. The Userr will see the **Device Name **as well as the **Tag** **Name**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/3fDnbkaju6zXtcjFHxqcT_image.png" size="80" width="874" height="782" position="center" showCaption="false"} :::hint{type="info"} **Notes**: In case a Filter returned no Tag(s), the user is informed and can initiate a new Search. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/5CP784e0U_blaK1V-2AtA_image.png" size="80" width="885" height="694" position="center" showCaption="false"} ::: ## Selecting all Tags To select all Tags for Import, check the Checkbox of the Header Row. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/CxnoBZf5cZtV5jY-IP65s_image.png" size="70" width="878" height="393" position="center" showCaption="false"} ## Unselecting all Tags To unselect all Tags for Import, uncheck the Checkbox of the Header Row. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/CJC_qYgPWNi07pNIJAwKd_image.png" size="70" width="871" height="385" position="center" showCaption="false"} ## Select individual Tag(s) To select individual Tag(s) for Import, check their respective Row or Checkbox. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/NlXUFfLtqGSCIrVc3gO1V_image.png" size="70" width="878" height="390" position="center" showCaption="false"} ## Unselect individual Tag(s) To unselect individual Tag(s) for Import, uncheck their respective Checkbox or Row. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/VYzPyCxt_tF_sFPDLMnRG_image.png" size="70" width="878" height="392" position="center" showCaption="false"} ## Import Tag(s) If at least one Tag has been selected from the list, the Import button will change to green and an Import can be initiated. To initiate an Import press the green **Import **button. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/TA3aqNEsquIuwLaFKdwhd_image.png" size="80" width="883" height="702" position="center" showCaption="false"} If no Tag(s) have been selected, the Import button will be greyed out. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/6axlX5D2yCclpEiKO51xJ_image.png" size="80" width="883" height="700" position="center" showCaption="false"} :::hint{type="info"} **Notes**: The Import wizard will show how many tag(s) have been selected in the left lower corner. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/k3eittxKmRsLUcuV2oYFJ_image.png" size="70" width="366" height="606" position="center" showCaption="false"} ::: ## After an Import finished Once all the selected Tag(s) have been imported, the user is informed about the result and has three further options: 1. **Close **the Wizard. This will end the import and the user can proceed with their desired actions on the sheet. 2. Set up a new [Search Filter](docId\:ruSqrggFFRw5fgW-jv0hw) to execute a **New Search.** 3. [Select further Tag(s)](docId\:ruSqrggFFRw5fgW-jv0hw) from the list they previously hadn't selected for another **Import**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/fF20xiCBgA6G83nMnkUNW_image.png" size="80" width="890" height="755" position="center" showCaption="false"}