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.
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 Cloud console
To access Gemini for Google Cloud admin controls in the
Google Cloud console, select Admin for Gemini in the navigation menu.
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 Cloud console, go to the Admin for Gemini page.
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
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eAccess Gemini for Google Cloud admin controls by selecting \u003cstrong\u003eAdmin for Gemini\u003c/strong\u003e in the Google Cloud console navigation menu.\u003c/p\u003e\n"],["\u003cp\u003eManage Gemini Code Assist subscriptions, such as upgrading or downgrading editions, directly through the \u003cstrong\u003eAdmin for Gemini\u003c/strong\u003e page.\u003c/p\u003e\n"],["\u003cp\u003eAdjust the number of licenses within a subscription, with increases taking effect immediately, while decreases are applied at the end of the subscription term.\u003c/p\u003e\n"],["\u003cp\u003eModify the subscription period between monthly or annual billing, with changes to annual subscriptions only taking effect at the end of the term.\u003c/p\u003e\n"],["\u003cp\u003eEnable or disable auto-renewal, which impacts the ability to make other subscription changes and determines whether licenses expire at the end of the subscription term.\u003c/p\u003e\n"]]],[],null,["# Add or change Gemini Code Assist subscriptions\n\nThis 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---------------------\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\n#### Required permissions\n\n- `consumerprocurement.orders.place`\n- `billing.billingAccountPrices.list`\n\nAccess Gemini for Google Cloud admin controls in the Google Cloud console\n-------------------------------------------------------------------------\n\nTo access Gemini for Google Cloud admin controls in the\nGoogle Cloud console, select **Admin for Gemini** in the navigation menu.\n\n[Go to **Admin for Gemini**](https://console.cloud.google.com/gemini-admin)\n\n### Pick 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--------------------------------------\n\n1. In the Google Cloud 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/docs/codeassist/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\n- Learn more about [Gemini for Google Cloud billing](/gemini/docs/billing-questions).\n- [Manage your Gemini Code Assist licenses](/gemini/docs/manage-licenses)."]]