Manage groups

Add, remove, and configure groups

From the administration dashboard, click the Groups and allocation tab to view all groups in the hub and manage group details, compute resources, projects, and administrators.

Create a new group

If you are a hub administrator, you can create up to 750 groups per hub. Follow these steps to create a new group:

1. Click New Group and enter a title for your new group on the Edit details tab. The name is used to connect to the hub in Qiskit. It is auto-generated, but editable. You can also add a description of the group if desired. Specify the allocation of the group in minutes. You can also indicate if the group will be limited or if their time is protected, then click Next.

2. On the Allocated QPUs tab, select the QPUs that you want to assign to the group, then click Add.

3. After you finish allocating QPUs, click Next and optionally add group administrators.

   • Group administrators can create projects and manage members and QPUs within them.

Delete a group

If you are a hub administrator, you can remove groups from a hub.

1. On the Groups and allocation tab of your hub, find the group in the list and click on the overflow menu () to the right of the row.
2. Click Delete and then confirm that you want to delete the group and its associated projects.

Add a project to a group

1. Within the Groups and allocation tab, find the group in the list, expand the row by clicking on the arrow button to the left (), find the project in the list, click on the overflow menu () to the right of the row, and click Add project. You can add up to 100 projects to each group.

2. Name your project, add any details to the project description, specify the project allocation in minutes, optionally indicate if the group will be limited or if their time is protected, and click Next.

   • A QPU name will auto-generate in the field below the Title field, but you can edit this if desired.
   • The project’s allocation helps determine job priority. Priority of jobs in the queue is determined globally and is based on the usage of all compute resources (not on individual QPUs). See Fair-share queuing for more information.
   • Protecting time is only available at the project level if the group's allocation is also protected and limited.

3. Choose a QPU for your project from the list of QPUs available to your group, then click Add. Continue adding QPUs as desired.

4. After you finish allocating QPUs, click Next and then add Collaborators to your project. Collaborators can submit jobs to the project but can’t make any administrative changes.

Click the name of a project to see the project landing page and to manage projects.

Edit groups and allocation

You can add and remove groups or change the group’s allocation on the Groups and allocation tab.

The group’s allocation influences how your jobs travel through the queue. This value is set when the group is created. It can be updated at any time on the Groups and allocation page. A group administrator can also change it on the group settings panel.

See Manage time allocation to learn more.

For more information about sharing, see the Fair-share queuing topic.

Work with group compute resources

1. Within the Groups and allocation tab, find the group in the list, click on the overflow menu () on the very right of the row, then click Edit.

2. Click the Allocated QPUs tab.

3. Add or remove QPUs.

   • Add: Select QPU to add to your group from the list of available QPUs, then click Add.
   • Remove: Delete a QPU assigned to your group by clicking its trash icon.

4. Click Update, then close the window.

Set project allocation

The project’s allocation influences how your jobs travel through the queue. For more information about sharing, see the Fair-share queuing topic.

1. Within the Groups and allocation tab, find the group on the list, expand the row by clicking on the arrow button on the very left (), find the project on the list.
2. Click the Edit allocation tab.
3. Update the project allocation in minutes.
4. Click Save changes, then close the window.

Edit a group

You can change the following from the group settings panel:

• Edit the group’s title and description
• Change the group’s allocation and indicate if the group will be limited or if their time is protected
• Add or remove QPUs
• Add or remove group administrators

Edit administrators

Add or remove group administrators on the group settings panel. If administrators want to send workloads to QPUs through a project, they must also be added as project collaborators.

1. From the hub details page, select the Groups and allocation tab and find the group in the list.
2. Click on the overflow menu () to the right of the row.
3. Click the Admins tab, enter the email address of the person to add as an administrator, and click Add.
4. To save the changes, click "Update".