Skip to content

Create a Circles Group

Runner-dependent: Group creation is a write flow. Follow the UI steps below; Rust SDK code samples will be added once the runner exists.

Prerequisites

Make sure you’ve completed these before continuing.

Using a Chrome-based desktop browser or Firefox is recommended (the app is not yet optimised for mobile devices).

Creating a New Group

1. Connecting

Visit app.aboutcircles.com and click “Get started”.

On “Access Circles”, select the Use Safe option to either:

  1. Create a new Safe that will act as the owner of your group.
  2. Access existing Safes associated with your connected wallet.

2. Create the owner's Safe

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

  1. Click Create New Safe.
  2. Sign the transaction in your web3 wallet (e.g., Metamask, Rabby).

Create new Safe

3. Create your first group

After your Safe deploys, you’ll see its address (e.g., 0x2A12…). For now, ignore the register button.

  • Click My Groups + to start the group creation flow.

4. Your group info

Set the core info for your new group.

  • The Name and Symbol fields cannot be changed after creation.
  • The Image and Description fields can be updated at any time.

5. Group created

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

  • Click Access the dashboard to view your new group.

6. Dashboard

The dashboard displays a list of transactions and a breakdown of the tokens in your Circles group. An upcoming release will add group metrics (members, token transactions, distribution, and more).

7. Managing members

To add existing Circles users to your group, go to Contacts and click Manage members. Enter the addresses you want to add or bulk upload a CSV.

Once you’ve entered all member addresses:

  • Click add to start the process.
  • Sign the transaction in your wallet.
  • After the transaction completes, close the popup to see the new members listed.

8. Update the group info

Non-editable fields
  • Circles address (the group contract address).
Editable fields
  • Group name (as displayed in the Metri wallet).
  • Group description (also shown in the Metri wallet).
  • Location (optional physical location for your group).
  • Image (profile image shown in the Metri wallet).

Access an existing group

1. Connecting

Visit app.aboutcircles.com and click “Get started”. Ensure you have your owner EOA (or Safe) selected in Metamask or Rabby. On “Access Circles”, select Use Safe.

2. Select your profile

On this screen, you can access Circles accounts: Personal, Organisation, and Group. If you have the correct EOA selected, you’ll see your group in My groups.

  • Click your group name to open the dashboard (shown as “My Demo Group” below).

3. Dashboard

The dashboard shows transactions and token breakdowns for your group. An upcoming release will add group metrics (members, token transactions, distribution, and more).

4. Managing members

To add existing Circles users to your group, go to Contacts and click Manage members. Enter addresses or import a CSV, then:

  • Click add.
  • Sign the transaction in your wallet.
  • After completion, close the popup to see the new members listed.

5. Update the group info

Non-editable fields
  • Circles address (group contract address).
Editable fields
  • Group name (as displayed in the Metri wallet).
  • Group description (also displayed in the Metri wallet).
  • Location (optional physical location for your group).
  • Image (profile image displayed in the Metri wallet).

We hope you’ve completed your setup smoothly! Now that you’ve created your Circles Group, jump into the technical details that power your group’s operations.