· DataEase · Documentation  · 2 min read

Files

Files are the images, videos, and 3-D models you upload to Shopify.
With DataEase you can:

  • Rename many file names or alt texts at once.
  • Delete old media in bulk.
  • Replace product images without opening each product.

Shopify’s file-upload guide.

Table of Contents

  1. Export
  2. Import
  3. Field reference
  4. Filters

2. Export

  1. Pick CSV or Excel.
  2. Select Files as the entity.
  3. Choose fields like filename, mimeType, or fileStatus.
  4. Run the task and download your file.

Full steps: Export guide

3. Import

Supported commands in command column: CREATE, UPDATE, REPLACE, DELETE, IGNORE

Use the correct media type (IMAGE, VIDEO, MODEL_3D, EXTERNAL_VIDEO).

If you upload a file with a name that already exists, Shopify adds a hash to keep it unique.

  1. Download the sample file: Files-import-sample.xlsx
  2. Fill the sheet (at least filename and mimeType for CREATE).
  3. Map columns in DataEase, upload, and start the import.

More detail: Import guide
File size and format limits.

4. Field reference

id

Unique file ID. Needed for UPDATE, DELETE, or REPLACE.

command

Action for the row: CREATE, UPDATE, REPLACE, DELETE, IGNORE.

alt

Alt text that describes the file. Helpful for SEO and screen readers.

createdAt

Date the file was uploaded. Export only.

updatedAt

Last time the file changed. Export only.

fileStatus

UPLOADED, PROCESSING, READY, or FAILED. Export only.

fileErrors

Error code if upload or processing failed. Export only.

mimeType

File MIME type, like image/png or video/mp4.

url

Public URL of the file. Export only.

fileSize

Original file size in bytes. Export only.

filename

Name of the file (must be unique).

height

Image height in pixels. Export only.

width

Image width in pixels. Export only.

duration

Video length in milliseconds. Export only; shows when fileStatus is READY.

videoFormat

Source file extension for videos (mp4, mov). Export only.

mediaContentType

File type: IMAGE, VIDEO, MODEL_3D, or EXTERNAL_VIDEO. Export only.

5. Filters

CreatedAt

Export files uploaded on a date or range.

Filename

Export files where filename contains the text you enter.

Id

Export a specific file by its ID.

MediaType

Filter by media type (IMAGE, VIDEO, etc.).

OriginalUploadSize

Export files larger or smaller than a size (bytes).

ProductId

Export files linked to a specific product.

Status

Choose a fileStatus (READY, FAILED, etc.).

UpdatedAt

Export files updated in a date range.

UsedIn

Export files attached to Products, Collections, or not used at all.

Need help? Our support team replies in under 24 hours.

Share: