gcloud compute project-info add-metadata [--metadata=KEY=VALUE,[KEY=VALUE,…]] [--metadata-from-file=KEY=LOCAL_FILE_PATH,[…]] [GCLOUD_WIDE_FLAG …]
gcloud compute project-info add-metadata can be used to add or
update project-wide metadata. Every instance has access to a metadata server
that can be used to query metadata that has been set through this tool.
Project-wide metadata entries are visible to all instances. To set metadata for
individual instances, use gcloud compute
instances add-metadata. For information on metadata, see https://cloud.google.com/compute/docs/metadata
Only metadata keys that are provided are mutated. Existing metadata entries will remain unaffected.
If you are using this command to manage SSH keys for your project, please note the risks of manual SSH key management as well as the required format for SSH key metadata, available at https://docs.cloud.google.com/compute/docs/connect/add-ssh-keys--metadata=KEY=VALUE,[KEY=VALUE,…]--metadata
key-1=value-1,key-2=value-2,key-3=value-3. The combined
total size for all metadata entries is 512 KB.
In images that have Compute Engine tools installed on them, such as the official images, the
following metadata keys have special meanings:
startup-script--metadata-from-file can be used to pull
the value from a file.
startup-script-urlstartup-script except that the
script contents are pulled from a publicly-accessible location on the web.
For startup scripts on Windows instances, the following metadata keys have
special meanings:
windows-startup-script-url,
windows-startup-script-cmd,
windows-startup-script-bat,
windows-startup-script-ps1,
sysprep-specialize-script-url,
sysprep-specialize-script-cmd,
sysprep-specialize-script-bat, and
sysprep-specialize-script-ps1. For more
information, see Running startup
scripts.
At least one of [--metadata] or [--metadata-from-file] is required.
--metadata-from-file=KEY=LOCAL_FILE_PATH,[…]--metadata except that the value
for the entry will be read from a local file. This is useful for values that are
too large such as startup-script contents.
At least one of [--metadata] or [--metadata-from-file] is required.
--access-token-file,
--account, --billing-project,
--configuration,
--flags-file,
--flatten, --format, --help, --impersonate-service-account,
--log-http,
--project, --quiet, --trace-token, --user-output-enabled,
--verbosity.
Run $ gcloud help for details.
gcloud alpha compute project-info add-metadatagcloud beta compute project-info add-metadatagcloud preview compute project-info add-metadata
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.