Sample File
This sample file shows the basic columns that you need to set in order to import files to Shopify.
Download sample Files Import File.
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.
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
NEW: Create a new file (will fail 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.
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.
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