This document describes how to manage Cloud Billing for each of your Google Cloud projects and Google Maps Platform projects and teaches you how to link and unlink projects and Cloud Billing accounts.
To learn how to create, modify, or close your Cloud Billing account, visit Manage your Cloud Billing account.
A Cloud Billing account defines who pays for a given set of resources, and it can be linked to one or more projects. Project usage is charged to the linked Cloud Billing account.
If you're a billing administrator on only one Cloud Billing account, new projects you create are automatically linked to your existing Cloud Billing account. If you create or have access to multiple Cloud Billing accounts, you can change the Cloud Billing account a project is billed to. This document describes how to change the Cloud Billing account for your project, as well as how to enable and disable billing for a project.
If you want to receive invoices by email, or you want to change who receives them, see Change payments contacts and notifications.
Required Permissions
The permissions required to accomplish the various tasks described in this document depend on the task and are noted at the start of each topic.
For more information about Cloud Billing permissions, see:
- Overview of access control
- Create custom roles for Cloud Billing
- Understanding predefined Identity and Access Management roles for Cloud Billing
Check if billing is enabled on a project
Billing is enabled on a project if the following are true:
- The project is linked to a Cloud Billing account.
- The linked Cloud Billing account is active and in good standing - that is, the billing account isn't closed or suspended.
See Verify the billing status of your projects to learn how to determine if billing is enabled on a project.
Change the Cloud Billing account linked to a project
Switching a project to a different Cloud Billing account shouldn't result in any service interruption or server downtime. However, your projects might be affected in the following ways.
Committed use discounts (CUDs): If you purchased a Resource-based commitment for Compute Engine resources in your project, the CUD is applied on the new Cloud Billing account. Moving the commitment has the following effects on your discount:
If you enabled discount sharing across projects in the original Cloud Billing account, the projects that remain linked to the original billing account are no longer in the scope of the discount sharing settings.
If the destination Cloud Billing account already has discount sharing enabled, such as for an existing commitment, the CUD associated with the project that you're moving is added to the discount sharing settings.
If the destination account doesn't have discount sharing enabled, you can enable discount sharing for the Cloud Billing account. If you don't want to enable discount sharing, the CUD is applied only to eligible usage in the project where you purchased the resource-based commitments.
If you set up prioritized attribution for the commitment, you might need to update the prioritized attribution configuration after you change the project's Cloud Billing account.
Learn about setting up prioritized attribution for your commitments.
After you change the Cloud Billing account for the project, the resource-based CUD is applied to the new Cloud Billing account at midnight in the US and Canadian Pacific Standard Time (UTC-8) time zone.
Google Cloud Marketplace customers: If you've made purchases from Google Cloud Marketplace in your project, learn about the steps you must take to transfer your purchases. Following these steps prevents your project from being disabled or losing data as a result of missing required resources. To learn about how you're billed for Cloud Marketplace purchases, see the Cloud Marketplace documentation.
Permissions required for this task
To change the Cloud Billing account for a project, you need to be able to move a project from one Cloud Billing account to another. To accomplish this task, you need permissions to unlink the project from the current Cloud Billing account AND to link the project to the target Cloud Billing account.
You need both project permissions and billing account permissions. These predefined roles have adequate permissions to perform this task:
On the project: Project Billing Manager and Project Viewer or Project Owner
AND
On the current and target Cloud Billing account: Billing Account User and Billing Account Viewer or Billing Account Administrator
Specifically, to perform this task, you must have the following permissions.
| Action | Permission | Roles with permission | Resource |
|---|---|---|---|
| View projects and Cloud Billing account associations |
billing.resourceAssociations.list |
Billing Account Viewer, Billing Account Costs Manager, or Billing Account Administrator | Billing account |
| AND | |||
resourcemanager.projects.get |
Project Viewer, Project Editor, or Project Owner | Project | |
| Unlink project from its current Cloud Billing account |
billing.resourceAssociations.delete |
Billing Account Administrator | Current billing account |
| OR | |||
resourcemanager.projects.deleteBillingAssignment |
Project Billing Manager or Project Owner | Project | |
| Link project to the target Cloud Billing account |
billing.resourceAssociations.create |
Billing Account User or Billing Account Administrator | Target billing account |
| AND | |||
resourcemanager.projects.createBillingAssignment |
Project Billing Manager or Project Owner | Project | |
How to change the project's billing account
To change the project's Cloud Billing account, do the following.
In the Billing section of the Google Cloud console, locate the project using one of the following methods:
Method 1: Start with your list of projects Method 2: Start with a billing account Access the My Projects page to view a list of all of your projects and their associated Cloud Billing account. This method works best if you have the Project Owner, Project Editor, Project Viewer, or Project Billing Manager IAM role on the project you want to manage.
To view a list of all of your projects and their associated Cloud Billing account, take the following steps:
- In the Google Cloud console, go to the My Projects page in the Billing section.
- From the list of projects, locate the project you want to manage.
Open the Account management page for a selected billing account to view the list of all the projects linked to the Cloud Billing account. This method works well when you have access to an active Cloud Billing account that you know by name.
To view the list of projects linked to a specific billing account, take the following steps:
- In the Google Cloud console, go to the Account management page for the Cloud Billing account.
- At the prompt, choose the Cloud Billing account you want to view.
- On the Account management page, from the list of projects, locate the project that you want to manage.
In the project row, open the Actions menu (), select Change billing, then choose the destination Cloud Billing account.
Click Set account.
(Optional) After you link a project to a billing account, you can lock the link to prevent the project from unintentionally being moved (linked) to a different billing account or the project link being deleted from the billing account.
About project charges after the billing account is changed
After you change the Cloud Billing account on a project, charges already incurred prior to moving the project are billed to the former Cloud Billing account. This can include charges that haven't yet been reported in the transaction history. Depending on the service, it might take up to two days for charges to be reported to the transaction history.
For example: If you move your project from Account A to Account B on May 15, charges incurred May 1 to May 15 will be billed to Account A (old), and charges incurred May 16 to May 31 will be billed to Account B (new).
Enable billing for a project
How you enable billing depends on whether you're creating a new project or you're re-enabling billing for an existing project.
Enable billing for a new project
When you create a new project, you're prompted to choose which of your Cloud Billing accounts you want to link to the project. If you have only one Cloud Billing account, that account is automatically linked to your project.
If you don't have a Cloud Billing account, you must create one and enable billing for your project before you can use many Google Cloud features. To create a new Cloud Billing account and enable billing for your project, follow the instructions in Create a new Cloud Billing account.
Enable billing for an existing project
To use Google Cloud resources in a project, billing must be enabled on the project. Billing is enabled when the project is linked to an active Cloud Billing account. Billing can become disabled on a project for one of the following reasons:
- The project is unlinked from its billing account, disabling billing on the project.
- The Cloud Billing account that is linked to the project is closed or suspended.
- The project was shut down (deleted) and then restored within the 30-day recovery period.
If you have a project where billing has been disabled, all billable services within that project are stopped. Re-enable billing on the project to restart the resources.
- After billing is re-enabled, it might take up to 24 hours for the resources to start up again.
- Some services might need to be restarted manually. For more information, see Restarting Google Cloud Services.
- While billing is disabled on a project, some resources might be deleted and might not be fully recoverable. Learn about data deletion on Google Cloud.
Permissions required for this task
To enable billing for a project, you need permissions to link the project to the target Cloud Billing account.
You need both project permissions and billing account permissions. These predefined roles have adequate permissions to perform this task:
On the project: Project Billing Manager and Project Viewer or Project Owner
AND
On the target Cloud Billing account: Billing Account User and Billing Account Viewer or Billing Account Administrator
Specifically, to perform this task, you must have the following permissions.
| Action | Permission | Roles with permission | Resource |
|---|---|---|---|
| View projects and Cloud Billing account associations |
billing.resourceAssociations.list |
Billing Account Viewer, Billing Account Costs Manager, or Billing Account Administrator | Billing account |
| AND | |||
resourcemanager.projects.get |
Project Viewer, Project Editor, or Project Owner | Project | |
| Link project to a Cloud Billing account |
billing.resourceAssociations.create |
Billing Account User or Billing Account Administrator | Billing account |
| AND | |||
resourcemanager.projects.createBillingAssignment |
Project Billing Manager or Project Owner | Project | |
How to enable billing on an existing project
To enable billing on a project, do the following:
Sign in to the Manage billing accounts page in the Google Cloud console.
Select the My projects tab to view a list of projects and the associated Cloud Billing account for each project.
From the list of projects, locate the project for which you want to re-enable billing. Tip: In the Billing account column, for projects that aren't linked to a billing account, look for "Billing is disabled".
In the project row, open the Actions menu (), select Change billing, then choose the destination Cloud Billing account.
Click Set account.
(Optional) After you link a project to a billing account, you can lock the link to prevent the project from unintentionally being moved (linked) to a different billing account or the project link being deleted from the billing account.
Error when attempting to re-enable billing
If you're re-enabling billing on a recently
restored project,
you might encounter an error similar to: User missing permission
'resourcemanager.projects.createBillingAssignment' to link a billing account to
project. The attempted action failed, please try again.
Due to latency issues during the project recovery process, it might take some time for the restored project to propagate to the Cloud Billing system. You can't successfully link a Cloud Billing account to a restored project until the project is fully propagated to the billing system.
If you receive an error message when attempting to link a billing account to a newly restored project, retry after about 10 minutes. If it still doesn't work, wait a few hours to assign billing. In rare instances, it might take up to 36 hours before you can re-enable billing on a restored project.
Disable billing for a project
To stop automatic payments for a project, you can disable billing for the project. You're still responsible for all outstanding charges for the project. Your listed form of payment on your Cloud Billing account is used to pay for any outstanding charges.
Permissions required for this task
To disable billing for a project, you need permissions to unlink the project from the Cloud Billing account.
You need both project permissions and billing account permissions. These predefined roles have adequate permissions to perform this task:
On the project: Project Billing Manager and Project Viewer or Project Owner
OR
On the target Cloud Billing account: Billing Account Administrator
Specifically, to perform this task, you must have the following permissions.
| Action | Permission | Roles with permission | Resource |
|---|---|---|---|
| View projects and Cloud Billing account associations |
billing.resourceAssociations.list |
Billing Account Viewer, Billing Account Costs Manager, or Billing Account Administrator | Billing account |
| AND | |||
resourcemanager.projects.get |
Project Viewer, Project Editor, or Project Owner | Project | |
| Unlink project from a Cloud Billing account |
billing.resourceAssociations.delete |
Billing Account Administrator | Billing account |
| OR | |||
resourcemanager.projects.deleteBillingAssignment |
Project Billing Manager or Project Owner | Project | |
How to disable billing for a project
To disable billing for a project, do the following:
In the Billing section of the Google Cloud console, locate the project using one of the following methods:
Method 1: Start with your list of projects Method 2: Start with a billing account Access the My Projects page to view a list of all of your projects and their associated Cloud Billing account. This method works best if you have the Project Owner, Project Editor, Project Viewer, or Project Billing Manager IAM role on the project you want to manage.
To view a list of all of your projects and their associated Cloud Billing account, take the following steps:
- In the Google Cloud console, go to the My Projects page in the Billing section.
- From the list of projects, locate the project you want to manage.
Open the Account management page for a selected Cloud Billing account to view the list of all the projects linked to the billing account. This method works well when you have access to an active Cloud Billing account that you know by name.
To view the list of projects linked to a specific billing account, take the following steps:
- In the Google Cloud console, go to the Account management page for the Cloud Billing account.
- At the prompt, choose the Cloud Billing account you want to view.
- On the Account management page, from the list of projects, locate the project that you want to manage.
In the project row, open the Actions menu (), and then select Disable billing. You're prompted to confirm that you want to disable billing for this project.
Click Disable billing.
About project charges after billing is disabled
After you disable billing on a project, charges already incurred prior to disabling billing on the project are billed to the previously linked Cloud Billing account. This can include charges that haven't yet been reported in the transaction history. Depending on the service, it might take up to two days for charges to be reported to the transaction history.
Related topics
- View linked projects
- Create, modify, or close your Cloud Billing account
- Change payments contacts and notifications
- View your cost and payment history
- View your Cloud Billing reports and cost trends
Try it for yourself
If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
Get started for free