> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/how-the-apps-work/screens/groups/add-users.md).

# Add users to a group

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). Platforms: iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/groups/add-users.md).
{% endhint %}

Pick a group, then add people to it on that group's Users tab. Apps only: the web adds people from the group's own settings ([Group settings](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-settings.md)).

* **Where:** iOS: the add-user button in the groups header, or a person in [My network](https://docs.snapfix.com/how-the-apps-work/screens/chat/my-network.md) (screen "Add users to a group"); Android: the screen exists, but no visible control opens it \[[ASK-280](https://github.com/snapfix/docs/blob/main/ASK.md#ask-280-should-android-still-offer-add-users-to-a-group)]
* **Who:** admins of the group and users with "Add or Remove Users in Group" (`perBusSettingsEditUser`). The list shows all the user's groups in the site; the check runs when a group is picked. Android also refuses read-only members.
* **Feature:** [Group members](https://docs.snapfix.com/product/features/groups/group-members.md)

## Getting here

* **iOS:** the groups header's add-user button shows for site admins and admins of any group in the site, like its add-group button ([Groups](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-list.md#platform-differences)). From My network the person is chosen first.
* **Android:** the "+" menu that offers "Add users to a group" opens from the Groups, Assets and Feed tab headers (android @ 86068bfeea, `app/src/main/java/gmail/com/snapfixapp/fragment/GroupListingFragment.java:238`, `fragment/AssetGroupListingFragment.java:243`, `fragment/FeedFragment.kt:343`), and those headers are hidden, so no visible control opens the screen \[[ASK-280](https://github.com/snapfix/docs/blob/main/ASK.md#ask-280-should-android-still-offer-add-users-to-a-group)]. See [Navigation](https://docs.snapfix.com/how-the-apps-work/nav.md).
* **Next:** the chosen group's Users tab in [Group settings](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-settings.md), where [Find user to add](https://docs.snapfix.com/how-the-apps-work/screens/groups/find-user.md) opens.

## Layout

### iOS

The title "Add users to a group" (from My network: "Add {name} to a group", or "Invite '{name}' to a group" for a phone contact), the prompt "Select a group", a "Search group" field and the user's groups in the site, each with its image and name, and a button to continue. From My network the screen also has a site picker.

### Android

The title "Add users to a group" with a progress bar, "Select a group", a search field, the list of groups, and a button to create a group.

## Inputs

| Field                       | Type                    | Required | Default          | Rules and messages                                                        |
| --------------------------- | ----------------------- | -------- | ---------------- | ------------------------------------------------------------------------- |
| Group                       | One group from the list | Yes      | None             | iOS: with no group picked, "Select a group". The search narrows the list. |
| Site (iOS, from My network) | One of the user's sites | Yes      | The current site | Changes the list of groups.                                               |

## Actions

| Action                         | Who                                               | What happens                                                                                                                                                                                                                                                                         | API |
| ------------------------------ | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --- |
| Pick a group                   | Admins and "Add or Remove Users in Group" holders | Opens that group's Users tab ([Group settings](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-settings.md)). From My network the person is passed along to be added there; a person already in the group gets "This user is already added to this group."           | -   |
| Pick a group without the right | Others                                            | "You don’t have the right permissions to create or edit users in this group. Reach out to the group admin to review your permissions." (both apps). Android refuses read-only members first: "You are inactive in this group. Reach out to the group admin to review your position." | -   |
| Create a group (Android)       | Anyone on the screen                              | Opens [Create a new group](https://docs.snapfix.com/how-the-apps-work/screens/groups/create-group.md).                                                                                                                                                                               | -   |
| Back                           | Anyone                                            | Returns to the previous screen.                                                                                                                                                                                                                                                      | -   |

## States

* **Loading:** none; the groups come from the device.
* **Empty:** Android hides the menu item when there is no group; iOS's add-user button follows its admin rule.
* **No permission:** the alerts above.
* **Offline (mobile):** the picker works from the device's copy. Adding people on the Users tab is saved on the device and synced.

## Platform differences

* **Entry:** iOS uses the groups header and My network; Android the Groups tab's "+" menu.
* **Read-only members:** Android refuses them at this step; iOS checks only the admin role and the users permission.
* **Next step:** both apps open the group's Users tab. Android's direct user list for this screen (`UserSelectFragment`) is not reached from it.


---

# 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.snapfix.com/how-the-apps-work/screens/groups/add-users.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.
