File reference metafields support URLs

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).