Add or change Gemini subscriptions
Stay organized with collections
Save and categorize content based on your preferences.
This document describes how to access and use the
Gemini Code Assist administrator controls.
Gemini Code Assist subscriptions are subject to
Google Cloud Service Specific Terms
regarding Pricing and Billing for Committed Units.
Grant IAM permissions
In order to get the required permissions for adding or editing
Gemini Code Assist subscriptions, ask your administrator to grant
you the roles/billing.admin
IAM role on the billing account.
Alternatively, ask your administrator to grant you the
roles/consumerprocurement.orderAdmin
role
and the
roles/billing.viewer
role.
These roles contain the permissions required to add or change
Gemini Code Assist subscriptions. To see the exact permissions
that are required, expand the Required permissions section.
Required permissions
consumerprocurement.orders.place
billing.billingAccountPrices.list
Access Gemini for Google Cloud admin controls in the Google API Console
To access Gemini for Google Cloud admin controls in the
Google API Console, select Admin for Gemini in the navigation menu.
Go to Admin for Gemini
Pick a billing account
To edit or purchase a Gemini Code Assist subscription, you must
pick a billing account. Your Gemini Code Assist subscription is
tied to a billing account and can be used with any project. You can only have
one Gemini Code Assist subscription per billing account.
The following list shows possible ways to pick a billing account:
Manage subscriptions with project access.
If you don't have a subscription yet, click Get Gemini Code Assist
to purchase one. Note that you must
set up a billing account
first.
If you have a subscription already but it's not associated with this
billing account, click Manage subscriptions and then select a
different billing account where you want to manage the subscription.
If you already have a subscription associated with your current billing
account, click Manage Gemini Code Assist to navigate to the settings
page. Then, click Manage Subscriptions to select and manage existing
subscriptions.
Manage subscriptions without project access. If you have permission to
manage subscriptions, select the product you want to edit or purchase. Then,
select Manage Subscription and select a billing account.
Manage subscriptions for projects in a folder. If you start from a folder,
you must select a billing account before you purchase a subscription, since
billing accounts can't be directly associated with a folder.
Edit a Gemini Code Assist subscription
In the Google API Console, go to the Admin for Gemini page.
Go to Admin for Gemini
The Admin for Gemini page loads.
Use the project picker at the top of the page to ensure you are scoped to the
project or folder that has an existing Gemini Code Assist
subscription.
Locate the Gemini Code Assist product tile, and then click
Manage Gemini Code Assist.
Select Manage subscription.
The Manage subscription page appears.
Select Manage subscription to edit the subscription, including:
Manage edition - If you're editing your Gemini Code Assist
subscription, then you can upgrade from Standard edition to Enterprise
edition, which takes effect immediately. Alternatively, you can downgrade
from Enterprise edition to Standard edition, which takes effect at end of
the current subscription term. To see a list of features available in each
edition, see
Supported features.
Increase or decrease the number of licenses in the subscription -
Adding licenses makes them available to you almost immediately.
However, if you reduce the number of licenses, then the changes won't take
effect until the end of the subscription term. Additionally, the original
license count is still reflected in your bill until the changes are
applied.
Change the subscription period - You can set the subscription to bill
monthly or annually. With an annual subscription, you are given a
discounted rate that is charged on a monthly basis rather than a one-time
payment. If you change from an annual subscription to a monthly
subscription, then the change won't take effect until the end of the
annual term. Additionally, you cannot change the subscription period
unless you have enabled subscription auto-renewal.
Enable or disable auto-renewal - If you disable auto-renewal, the
subscription expires at the end of the subscription term and all the
licenses in the subscription become invalid. You cannot re-enable a
subscription after it expires. Instead, you'll need to purchase a new
subscription to re-assign those licenses. Additionally, if auto-renewal
is disabled, then you can't make the following changes:
- Reduce number of licenses
- Change from annual to monthly subscription period
- Change from Enterprise edition to Standard edition
Select Continue, and then select Confirm changes.
What's next
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-25 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-25 UTC."],[[["\u003cp\u003eAccess the Gemini for Google Cloud admin controls by selecting "Admin for Gemini" in the Google Cloud console navigation menu.\u003c/p\u003e\n"],["\u003cp\u003eYou can edit a Gemini for Google Cloud subscription by navigating to the "Admin for Gemini" page and selecting "Manage" for the specific product you wish to update.\u003c/p\u003e\n"],["\u003cp\u003eSubscription edits include managing the edition (upgrading or downgrading), increasing or decreasing the number of licenses, and changing the subscription period (monthly or annually).\u003c/p\u003e\n"],["\u003cp\u003eEnabling auto-renewal is necessary to reduce license count, switch from annual to monthly subscription periods, or change from Enterprise to Standard edition.\u003c/p\u003e\n"],["\u003cp\u003eGemini for Google cloud subscriptions are subject to Google Cloud service specific terms regarding pricing and billing.\u003c/p\u003e\n"]]],[],null,["This document describes how to access and use the\nGemini Code Assist administrator controls.\n\nGemini Code Assist subscriptions are subject to\nGoogle Cloud [Service Specific Terms](https://cloud.google.com/terms/service-terms)\nregarding Pricing and Billing for Committed Units.\n\nGrant IAM permissions\n\nIn order to get the required permissions for adding or editing\nGemini Code Assist subscriptions, ask your administrator to grant\nyou the [`roles/billing.admin` IAM role](https://cloud.google.com/billing/docs/how-to/billing-access#billing.admin) on the billing account.\n\nAlternatively, ask your administrator to grant you the\n[`roles/consumerprocurement.orderAdmin` role](https://cloud.google.com/marketplace/docs/access-control#consumerprocurement.orderAdmin)\n*and* the\n[`roles/billing.viewer` role](https://cloud.google.com/billing/docs/how-to/billing-access#billing.viewer).\n\nThese roles contain the permissions required to add or change\nGemini Code Assist subscriptions. To see the exact permissions\nthat are required, expand the **Required permissions** section. \n\nRequired permissions\n\n- `consumerprocurement.orders.place`\n- `billing.billingAccountPrices.list`\n\nAccess Gemini for Google Cloud admin controls in the Google API Console\n\nTo access Gemini for Google Cloud admin controls in the\nGoogle API Console, select **Admin for Gemini** in the navigation menu.\n\n[Go to **Admin for Gemini**](https://console.cloud.google.com/gemini-admin)\n\nPick a billing account\n\nTo edit or purchase a Gemini Code Assist subscription, you must\npick a billing account. Your Gemini Code Assist subscription is\ntied to a billing account and can be used with any project. You can only have\none Gemini Code Assist subscription per billing account.\n\nThe following list shows possible ways to pick a billing account:\n\n- **Manage subscriptions with project access**.\n\n - If you don't have a subscription yet, click **Get Gemini Code Assist**\n to purchase one. Note that you must\n [set up a billing account](/billing/docs/how-to/create-billing-account)\n first.\n\n - If you have a subscription already but it's not associated with this\n billing account, click **Manage subscriptions** and then select a\n different billing account where you want to manage the subscription.\n\n - If you already have a subscription associated with your current billing\n account, click **Manage Gemini Code Assist** to navigate to the settings\n page. Then, click **Manage Subscriptions** to select and manage existing\n subscriptions.\n\n- **Manage subscriptions without project access** . If you have permission to\n manage subscriptions, select the product you want to edit or purchase. Then,\n select **Manage Subscription** and select a billing account.\n\n- **Manage subscriptions for projects in a folder**. If you start from a folder,\n you must select a billing account before you purchase a subscription, since\n billing accounts can't be directly associated with a folder.\n\nEdit a Gemini Code Assist subscription\n\n1. In the Google API Console, go to the **Admin for Gemini** page.\n\n [Go to **Admin for Gemini**](https://console.cloud.google.com/gemini-admin)\n\n The **Admin for Gemini** page loads.\n2. Use the project picker at the top of the page to ensure you are scoped to the\n project or folder that has an existing Gemini Code Assist\n subscription.\n\n3. Locate the **Gemini Code Assist** product tile, and then click\n **Manage Gemini Code Assist**.\n\n4. Select **Manage subscription**.\n\n The **Manage subscription** page appears.\n5. Select **Manage subscription** to edit the subscription, including:\n\n - **Manage edition** - If you're editing your Gemini Code Assist\n subscription, then you can upgrade from Standard edition to Enterprise\n edition, which takes effect immediately. Alternatively, you can downgrade\n from Enterprise edition to Standard edition, which takes effect at end of\n the current subscription term. To see a list of features available in each\n edition, see\n\n [Supported features](/gemini-code-assist/docs/overview#supported-features).\n\n - **Increase or decrease the number of licenses in the subscription** -\n Adding licenses makes them available to you almost immediately.\n However, if you reduce the number of licenses, then the changes won't take\n effect until the end of the subscription term. Additionally, the original\n license count is still reflected in your bill until the changes are\n applied.\n\n - **Change the subscription period** - You can set the subscription to bill\n monthly or annually. With an annual subscription, you are given a\n discounted rate that is charged on a monthly basis rather than a one-time\n payment. If you change from an annual subscription to a monthly\n subscription, then the change won't take effect until the end of the\n annual term. Additionally, you cannot change the subscription period\n unless you have enabled subscription auto-renewal.\n\n - **Enable or disable auto-renewal** - If you disable auto-renewal, the\n subscription expires at the end of the subscription term and all the\n licenses in the subscription become invalid. You cannot re-enable a\n subscription after it expires. Instead, you'll need to purchase a new\n subscription to re-assign those licenses. Additionally, if auto-renewal\n is disabled, then you can't make the following changes:\n\n - Reduce number of licenses\n - Change from annual to monthly subscription period\n - Change from Enterprise edition to Standard edition\n6. Select **Continue** , and then select **Confirm changes**.\n\nWhat's next\n\n- Learn more about [Gemini for Google Cloud billing](https://cloud.google.com/gemini/docs/billing-questions).\n- [Manage your Gemini for Google Cloud licenses](/gemini-code-assist/docs/manage-licenses)."]]