Domain-Named Bucket Verification

This page describes requirements for creating buckets with domain names and discusses verification methods for domain owners and site owners. To learn how to create a bucket, see the Creating storage buckets guide. For general information on bucket naming, see the Bucket and Object Naming Guidelines.

Requirements for domain-named buckets

Cloud Storage considers bucket names that contain dots to be domain names. As such, a bucket containing a dot in its name must:

  • Be a syntactically valid DNS name (for example, bucket..example.com is not valid because it contains two dots in a row).
  • End with a currently-recognized top-level domain, such as .com.
  • Be created by a user who is authorized to work with the domain name.

Examples of valid domain-named buckets include example.com, buckets.example.com, and www.example.co.uk.

Who can create a domain-named bucket

To create a bucket that uses a domain name, you must establish that you are authorized to use the domain name. People authorized to use a domain name include:

  • Verified owners of the domain or parent domain.
  • Verified site owners of the domain or parent domain.

Note, however, that if a domain has both types of people, only verified owners of the domain or parent domain can create the bucket. This allows the domain owners to tightly control who can create domain-named buckets.

For example, say you have an IT staff member who owns the website that uses http://reports.example.com. Once they go through verification of that site, they can create buckets such as reports.example.com and annual.reports.example.com. However, if you later verify that you own the domain example.com, only you can then create these buckets. Since you verified the domain example.com, you can also create the bucket example.com.

Domain ownership verification

If your project intends to have a domain-named bucket, the team member creating the bucket must demonstrate that they are authorized to create a bucket in the given domain. When you intend to host your domain's content in a Cloud Storage bucket, the recommended verification method is to verify domain ownership.

Cloud Storage uses the Domain name provider method in the Search Console to verify domain ownership.

To verify domain ownership:

  1. Open Search Console. You must be signed in with the Google account that you will to use to manage ownership of your domain.

    Open Search Console

  2. If you do not have other properties in the Search Console:

    Click the Add a property button, enter the URL you want to verify in the text box, and click Continue.

  3. Select the provider of your domain from the drop-down list.

  4. Follow the instructions for your specific domain name provider.

Site ownership verification

For information on methods of verifying site ownership, see the help page on verifying your site ownership. Note that these methods require you to have an existing website for the domain you want to verify.

Additional verified owners

Once you have verified domain or site ownership, you can add additional owners, including services accounts. These users can also create buckets under the verified domain name.

To add domain owners:

  1. Go to the Search Console.
  2. Click the Manage property dropdown associated with the property that you want to add domain owners to.
  3. Select Add or remove users from the drop-down.
  4. Click the Manage property owners link.
  5. Click the Verification details link.
  6. Click the Add an owner button.
  7. In the text box, enter the email of the user you want to add.
  8. Click Continue.

To add site owners:

Follow these instructions for adding site owners.

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Storage
Need help? Visit our support page.