> For the complete documentation index, see [llms.txt](https://docs.spectralink.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spectralink.net/amie-essentials/using-the-platform/versity-groups.md).

# Versity Groups

Being able to group devices and customize configurations for device groups gives you tremendous flexibility in your deployment options. Groups are commonly used for splitting phones between SIP servers, offering different PTT channel lineups, or department contacts. Groups can also be used for simple distinction by building, department, or retail area. Group settings override Enterprise level settings for a given parameter.

On this page you can create new groups, add devices to a group, change existing groups, and edit a group’s configuration. Groups can also be established and assigned in a Batch Configuration file. You may have an indefinite number of groups, and a device may belong to more than one group.

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-8f6575597dcee2f1babab809465db6f8a48d9dfb%2Fimage65.png?alt=media)

To search for specific Groups, choose the focus of your search from the dropdown menu to the right of *Search*, and enter your search query in the field.

## Create new Groups

1. Enter the Group name.
2. Click **Select Devices** to open the device selector panel.
3. Click the check box next to devices that should become members. Click **Select Device** to finish choosing phones.
4. The selected devices appear below the button, each with their own box. To remove one or more, click the x at the right of any box.
5. Click **Save**. To clear the Group name and members and start over, click **Reset**.

## Configure or change Group settings

Once Groups are established, they will need to be configured with their own parameters. Click the check box next to the target group then select **Change Config** from the Actions menu. The Applications page will open in the group context.

Configure the applications for this Group, remembering to Save the configuration before you leave the Applications page. A page with unsaved parameters will display a blue dot.

## Prioritize Groups

A device may belong to multiple Groups, but restraint should be used. Groups are prioritized by position in the Groups table: the top row has precedence over every row beneath it; the second row has precedence over every subsequent row beneath it; and so on. A senior Group’s settings will override any conflicting settings in a junior Group.

If you define the same setting in multiple Groups and the phone belongs to all of them, the top Group’s setting will be applied. However, if you have a particular setting that is missing from a higher Group but not a lower Group, the lower Group’s setting will still apply. This may create complexity when trying to predict which Group setting will be applied. Spectralink recommends that you separate phones into Groups with unique settings, which will prevent confusion.

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-e48e7687b43825e35039a27c80ce2d5d74850456%2Fimage66.jpg?alt=media)

Groups can be created using a Batch Configuration file. Any Groups that do not already exist are created after import. The Versity phones listed in the file are automatically added into the specified Group so that they receive Group settings. Those Groups will then appear in the SAM Manage Groups list.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.spectralink.net/amie-essentials/using-the-platform/versity-groups.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.