> For the complete documentation index, see [llms.txt](https://help.atlas-control.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.atlas-control.app/show-settings/objects/groups/group-configuration.md).

# Group Configuration

<figure><img src="/files/42dtCxrR9wevwhc4xG4t" alt=""><figcaption><p>Show Settings - Group Configuration</p></figcaption></figure>

### Creating the Group Layout

By selecting the parent object in the upper window it is possible to define the the origin of control for a group of objects.  By subsequently selecting the children within the group it is then possible to position them as desired using either the mouse or by typing offset values within the relevant numerical fields box.&#x20;

#### Spread and En-Space Offsets

Spread and En-Space sends can have offsets attributed to them within the group. Entering a numerical value in the relevant field box will activate this offset. Values can be either in the positive or negative.&#x20;

{% hint style="info" %}
A groups layout and parameters are stored as an offset. The spaces and backgrounds are provided to allow the user to position objects relative to a real location. This does not define the groups location onstage.&#x20;
{% endhint %}

***

### Update from Live

Update from live allows parameters of objects to be taken from their live positions and recorded into the group configuration.&#x20;

#### Absolute Positions

The positional information of the group object(s) will be captured and stored in the group config. This can be for an individual child with the group or all children.&#x20;

#### Relative to Group - Position Only&#x20;

The positional information of the groups object(s) will be captured and stored in the group config. This can be for an individual child within the group or  all children.&#x20;

#### Relative to Group - Spread Only

The spread information of the groups object(s) will be captured and stored in the group config. This can be for an individual child within the group or  all children.&#x20;

#### Relative to Group - Position & Spread

Both the  positional and spread information of the groups object(s) will be captured and stored in the group config. This can be for an individual child within the group or  all children.&#x20;

***

### Centre Group in View

Centre group in view realigns the group of objects to the centre of the currently displayed view.&#x20;

***

### Reposition Objects & Group

When selected, objects can be repositioned to allow placement within the current view.&#x20;

{% hint style="info" %}
Repositioning can be useful for aligning objects with ground plans.&#x20;
{% endhint %}

***

### Adjust All Offsets

Allows objects to be relocated around the origin of the group. All objects will expand or contract in linear scaled manner.&#x20;

***

### Force Offsets Live

Forcing offsets live will send the created group positions to the device(s) and make them live.&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://help.atlas-control.app/show-settings/objects/groups/group-configuration.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.