Google Cloud Storage

Setup instructions

Account permissions

  1. Log in to your Google Cloud console.
  2. From your dashboard, click on the projects drop down at the top to see a list of all your projects. Note the ID of the project that contains the bucket you want to connect to. Click on that project.

    Google Storage projects drop down

  3. On your dashboard, look for IAM & Admin and click on it.
  4. On the IAM screen, click Add at the top.
  5. In the New members field that comes up, enter:
  6. From the Select a role drop down choose Cloud Storage and then Storage Admin. Click Save.

    Google Storage projects drop down

Bucket info

  1. Go back to your dashboard and look for Storage and click on it.
  2. On the Storage browser screen, note the bucket name of the bucket you want to connect to.
  3. Make sure your bucket's settings allow for your images to be viewed publicly.

Finishing up in Blocks Edit

  1. In Blocks Edit, next to your organization at the top, click the integrations icon (). Note: You’ll see the integration option only if you are an admin or owner on the account.
  2. Click the Add button next to Google Cloud Storage.
  3. Enter your bucket name in the Home Bucket field.
  4. Enter your project ID in the Project Id field.
  5. You can override your image permissions with the ACL option, or leave it as is to use your bucket's settings.
  6. If you've setup a Custom Domain for your bucket, enter it here.
  7. Click Save Settings to finish the setup.

Using its features

Once the integration is in place, you can use the Google Cloud Storage specific features with your theme. Here’s what you can do:

Theme access settings

You will need to enable your integration for each theme that you want to allow using as a source for images in the editor. You can do this in the dashboard by clicking on the preferences icon () on the right side of a theme title.

When enabled, the option to set a base directory to access images from is available. For example, if you want to limit access to a certain project folder.

Theme settings

Note: you will need to be an admin or owner on the account to have access to these settings.

Accessing your remote images

In the editor, when adding in images, along with being able to upload local images, next to the upload option will also be an option to import from your GCS bucket files where you can browse and preview images to pick the one you need.

Note: this will not appear as an option if it has been disabled for a particular theme by an account admin or owner.


When you’re ready to export your email or page, you will be able to choose where you want to save it on your GCS bucket along with your modified images. The URLs will automatically update in your HTML file.


Still have questions? Message us.