Google Storage Assets

Google Storage Assets

Store Vendure assets on Google Cloud Storage.

npm install @pinelab/vendure-plugin-google-storage-assets
Latest version2.1.0
Compatibility>=2.2.0
Last publishedJul 15, 2025
Pinelab
PinelabWebshops for mission-driven brands and wholesalers

Official documentation here

Plugin for storing Vendure assets on Google Cloud Storage with support for pre-generated image presets.

Getting started

  1. Create a bucket which is publicly available in Google Cloud.
  2. Add this to your vendure-config.ts:
  1. Run a database migration to add the presets custom field to the Asset entity.

Image Presets

Presets allow you to pre-generate different versions of uploaded images. These versions are stored directly in your Google Cloud Storage bucket. This means you can get direct URLs to these pre-generated images without having to go through the Vendure asset server.

When an asset is uploaded, all configured presets are automatically generated. Each preset generates a new file in your bucket.

Fetching Preset URLs

You can fetch preset URLs through the Shop API using this query:

:warning: Whenever you change the presets, or set presets for the first time,you need to re-generate the presets for all assets. This can be done by running the generateGoogleStorageAssetPresets mutation.

Generating Presets for Existing Assets

To generate presets for all existing assets, you can use the Admin API. You will need to have Asset Update permission to run this mutation.

Running locally

Using this plugin on your local machine requires you to be logged in to Google Cloud, so that the plugin can upload assets to your bucket.

  1. Run gcloud auth application-default login
  2. Create a .env file with the following contents:
  1. Run yarn start and go to https://localhost:3050/admin to test asset uploads

Google Cloud Storage Authentication

Internally this plugin uses new Storage(); to instantiate the Storage client, which uses ENV variables to authenticate:

// By default, the client will authenticate using the service account file // specified by the GOOGLE_APPLICATION_CREDENTIALS environment variable and use // the project specified by the GCLOUD_PROJECT environment variable. See // https://cloud.google.com/docs/authentication/production#providing_credentials_to_your_application

For more information about Google Cloud authentication, see: https://cloud.google.com/compute/docs/tutorials/nodejs-guide