# Pairing Modules

On this page, you will learn about **Module Pairing**, which is the process of matching the arrays defined in **HOLOPLOT Plan** with the actual HOLOPLOT Audio Modules in the real world.

This process is simplified with Neighbor Detection, which automatically detects neighboring modules within the same array in just a few seconds. This feature saves a significant amount of time, especially when dealing with large-scale venues.

Module Pairing supports obstructed arrays with S21 modules and includes visual improvements in HOLOPLOT Control to streamline finding, filtering, and pairing modules.

{% hint style="info" %}
Neighbor Detection is currently only available for X1 Audio Modules.
{% endhint %}

### Layout

<figure><img src="/files/eC3ekNKMYpulE5uCG028" alt=""><figcaption><p>Settings › Module Pairing</p></figcaption></figure>

1. **Unpaired modules**\
   This container shows the real-world HOLOPLOT Audio Modules detected in the venue or any physical space where the system is installed. This panel helps identify the module's position inside the array.
2. **Paired arrays and modules**\
   This container shows how the system was designed initially in **HOLOPLOT Plan**. It helps select the real-world module, which reflects the selected module's actual position.
3. **Viewport**\
   It shows the 3D representation of the system design. It provides a visual aid that displays all arrays and locations in the venue to help facilitate the pairing process.

### How to pair modules

<figure><img src="/files/BMuFrtT69n9QlZm2jpW2" alt=""><figcaption><p>How to pair and unpair Arrays / Modules</p></figcaption></figure>

1. On the navigation bar, click **Settings** › **Module Pairing**.
2. Select any module from the **Unpaired Modules** container. The LEDs on the real-world module will start blinking. Once it starts blinking, identify its position inside the real-world array.
3. In the **paired arrays and modules** container, select the module that matches the real-world module's position. Use **Pair Detected Array** for Neighbor Detection to pair all modules in the array. Alternatively, click **Pair Module** to pair individual modules within an array, without pairing the entire array.
4. Repeat steps 1 and 2 to pair the remaining arrays or modules.
5. To unpair modules, find the array in the **Paired Arrays** container and select the **Unpair Module** or **Unpair Array** buttons.

{% hint style="info" %}
Learn more about the array creation process in the system design stage in:[Broken mention](broken://spaces/lFtmImPSthvpNXrptroO/pages/Q4M1GMIwl2H4RyAKkIBx)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.holoplot.com/holoplot-control/configuring-the-system/pairing-modules.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.