> 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/chat/group-info.md).

# Group info

{% 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: web, iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/chat/group-info.md).
{% endhint %}

Details of the site chat or a group chat: image, name, description, members and admins, muting, adding and removing members, and leaving or deleting the chat.

![Group info](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-2465dd5712e4d80ae7518af508ce04d045f0c657%2Fgroup-info.png?alt=media)

* **Where:** web: the info button in the [conversation](https://docs.snapfix.com/how-the-apps-work/screens/chat/conversation.md) header, or "Group Info" in the [Chats](https://docs.snapfix.com/how-the-apps-work/screens/chat/chats.md) row menu; a side panel on the right. iOS and Android: the info button in the conversation header, a full screen.
* **Who:** any member of the chat. Admins edit the description of any group chat. In a custom group, only admins change the name and image, add and remove members, make or dismiss admins, and delete the group. Every member can mute the chat and leave a custom group. The site chat and task-group chats cannot be left or deleted here, and their members come from the site or the task group.
* **Feature:** [Chat](https://docs.snapfix.com/product/features/chat/chat.md)

A direct chat opens [Contact info](https://docs.snapfix.com/how-the-apps-work/screens/chat/contact-info.md) instead. Who counts as an admin depends on the chat: in a custom group the member's admin flag, in a task-group chat the member's "Admin" role in the task group, in the site chat the user's "Admin" type on the site. Only the Firestore rules could stop a member from writing these flags directly \[[ASK-43](https://github.com/snapfix/docs/blob/main/ASK.md#ask-43-where-are-the-firebase-rules-that-guard-chat-data)].

## Layout

The web panel, top to bottom (iOS and Android show the same parts on one screen):

1. Title: "Site Info" for the site chat, "Group Info" otherwise, with a close button.
2. The chat image. Custom-group admins get an edit badge ("Change Group Image").
3. The name. Custom-group admins get a pencil that opens an inline box ("Enter new group name", a tick to save, a cross to cancel). The site chat shows the site's name.
4. "Chat Group Description". Admins get a box with a pencil. Other members see the text, when there is one, with "Only group admins can edit the description". A task-group chat with no description shows the task group's address.
5. Task-group chats only: a card with the task group's image, name, address and its red, amber and green task counts, and an "Inactive Group" badge when the task group is inactive. Clicking it opens the group's tasks ("View Group Tasks" is the button's tooltip).
6. "Notifications" with the switch "Mute Chat Notifications". iOS and Android say "Mute Chat Group Notifications" in a group.
7. "Chat Group members (n)": you first ("You"), then admins, then everyone else A to Z. Admins are marked "ADMIN" (custom groups) or "(ADMIN)" (site chat and task groups). Custom groups add "Add Members" and, for admins, a "⋮" menu on each other member. The site chat leaves out users who have never signed in.
8. Custom groups only: "Leave Chat Group" and, for admins, "Delete Chat Group". A deleted group shows "This group has been deleted. You can no longer send messages." instead.

iOS adds an info icon by a task group's members, and Android a tooltip: "This chat is linked to the Task Group ''. Its users and admins mirror those in the Task Group. To add or remove members, please update the Task Group settings."

## Inputs

| Field       | Type                | Required | Default                 | Rules and messages                                                                                                                                                                                                                                                                                                                                                                              |
| ----------- | ------------------- | -------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Group name  | Text, one line      | Yes      | The current name        | Custom-group admins. Web: up to 50 characters; an empty name is not saved. Success "Group name updated", failure "Failed to update group name". iOS and Android: up to 255 characters; iOS warns "Group name can't be blank.". The web save does not check that you are an admin; only the hidden pencil does.                                                                                  |
| Group image | Image file          | No       | The current image       | Custom-group admins. Uploaded through the web's image dialog. Success "Group image updated", failure "Failed to upload group image". Other chat types: "Image can only be changed for custom groups"; non-admins: "Only group admins can change the group image".                                                                                                                               |
| Description | Text, several lines | No       | The current description | Admins of any group chat. The web editor has no length limit, while the create dialog allows 200. Save stays off until the text changes. Success "Group description updated successfully", failure "Failed to update group description". A non-admin who reaches save: "Only group admins can edit the group description". A missing group ID shows the fixed English "Group ID not available". |
| Mute        | Switch              | No       | The chat's mute state   | Anyone. Takes effect at once: "Chat muted successfully" or "Chat unmuted successfully"; failure "Failed to update mute settings".                                                                                                                                                                                                                                                               |

## Actions

| Action                                   | Who                                    | What happens                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | API                                                                                                                |
| ---------------------------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Rename, change image, edit description   | As in [Inputs](#inputs)                | Saves the group's record and updates every member's chat entry. A task group's description is kept in the chat only; the task group is unchanged.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Firestore; image upload: [`POST /v1/app/upload`](https://docs.snapfix.com/engineering-reference/api/files.md)      |
| Mute or unmute                           | Anyone                                 | Sets `mute_group` on your membership and your chat entry. No push for this chat while muted.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Firestore                                                                                                          |
| Open the task-group card                 | Anyone, task-group chats               | Web: opens `/group/<id>/tasks` in a new tab ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md)); missing details: "Group details not available". Mobile: opens the task list; while the group still loads: "Your group data is still loading. If you have a good internet connection the group will be loaded soon."                                                                                                                                                                                                                                                                                                                                                                              | Group data: [`GET /v1/app/businesses/{uuid}`](https://docs.snapfix.com/engineering-reference/api/groups.md)        |
| "Add Members"                            | Custom-group admins                    | Opens [Add users](#add-users). Adding updates the new members' chat entries and posts an "added … to the group" line. Success "Successfully added N user(s) to the group", failure "Failed to add users to group". Task groups: "Users can only be added to Snapfix groups through the backend system".                                                                                                                                                                                                                                                                                                                                                                                                                                | Firestore; people: [`GET /v1/app/parents/{id}/users`](https://docs.snapfix.com/engineering-reference/api/users.md) |
| "Make Group Admin" or "Dismiss as Admin" | Custom-group admins, on another member | Sets or clears the admin flag. Success "User has been made admin" or "User has been removed from admin". Non-admins: "Cannot Make Admin" / "Only group admins can make other users admin."                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Firestore                                                                                                          |
| "Remove from Group"                      | Custom-group admins, on another member | Asks first ([Remove a member](#remove-a-member)), then marks the member removed, deletes their chat entry and posts a "removed … from the group" line. Success "Successfully removed from the group".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Firestore                                                                                                          |
| "Leave Chat Group"                       | Members of a custom group              | Same as leaving from [Chats](https://docs.snapfix.com/how-the-apps-work/screens/chat/chats.md#leave-group): the web leaves at once, iOS and Android ask "Leave this group?" first. Here iOS posts the "left" line. The only admin cannot leave: "Cannot Leave Group" / "Each group requires at least one admin. Please assign another user as an admin before leaving the group." Success "Successfully left the group", failure "Failed to leave group".                                                                                                                                                                                                                                                                              | Firestore                                                                                                          |
| "Delete Chat Group"                      | Custom-group admins                    | Asks first ([Delete chat group](#delete-chat-group)), then marks the group deleted and removes the chat from every active member's list. The web also posts "deleted this group"; iOS does not. The messages and members stay in the database \[[ASK-46](https://github.com/snapfix/docs/blob/main/ASK.md#ask-46-what-happens-to-a-deleted-messages-text-and-to-a-deleted-groups-data)]. Success "Successfully deleted the group"; failure "Failed to delete group" (fixed English on the web). Non-admins: "Cannot Delete Group" / "Only group admins can delete the group."; other chat types: "Cannot delete this type of group". Live, the row briefly read "You deleted this group", then left the list and the next chat opened. | Firestore                                                                                                          |

## States

* **Loading:** details and members fill in as they arrive.
* **Empty:** none; a group always lists at least you.
* **Error:** the toasts above. Several failures are fixed English on the web: "Group ID not available", "User UUID not available", "Failed to remove user from group" and "Failed to delete group".
* **Stale panel:** the web panel keeps the chat it was opened for; after picking another chat it still shows the first one.
* **No permission:** non-admins see no edit, add, remove, admin or delete controls; the web also refuses those actions with the messages above. In a deleted custom group, or when you are marked removed, the web hides the image and name editing, "Add Members", "Leave Chat Group" and "Delete Chat Group".
* **Offline (mobile):** no offline state of its own.

## Dialogs and sheets

### Add users

Web: "Add Users to Group", "Search Users", the site's users who are not members yet, A to Z, with checkboxes. "Add Users (N)" stays off at 0; "Cancel" closes. "Loading users..." while loading, and "No users available to add to this group." when nobody is left. iOS: the people sheet in add mode, "Add members", "Select one or more users to add to this group", with "Already added to the group" on members.

### Remove a member

Web: "Remove User from Group" / "Are you sure you want to remove "" from this group?" with "Remove" and "Cancel". The name goes into the alert as HTML. Removing yourself: "Cannot Remove Yourself" / "You cannot remove yourself from the group. Use "Leave Group" instead." Non-admins: "Cannot Remove User" / "Only group admins can remove users from the group." Other chat types: "Cannot remove users from this type of group".

### Delete chat group

Web: "Delete Chat Group" / "Are you sure you want to delete this group? This action cannot be undone, and all group data will be permanently deleted." with "Cancel" and "Delete". iOS: "Delete this group?" with "Delete".

### Member menu

Web: the "⋮" menu with "Make Group Admin" or "Dismiss as Admin", and "Remove from Group". iOS and Android: a sheet with "Make group admin" or "Dismiss as admin", and "Remove From Group".

### Change name

iOS and Android: a sheet "Change Group Name" with one field (and "Change Group Description" for the description).

## Platform differences

| Topic                        | Web                                 | iOS                             | Android                         |
| ---------------------------- | ----------------------------------- | ------------------------------- | ------------------------------- |
| Shape                        | side panel                          | full screen                     | full screen                     |
| Name limit                   | 50                                  | 255                             | 255                             |
| Name and description editing | inline, with pencil, tick and cross | one-field sheet                 | one-field sheet                 |
| Mute label in a group        | "Mute Chat Notifications"           | "Mute Chat Group Notifications" | "Mute Chat Group Notifications" |
| Leave confirmation           | none                                | yes                             | yes                             |
| "deleted this group" line    | yes                                 | no                              | not checked                     |
| Task-group card              | new browser tab                     | task list                       | task 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.snapfix.com/how-the-apps-work/screens/chat/group-info.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.
