---
title: Unified
slug: uns/unified
docTags: 
createdAt: 2025-02-24T18:41:24.709Z
---

The **Unified** feature in *Litmus UNS&#x20;*&#x70;rovides a dynamically generated hierarchical tree of topics that reflects data organization rules that you defined in the [Configure](docId\:YN8KoFiKglVkfsA6Z6qDh) section.&#x20;

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/mXeqW0PtiE-V6DBf4ErfD_image.png)

On *Unified&#x20;*&#x70;age, you can:

- Filter the hierarchy tree to quickly find relevant topics
- Automatically generate and display a unified data hierarchy
- Manage MQTT account permissions (ACL) for specific topics
- Bridge selected topics to external connectors or integrations
- View real-time topic or subtopic data through the MQTT Client tool
- Manually add new MQTT account permissions
- Remove unwanted topics and their child nodes

# Before You Begin

- Ensure you have a running instance of Litmus UNS and have access to its web interface.&#x20;
- Ensure the hierarchy tree is generated based on rules defined in the [Configure](docId\:YN8KoFiKglVkfsA6Z6qDh) section. Confirm these configurations are set appropriately.&#x20;
- If you plan to add or modify MQTT permissions, make sure you have at least one MQTT account configured.&#x20;

# Access the Unified UI&#x20;

1. Log in to the *UNS&#x20;*&#x70;latform and navigate to the **Explore&#x20;**&#x73;ection.&#x20;
2. From the top of the *Explore&#x20;*&#x70;age, select the **Unified&#x20;**&#x74;ab.

Here you can filter and navigate the tree hierarchy, modify permissions for a topic, bridge a topic to an external connector or integration, and perform additional action on a selected topic.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/1r_j7hXDAvhyTqh6NS_Ok_image.png" size="80" width="1717" height="799" position="flex-start" caption="Unified tab Web UI" showCaption="true"}

| **UI Element**          | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| \[1] **UNS Structure**  | Filter the tree based on a string search. Enter text to filter topics where `topic.contains(searchString)`. Clear text to reset the filter.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| \[2] **Hierarchy Tree** | Displays topics in a structured tree that reflects UNS categorization rules. Expand and collapse nodes to navigate subtopics. Click a node to select it.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| \[3] **Add Permission** | Add or edit MQTT ACL rules for the selected topic. Open the *Add permission&#x20;*&#x64;ialog box to specify the topic string, MQTT account, and permissions (Subscribe, Publish, Both, or Deny).<br />::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/9h3UCedVzSVluPiyJHLyk_image.png" size="40" width="380" height="381" position="flex-start" showCaption="false"}                                                                                                                                                                                                                                                                                            |
| \[4] **Add Bridge**     | Configure an external connector or integration for the selected topic. Specify connector details (for example, endpoint or credentials) and validate bridging topic strings. Open the *Add Bridge* dialog from the **Action Menu**.<br />::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/j55XaT6RB2IoFJosupNZ5_image.png" size="40" width="414" height="440" position="flex-start" showCaption="false"}                                                                                                                                                                                                                                                          |
| \[5] **Action**         | Select a specific topic in the tree and open the *Action* menu.<br />::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/gUBT7iPsPZ6jUdENR7JGz_image.png" size="32" width="229" height="305" position="flex-start" showCaption="false"}<br />Action menu options:<br />* **Add new rule:** Add a MQTT ACL rules for the selected topic.
* **Add Bridge**: Configure bridging settings for external integrations.
* **View topic data**: Open the MQTT Client with the selected topic as subscription.
* **View subtopic data:** Opens the MQTT Client with topic + “#” as subscription
* **Remove**: Remove the selected topic and its children, after confirmation. |

