This page describes the relationship between Google Cloud Platform Console projects and Cloud Storage resources. You can create multiple projects and use them to organize your Cloud Platform resources, including your Google Cloud Storage data, into logical groups. To learn more about Google Cloud Platform Console projects, read Projects in the Overview of Google Cloud Platform.

When to specify a project

Certain Google Cloud Storage operations require you to specify a project. In these cases, you can use either the project ID or the project number:

Google Cloud Platform Console
Before you create a bucket or list buckets using the Google Cloud Platform Console, you must select a project. For more information, see Creating a bucket.
The gsutil mb and gsutil ls commands require you to specify a project unless you have used gsutil config to set a default project. If you have not set a default project, or if you would like to use a different project, you can use the -p flag to specify a project. No other gsutil commands require you to specify a project.

Only the list buckets and insert bucket methods require you to specify a project. The project is sent as a parameter in the request URL, as in the following example:


The Cloud Storage Client Libraries, which use the JSON API, also require a project to be specified when using the libraries' methods for creating and listing buckets.


The project associated with XML API requests is specified in the x-goog-project-id HTTP header, as in the following example:

x-goog-project-id: [PROJECT_ID]

The header is used when creating a bucket or listing buckets, but is optional for other requests or if you have set a default project for interoperable access.

Project members and permissions

For each project, you can add team members to manage and work on your project and specify each team member's role. Team members receive the following permissions based on their roles:

  • All Project Team Members

    All project team members can list buckets within a project.

  • Project Editors

    All project editors can list, create, and delete buckets.

  • Project Owners

    All project owners can list, create, and delete buckets, and can also perform administrative tasks such as adding and removing team members and changing billing. The project owners group is the owner of all buckets within a project, regardless of who originally created the bucket.

For more information, see Manage Project Members.

Each team member also has additional permissions based on the access control list (ACL) that is applied to the bucket. When you create a bucket without specifying an ACL, the project-private ACL is applied to the bucket automatically. See Default bucket ACL for details about the permissions that are granted by the project-private ACL.

What's next?

Send feedback about...

Cloud Storage Documentation