Metadata Xfer Not Supported -
# Re‑upload with metadata gsutil cp gs://src-bucket/file.txt - | \ gsutil -h "x-goog-meta-$CUSTOM" cp - gs://dest-bucket/file.txt Add a metadata filter to your sync profile:
All of those attributes travel with the payload when you move data the same system (e.g., copy a file on a Linux box). But once you cross a boundary—different OS, different API, different cloud provider— the contract changes . metadata xfer not supported
[remote] type = "s3" provider = "AWS" metadata = false # disables user‑defined metadata copy Or, if you need the metadata, map it: # Re‑upload with metadata gsutil cp gs://src-bucket/file
# 2️⃣ Extract only the fields you care about (e.g., custom user metadata) CUSTOM=$(jq -r '.Metadata' src-meta.json) | |---|---| | Common culprits | Cloud storage
Posted on April 17, 2026 • By ChatGPT TL;DR | Symptom | “Metadata transfer not supported” error (or similar) appears when you try to copy/move a file or object and the underlying service can’t preserve its extra attributes (timestamps, ACLs, tags, etc.). | |---|---| | Common culprits | Cloud storage SDKs (AWS S3, Azure Blob, Google Cloud Storage), on‑premise backup tools, FTP/SFTP clients, container image registries, data‑lake migration utilities. | | Why it happens | The source and destination have different metadata models, or the transfer protocol simply doesn’t expose a “metadata‑copy” operation. | | Quick fix | Explicitly tell the tool to skip metadata, or map it to a supported format; upgrade to a newer client/SDK; use a staging area that understands both sides. | | Long‑term fix | Align your data‑governance strategy with the capabilities of the storage platform, and automate metadata handling in your pipelines. | 1️⃣ What Is “Metadata” Anyway? When you hear “metadata” in the context of files, objects, or containers, think of the data about the data :
# 3️⃣ Apply tags after copy (if supported in target region) az storage blob tag set \ --container-name destc \ --name path/file.txt \ --account-name destacct \ --tags @src-tags.json – Azure separates blob metadata (user‑defined key/value) and blob tags (indexable key/value). The copy API only moves the blob data and metadata ; tags need a second call. 5.3 Google Cloud Storage – Using gsutil cp -p # The -p flag copies ACLs and metadata, but NOT custom object metadata between # different storage classes. If that fails, drop the flag: gsutil cp -p gs://src-bucket/file.txt gs://dest-bucket/file.txt || \ gsutil cp gs://src-bucket/file.txt gs://dest-bucket/file.txt If you do need custom metadata:
# Capture metadata gsutil stat -j gs://src-bucket/file.txt > src-meta.json
