File reference metafields now support multiple input formats, making it easier to reference files in your Shopify store without needing to know the exact GID.
🚀 What’s New#
- URL support – Import file reference metafields using external URLs or Shopify CDN URLs
- Filename lookup – Reference existing files by filename instead of GID
- Automatic file upload – External URLs are automatically uploaded to Shopify and linked
🔧 Improvements#
- More flexible imports – Use GIDs, filenames, CDN URLs, or external URLs for file references
- Smarter file handling – Shopify CDN URLs from your store are automatically matched to existing files
- Seamless workflow – External URLs are uploaded and linked without manual steps
📝 How It Works#
When importing file reference metafields, you can now use:
- GID format:
gid://shopify/MediaImage/123456789– Direct Shopify file GID - Filename:
image.jpg– Looks up existing file by filename - Shopify CDN URL:
https://cdn.shopify.com/s/files/1/0694/7382/9050/files/image.jpg– Extracts filename and looks up existing file - External URL:
https://example.com/image.jpg– Uploads file to Shopify and returns GID
This works for both single file references and list file references (list.file_reference).