Files

With the Matrixify app, you can bulk import and export Shopify Files from Shopify Admin -> Settings -> Files section.

See what each field/column from our “Files” template means including possible allowed values and examples.

Fields marked with the “Exported only” tag cannot be imported/set in Shopify and but can be exported with the Matrixify export.

Excel Sheet Name

Files

To tell the app that you are importing Files you need:

If using CSV file then the file name needs to contain the word “Files”, for example, “my-shopify-files.csv”
If using XLSX file then the sheet/tab name in the file needs to be “Files”. The file name for the XLSX file does not matter.

Columns Available For Export And Import

Basic Columns

Column Description / Example Value

Column	Description / Example Value
ID	The ID is an automatically generated GID number by Shopify to identify the item. It is filled in by Export. When importing a new File, leave this value empty.Allowed ValuesText Example gid://shopify/MediaImage/33351235212327
File Name	Name of the file. Cannot be updated for a File, but this field will allow you to identify and update other updatable Files fields by using only the File Name.Allowed ValuesText Example red_shirt_123.jpg
Command	When importing a Files row – tell the app, what to do with it: `NEW`: will try to create a new File with the provided details. If such a File will already exist (with the same ID, File Name, or Link), then the result will be Failed. `MERGE`: will try to find the existing File, and update it with data from the row. If such a File will not be found, then it will create a new one. `UPDATE`: the app will search for an existing File and update it. If an item cannot be found then that item will fail to import. `REPLACE`: at first, if such File with provided ID, File Name, or Link exists, then the app will delete it. After that, it will create a new one. If an existing File will not be found, then still the app will create a new one. The difference from UPDATE is that it will not keep any of the columns, which were not included in the import file since the File will be deleted and re-created. `DELETE`: the app will delete the existing File, which is found by ID, File Name, or Link. If such a File will not be found, then the result will be Failed. This DELETE command is very handy for deleting Files in bulk. `IGNORE`: the app will ignore this File and will skip it. If no Command is specified, then the app will assume the MERGE command. Allowed Values NEW MERGE UPDATE REPLACE DELETE IGNORE Example MERGE
Link	Public Shopify CDN link to the File. You can copy the same link in your Shopify Admin Files section. When importing Files, here you can put a link from outside of Shopify. The app will pass that external link to Shopify for uploading to the Files section. If importing files from external links, the app will still check if such a file exists among Files by the file name from the provided URL. If it exists, it will regard that as being the same file. This allows you to do repeated imports and not to create duplicate files. Allowed ValuesURL Example https://cdn.shopify.com/s/files/1/2244/9876/1234/files/red_shirt_123.jpg?v=1612358112
Alt Text	Your files can be used in your store’s theme so, by SEO best practices, it is strongly suggested that images have “Alt Text” specified because this is how search engines know what is inside the file. Allowed ValuesText Example T-shirt red small size
Created At *Exported only*	The date and time when the file was created/added in your Shopify Files. Allowed ValuesText Example 2020-10-07 10:33:34 +0000
Type	The file type – an image or generic file. When importing – you can, for example, force images to be handled as generic files. If you do not specify the Type for import, then it will be automatically detected from the file contents. Allowed Values IMAGE FILE Example IMAGE
Mime Type *Exported only*	If File Type is `IMAGE` then you can see the image MIME type here. Allowed ValuesText Example image/jpeg
Image Width *Exported only*	If File Type is `IMAGE` then here you can see the image width in pixels. Allowed ValuesText Example 5184
Image Height *Exported only*	If File Type is `IMAGE` then here you can see the image height in pixels. Allowed ValuesText Example 3456
Status *Exported only*	Status of the file creation in Shopify: `Failed` – File processing has failed `Uploaded` – File has been uploaded but the processing hasn’t started yet `Processing` – File is being processed by Shopify `Ready` – File is ready to be displayed When importing Files to Shopify, the app will pass the file URL to Shopify. It might take a while to upload larger files, because it is up to Shopify to process them. If you do not see your uploaded file in the Shopify Admin -> Settings -> Files section, do an export of your files with the Matrixify app and check your file Status in this column. Allowed Values Failed Processing Ready Uploaded Example Ready
Errors *Exported only*	If the file has failed to be added/created in Shopify then here you will see the error. Allowed ValuesText Example red_shirt_123.jpg

The ID is an automatically generated GID number by Shopify to identify the item.
It is filled in by Export.
When importing a new File, leave this value empty.Allowed ValuesText
Example

gid://shopify/MediaImage/33351235212327

