# Github auto-grouping

In accounts where the "auto-grouping" feature is enabled, admin can select an organization from the ones they own on Github.  From that point on, when a user logs in with GitHub, it will be checked if it belongs to such an organisation and, in that case, it will be automatically added to the account.

Please note that you will need to have the feature enabled in your account to use this mechanism so get in touch with support if the need arises.

### How to activate it

Navigate to the Details tab in the Meterian dashboard and click "Change..."  on the Github organization section. \
The organization displayed in the "Github Organization" field shows the Github organization currently linked to the Meterian account. \
If the field is empty, that means that no organization is currently linked.

![](/files/-MJlwQufdbWEzTMGxFSS)

And now it will be possible to select the organization from the menu.

![](/files/-MJlwrEOF9khQ3jCeo1F)

* Users need to login using the Github option
* Users won't see the "Github organization" field if they are not an admin of any Github organization or if the access permission to their organization has not been granted

### For new accounts

One important thing to keep in mind is that on the very first login with Github, users are asked for permissions in order to interact with their Github account and Organizations (based on ownership status or GitHub-specific permission you may be prompted to request permission on certain organisations). 

Organization access permissions should be granted to enure this functionality works as expected

![](/files/-MJlvHW6I6465KqBZnh6)

### For existing accounts

If you already created an account on Meterian, it's possible to grant permission to access a Github organization directly from the Github web application.

From <https://github.com/settings/applications> select "Meterian login" and grant access to the organization which should be linked to the Meterian account.

{% hint style="info" %}
The user must be both the administration of the Meterian account and of the Github organization in order to link the organization to the Meterian account.
{% endhint %}

When the access to the organization has been granted by the organization admin, the user must perform a new login into the Meterian dashboard

{% hint style="info" %}
Meterian will start grouping user of the same Github organization once the permission are granted and the Github organization is set in the "Details" view.
{% endhint %}


---

# Agent Instructions: 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.meterian.io/the-meterian-webapp/advanced-functionalities/auto-grouping/how-to-set-an-organization.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.