General
ID
Description | Example Value |
Shopify's unique file identifier |
|
If present, the ID will be used to group multiple rows together into a single file. When importing, the ID will be used to see if the file already exists on the store. If there's no ID match the app will attempt to find an existing file using the File Name.
File Name
Description | Example Value |
Name of the file |
|
The file name is used for finding an existing file on the store if the ID is not present.
When renaming a file, the new name must include the file extension (e.g., summer-collection-new.jpg, not summer-collection-new). The extension must match the original file's extension. Renaming a file does not convert it to a different format. For example, renaming a .png file to .webp will not convert the image to WebP format.
Command
Description | Example Value |
Action to perform: MERGE, DELETE, NEW |
|
MERGE: Update existing file or create if not found
DELETE: Remove the file from the store (will skip if file doesn't exist)
NEW: Create a new file (will skip if file already exists)
Link
Description | Example Value |
URL to access the file |
|
The direct URL where the file can be accessed. When importing, this should be a publicly accessible URL that Shopify can download from.
Google Drive share links are also supported. Use the public shareable URL format: https://drive.google.com/file/d/1NvoqrhistNz3MVivgExVxm52qycb1agT/view
Dropbox share links are also supported. Both old-style and new-style link formats work:
https://www.dropbox.com/s/abc123/file.jpg?dl=0https://www.dropbox.com/scl/fi/abc123/file.jpg?rlkey=xyz&dl=0
Alt Text
Description | Example Value |
Alternative text description |
|
Alternative text for accessibility and SEO purposes. Particularly important for images to describe their content.
Created At
Description | Example Value |
When file was uploaded |
|
The timestamp when the file was originally uploaded to Shopify.
ISO-formatted timestamps (eg, 2023-06-01T10:00:00Z) are also supported. If no timezone is specified, the store's timezone will be used.
Type
Description | Example Value |
Type of media content: IMAGE, VIDEO, MODEL_3D, FILE, EXTERNAL_VIDEO |
|
IMAGE: Standard image files (JPEG, PNG, GIF, etc.)
VIDEO: Video files uploaded to Shopify
MODEL_3D: 3D model files for augmented reality
FILE: General file attachments
EXTERNAL_VIDEO: Videos hosted on external platforms like YouTube or Vimeo
Mime Type
Description | Example Value |
File's MIME type |
|
The MIME type identifies the format of the file content. Common examples include image/jpeg, image/png, video/mp4, model/gltf-binary.
Width
Description | Example Value |
Image width (pixels) - Export only |
|
The width of the image in pixels. This field is export-only and cannot be imported.
Height
Description | Example Value |
Image height (pixels) - Export only |
|
The height of the image in pixels. This field is export-only and cannot be imported.
Duration
Description | Example Value |
Length of video/audio (seconds) - Export only |
|
The duration of video or audio files in seconds. This field is export-only and cannot be imported. For non-video files, this value is typically 0.
Status
Description | Example Value |
Current file status: READY, FAILED, PROCESSING, UPLOADED |
|
READY: File has been successfully processed and is available
FAILED: File processing failed
PROCESSING: File is currently being processed
UPLOADED: File has been uploaded but not yet processed
Errors
Description | Example Value |
Any upload/processing errors - Export only |
|
Details about any errors that occurred during file upload or processing. This field is export-only and shows error information when files fail to process correctly.
Size Bytes
Description | Example Value |
File size (bytes) - Export only |
|
The exact file size in bytes. This field is export-only and cannot be imported.
Size MB
Description | Example Value |
File size (megabytes) - Export only |
|
The file size converted to megabytes for easier reading. This field is export-only and cannot be imported.
Size
Description | Example Value |
Human-readable file size - Export only |
|
A human-readable representation of the file size with appropriate units (KB, MB, GB). This field is export-only and cannot be imported.
Match URLs to Existing Files
A URL for an image or file in an import is downloaded and uploaded to your store as a new file except if the URL is from your own store. URLs from anywhere else (including another store) are downloaded every time, so if you import the same URLs again (for example, re-running a store copy where image URLs still point at the source store), the files are uploaded again and duplicates appear in Content > Files.
Enable the Match URLs to existing files option on the import setup page to avoid this. When it's on, Altera determines each URL's filename and checks whether a file with that name already exists in your store's files. If it does, the existing file is reused; if not, the URL is downloaded and uploaded as usual.
The option applies wherever an import accepts a file URL:
Product and variant images (
Image Src,Variant Image)Metafields and metaobject fields that reference files
The Files sheet
This option only affects URLs from outside your store. Cells that contain a plain filename (like blue-shirt.jpg) or a Shopify CDN URL from your own store always match against your store's existing files, whether or not the option is enabled.
Matching is by filename only. If two different files share the same filename, the existing file is used and the URL is not downloaded.
Export Filters
You can use these filters to limit which files are exported:
media_type: Filter by media type (IMAGE, EXTERNAL_VIDEO, MODEL_3D, VIDEO, FILE)filename: Filter by filename