File Name

Name of the file.
Cannot be updated for a File, but this field will allow you to identify and update other updatable Files fields by using only the File Name.Allowed ValuesText
Example

red_shirt_123.jpg

Command

When importing a Files row – tell the app, what to do with it:

NEW: will try to create a new File with the provided details. If such a File will already exist (with the same ID, File Name, or Link), then the result will be Failed.
MERGE: will try to find the existing File, and update it with data from the row. If such a File will not be found, then it will create a new one.
UPDATE: the app will search for an existing File and update it. If an item cannot be found then that item will fail to import.
REPLACE: at first, if such File with provided ID, File Name, or Link exists, then the app will delete it. After that, it will create a new one. If an existing File will not be found, then still the app will create a new one. The difference from UPDATE is that it will not keep any of the columns, which were not included in the import file since the File will be deleted and re-created.
DELETE: the app will delete the existing File, which is found by ID, File Name, or Link. If such a File will not be found, then the result will be Failed. This DELETE command is very handy for deleting Files in bulk.
IGNORE: the app will ignore this File and will skip it.

If no Command is specified, then the app will assume the MERGE command.

Allowed Values

NEW
MERGE
UPDATE
REPLACE
DELETE
IGNORE

Example

MERGE

Link

Public Shopify CDN link to the File. You can copy the same link in your Shopify Admin Files section.

When importing Files, here you can put a link from outside of Shopify. The app will pass that external link to Shopify for uploading to the Files section.

If importing files from external links, the app will still check if such a file exists among Files by the file name from the provided URL. If it exists, it will regard that as being the same file. This allows you to do repeated imports and not to create duplicate files.

Allowed ValuesURL
Example

https://cdn.shopify.com/s/files/1/2244/9876/1234/files/red_shirt_123.jpg?v=1612358112

Alt Text

Your files can be used in your store’s theme so, by SEO best practices, it is strongly suggested that images have “Alt Text” specified because this is how search engines know what is inside the file.

Allowed ValuesText
Example

T-shirt red small size

Created At

Exported only

The date and time when the file was created/added in your Shopify Files.

Allowed ValuesText
Example

2020-10-07 10:33:34 +0000

Type

The file type – an image or generic file.

When importing – you can, for example, force images to be handled as generic files.

If you do not specify the Type for import, then it will be automatically detected from the file contents.

Allowed Values

IMAGE
FILE

Example

IMAGE

Mime Type

Exported only

If File Type is IMAGE then you can see the image MIME type here.

Allowed ValuesText
Example

image/jpeg

Image Width

Exported only

If File Type is IMAGE then here you can see the image width in pixels.

Allowed ValuesText
Example

Image Height

Exported only

If File Type is IMAGE then here you can see the image height in pixels.

Allowed ValuesText
Example

Status

Exported only

Status of the file creation in Shopify:

Failed – File processing has failed
Uploaded – File has been uploaded but the processing hasn’t started yet
Processing – File is being processed by Shopify
Ready – File is ready to be displayed

When importing Files to Shopify, the app will pass the file URL to Shopify. It might take a while to upload larger files, because it is up to Shopify to process them.
If you do not see your uploaded file in the Shopify Admin -> Settings -> Files section, do an export of your files with the Matrixify app and check your file Status in this column.

Allowed Values

Failed
Processing
Ready
Uploaded

Example

Ready

Errors

Exported only

If the file has failed to be added/created in Shopify then here you will see the error.

Allowed ValuesText
Example

red_shirt_123.jpg

Size MB

When exporting, selecting “Size MB” will include this field in the exported file for each File.

Column	Description / Example Value
Size MB *Exported only*	File size in MB. It is calculated by the app directly from each file Link. Depending of how Shopify CDN stores and optimizes files, it can be different than what you see in Shopify Admin -> Settings -> Files section. This will also make filtering by Size MB be a bit approximate, because filtering happens by the original file size, but the column shows the eventually processed CDN file size. Allowed Values Decimal Number Example 200.221

Column

Description / Example Value

Size MB

Exported only

File size in MB. It is calculated by the app directly from each file Link.
Depending of how Shopify CDN stores and optimizes files, it can be different than what you see in Shopify Admin -> Settings -> Files section.

This will also make filtering by Size MB be a bit approximate, because filtering happens by the original file size, but the column shows the eventually processed CDN file size.

Allowed Values

Decimal Number

Example

200.221

Excel Sheet Name

Columns Available For Export And Import

Basic Columns

Size MB

Start managing your Shopify data today!