> For the complete documentation index, see [llms.txt](https://docs.informationhub.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.informationhub.io/home/groups.md).
# Groups
Groups are sub-teams within organisations. They let you organise members into smaller teams and control which users have access to specific projects.
The groups page
## How groups work
Every group belongs to an organisation. Groups are useful when an organisation has many members and different people need access to different projects. You can create custom roles, manage membership, and control who can see the group using visibility settings.
***
## Viewing your groups
Navigate to **Groups** in the home sidebar to open the groups list at `/home/groups`. This page shows all the groups you currently belong to.
* Use the **Search Groups** bar to filter the list by name in real time.
* Pull down on the list to refresh it and pick up any recent changes.
* Click any group in the list to open it.
***
## Creating a group
You can create a group from the home Groups page. If you are already inside an organisation, you can also create a group directly from that organisation's Groups tab - see the note at the bottom of this section.
### From the home Groups page
1. On the Groups page, click the **Create Group** button (the plus icon in the top toolbar).
2. In the **Owner** field, select the organisation that will own this group. The dropdown lists all organisations you belong to.
3. Enter a **Group Name** (3 to 64 characters).
4. Choose a **Visibility** setting:
* **Private** - only members of the group can see it. It will not appear in public browse results.
* **Public** - anyone can find and view the group. Other users can request to join.
* **Protected** - the group is visible in search results, but joining requires an invitation from a group manager.
5. Add an optional **Description** (up to 2048 characters) to explain the group's purpose.
6. Click **Create** to finish, or **Cancel** to go back without saving.
{% hint style="info" %}
The **Create** button stays disabled until you have filled in all required fields. If it appears greyed out, check that you have selected an owner and entered a valid group name.
{% endhint %}
### From an organisation's Groups tab
You can also create a group from inside an organisation. Open the organisation, go to its **Groups** tab, and click **Create Group**. The form works the same way, except there is no Owner field - the organisation is already set automatically.
***
## Browsing public groups
To discover groups you are not yet a member of, click the **Browse** button (compass icon) on the Groups page. This opens the public groups browser.
* Use the search bar to filter groups by name.
* Pull down to refresh the list.
* If you find a group you want to join, click **Request to join** next to it. The group's managers will be notified and can approve or decline your request.
{% hint style="info" %}
The **Request to join** button only appears for groups you are not already a member of.
{% endhint %}
***
## Group settings
To open a group's settings, navigate into the group and select **Settings**.
### Group logo
* If no logo has been set, click **Upload** to choose an image file.
* If a logo is already set, click **Remove** to delete it.
### General details
You can update the group's **Name**, **Visibility**, and **Description** at any time. The same visibility options apply as when creating a group (Private, Public, Protected).
Click **Save** to apply your changes, or **Cancel** to revert to the last saved state.
### Custom roles
The **Role Options** card lets you create and manage custom roles for the group. Custom roles allow you to define exactly which actions each type of member can perform.
**Create a new role**
1. Click **Create New Role**.
2. Enter a name for the role in the **New Role Name** field.
3. Click **Create**.
**Update an existing role**
1. Click **Update Role**.
2. Select the role you want to edit from the dropdown.
3. Edit the **Role Name** if needed.
4. Use the checkboxes to turn individual permissions on or off.
5. Click **Save**.
**Delete a role**
1. Click **Delete Role**.
2. Select the role you want to remove from the dropdown.
3. Click **Delete** to confirm.
{% hint style="warning" %}
Deleting a role is permanent. Make sure no members are relying on that role before you remove it.
{% endhint %}
### Delete group
At the bottom of the settings page is the **Delete Group** section. Clicking **Delete** permanently removes the group and all its membership data. This action cannot be undone.
{% hint style="warning" %}
Deleting a group is irreversible. All members will lose access immediately.
{% endhint %}
***
## Managing group members
Open the group and navigate to the **Users** tab to see the full list of members.
* Use the **Search Group Users** bar to find a specific member.
* Pull down to refresh the list.
* Click a member's name or avatar to go to their profile page.
### Changing a member's role
1. Find the member in the list and click the **ellipsis (...)** icon next to their name.
2. Select **Edit Role** from the menu.
3. In the modal that opens, choose a new role from the dropdown.
4. Click **Update** to save, or **Cancel** to close without making changes.
### Removing a member
1. Find the member in the list and click the **ellipsis (...)** icon next to their name.
2. Select **Remove** from the menu.
3. Confirm the action in the modal by clicking **Remove**, or click **Cancel** to go back.
{% hint style="warning" %}
Removing a member revokes their access to all projects associated with the group immediately.
{% endhint %}
***
## Inviting a user to a group
1. On the group's **Users** tab, click the **Add user** button.
2. On the Add User page, start typing the person's name or email address. A suggestion list appears as you type.
3. Click the correct person in the suggestion list to select them. The search field will be replaced with the selected user's details.
4. If you selected the wrong person, click **Reset** to clear the selection and search again.
5. Click **Add User** to send the invitation.
{% hint style="info" %}
The **Add User** button stays disabled until a valid user has been selected from the suggestion list.
{% endhint %}
---
# 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://docs.informationhub.io/home/groups.md?ask=
```
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.