> For the complete documentation index, see [llms.txt](https://gsfcorp.gitbook.io/macula/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gsfcorp.gitbook.io/macula/administration-guide-v1.33.0/visual-groups.md).

# Visual Groups

Device, channel and map groups are used solely for management and are only accessible in Macula Console.; in order to set up resource arrangement for Macula Monitor, **visual groups** are used. They allow custom grouping for C*hannels*, *Buttons*, *CrossLinks* and *Maps* displayed in the connected Macula Monitor applications. You can create single-level or **multi-level** (nested) visual groups by putting them inside one another. Nested visual groups will also appear in the *Resources* section of the Macula Monitor application.

{% hint style="danger" %}
Single Visual Group can be used simultaneously for multiple different resources - e.g. you can add a *Channel*, *Button* and *Map* to the same group to organize Macula Monitor layout.
{% endhint %}

Starting from software version 1.17.0, visual groups are also available in the Archive Backup Wizard

To access visual group management in Macula Console, go to the *Configuration* section in the bottom left panel and select the *Visual Groups* component in the menu on the left.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FCdl48hkGV2DPZnmmN0W3%2Fimage.png?alt=media&amp;token=73c22081-66df-4391-ae79-a90c2c4704e9" alt=""><figcaption></figcaption></figure>

Click the *+ Create visual group* button in the upper panel to bring up visual group creation dialog box.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FqZtXPPFM2I9Ddhx3nPcq%2Fimage.png?alt=media&amp;token=0f7cf889-3f5c-4148-9ef2-2b5eb7586275" alt=""><figcaption></figcaption></figure>

In the *Details* tab, enter a user-defined name for the target visual group. This name will appear in connected Macula Monitor applications.

You also can select custom Icon that will be displayed in Macula Monitor.

Switch to the *Members* tab to choose resources for this group. You can create nested visual groups (i.e., group inside group) - they will appear as a tree in the Macula Monitor application.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2F3fY515QrhsWYSqTL6dXE%2Fimage.png?alt=media&amp;token=96afd9f7-4e0b-4ef4-9c39-62cfced50d59" alt=""><figcaption></figcaption></figure>

Double-click items or use the *Add/Remove* buttons below to manipulate resources; use the *Search* field in the upper-right-hand corner to quickly find entries in the list.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FlB30lKzqdPkiUUOdzdTs%2Fimage.png?alt=media&amp;token=cbddc19c-b008-4efc-9be7-384e594f265e" alt=""><figcaption></figcaption></figure>

Switch to the *Permissions* tab to allow user access to this visual group. There are two available permissions types:

* View: users have access to this resource in Macula Monitor
* Administer: users are permitted to edit this group via Macula Console

When you have finished, click *OK* to save and exit; the newly created visual group will appear in the item list.

To edit any of the previously created visual groups, double-click it in the item list or select any with single mouse click and then hit the *Edit* button on the upper panel. Use the *Search* field in the upper-right-hand corner to quickly find the existing items; the filters in the bottom panel allow you to load recently added/modified items. Use the ![](https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2Fuv0ik0FHCc9VOoXFBDMq%2Fimage.png?alt=media\&token=9f6088f7-ff15-4a9a-832d-b40e619ad465) recycle bin button in the upper-right-hand corner to remove one or multiple visual groups: hold *CTRL* or *Shift* to select several items at once, or *CTRL+A* to select all.
