# Create a Circles Group using Circles Core App

### Prerequisites

Make sure you’ve completed these before continuing.

* [x] You’ve installed a wallet, [Rabby](https://rabby.io/) or [Metamask](https://metamask.io/)
* [x] You’ve received an invite link, and you have an active [Gnosis app account](https://app.gnosis.io/circles)
* [x] Open the [Circles App](https://app.aboutcircles.com/) and deploy a new [Safe](https://safe.global/)

{% hint style="info" %}
Using a Chrome-based desktop browser or Firefox is recommended (the app is not yet optimised for mobile devices)
{% endhint %}

### Creating a New Group

#### **1. Connecting**

Visit [app.aboutcircles.com](http://app.aboutcircles.com) and click “Get started”

On the “Access Circles”, select the “**Use Safe**” option.

This will allow you to either:

1. Create a new Safe which will act as the “owner” of the group you create in the next steps, or
2. Access a list of existing Safes associated with your connected wallet

![](https://hackmd.io/_uploads/SyLLzqGUxg.png)

#### **2. Create the owner's Safe**

From this page, we’ll create and deploy a new Safe wallet. This Safe will function as the owner of your new group.

1. Click the “**Create New Safe**” button,
2. Sign the transaction in your web3 wallet (eg Metamask, Rabby).

![](https://hackmd.io/_uploads/ByruM5f8gx.png)

#### **3. Create your first group**

Now that your Safe has been deployed, you will be able to see the address (eg 0x2A12…). For now, we can ignore the “register” button.

* Click on the My Groups + button to start the group creation flow

![](https://hackmd.io/_uploads/ByxZQcM8ex.png)

#### **4. Your group info**

The “Create Group” page enables you to set the important info for your new group.

**Important:**

* The group “Name” and “Symbol” fields **cannot be changed** once the group has been created
* The “Image” and “Description” fields can be updated at any time

![](https://hackmd.io/_uploads/BJlY7cMUgg.png)

#### **5. Group created**

After a few seconds, your new group will be created.

* Click “**Access the dashboard**” to view your new group

![](https://hackmd.io/_uploads/HJO4Q9fIel.png)

#### **6. Dashboard**

The current dashboard displays a list of transactions and a breakdown of the tokens in your Circles group.

In an upcoming release, this view will also display an overview of key data metrics for your group, including the number of members, group token transactions, token distribution and more.

![](https://hackmd.io/_uploads/rJ2wXcfLex.png)

#### **7. Managing members**

To add existing Circles users to your new group, navigate to the “Contacts” page and click the “**Manage members**” button.

This will display the member management form, where you can enter the address of the members you want to add.

You can also use the bulk upload option by importing a CSV file with a list of addresses.

Once you have added the addresses of all the members you wish to add to the group:

* Click the “**add**” button to start the process
* Sign the transaction in your wallet
* Once the transaction has completed, close the contact form popup, and you will see the new members in the list

![](https://hackmd.io/_uploads/SyNwmcG8ll.png)

#### **8. Update the group info**

**Non-editable fields:**

* Circles address - this is the address of the group contract

**Editable fields:**

* Group name - this is the name of the group as displayed in the Gnosis app
* Group description - this is the description for the group that is also displayed in the Gnosis app
* Location - optionally add a physical location for your group
* Image - the profile image for your group, also displayed in the Gnosis app

![](https://hackmd.io/_uploads/SJhq7cGIel.png)

#### Access an existing group

**1. Connecting**

Visit [app.aboutcircles.com](http://app.aboutcircles.com) and click “Get started”

Ensure you have your “owner” EOA (or Safe) selected in Metamask or Rabby.

On the “Access Circles”, select the “**Use Safe**” option.

![](https://hackmd.io/_uploads/r1OnQ5zUel.png)

**2. Select your profile**

On this screen, you can access your Circles accounts. Possible account types in Circles are:

1. Personal
2. Organisation
3. Group

If you have the correct EOA selected in your wallet, then you will see your group in the “My groups” section.

1. **Click on your group name** to access your group dashboard (displayed as “My Demo Group” in the screenshot below)

![](https://hackmd.io/_uploads/ryTpXczIgg.png)

**3. Dashboard**

The current dashboard displays a list of transactions and a breakdown of the tokens in your Circles group.

In an upcoming release, this view will also display an overview of key data metrics for your group, including the number of members, group token transactions, token distribution and more.

![](https://hackmd.io/_uploads/SJnm4czLgl.png)

**4. Managing members**

To add existing Circles users to your new group, navigate to the “Contacts” page and click the “**Manage members**” button.

This will display the member management form, where you can enter the address of the members you want to add.

You can also use the bulk upload option by importing a CSV file with a list of addresses.

Once you have added the addresses of all the members you wish to add to the group:

* Click the “**add**” button to start the process
* Sign the transaction in your wallet
* Once the transaction has completed, close the contact form popup, and you will see the new members in the list

![](https://hackmd.io/_uploads/H1xmVqMIxg.png)

**5. Update the group info**

**Non-editable fields:**

* Circles address - this is the address of the group contract

**Editable fields:**

* Group name - this is the name of the group as displayed in the Gnosis app
* Group description - this is the description for the group that is also displayed in the Gnosis app
* Location - optionally add a physical location for your group
* Image - the profile image for your group, also displayed in the Gnosis app

![](https://hackmd.io/_uploads/r17fV9zUxx.png)

***

We hope you've completed your setup smoothly!

Now that you've successfully created your Circles Group, you're ready to dive deeper into the technical details that form the foundation of your project. In the next section, we'll explore the protocol-level configurations and advanced features that power your group's operations.


---

# 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.aboutcircles.com/user-guides/circles-groups/create-a-circles-group-using-circles-core-app.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.