Uploading and managing files
You can upload, manage, and delete files from the Files page in your Shopify admin.
Files on the Files page can include:
- images and videos used in your theme, blog posts, and pages
- images and videos used in your products and collections
- files and videos that you want to make available for customers to download
- images and files connected to metafields
You can also upload files when you're editing your theme, when you're creating metafields, or when you're using the rich text editor to edit theme content, a page, a blog post, a product description, or a collection description. The files you upload display on your Files page.
To access the Files page, go to Content > Files.
On this page
- File requirements
- Upload a file on the Files page
- Search and filter the file list
- Change the sort order of the file list
- Make a file available for download
- Original media downloads
- Editing files
- Delete a file
- Replacing files
- Edit files without overwriting the existing file
- File storage limits by plan
File requirements
You can upload files to the Files page in your Shopify admin. Files must meet the following requirements:
Image file requirements
Attribute | Requirement |
---|---|
File size | Maximum of 20 MB (megabytes) |
Resolution | Maximum of 20 MP (megapixels) |
Aspect ratio | Between 100:1 and 1:100 |
File formats | JPEG, PNG, WEBP, HEIC, and GIF |
File names | File names may contain letters, numbers, spaces, and symbols, but must not begin with a period .
|
Video file requirements
Attribute | Requirement |
---|---|
File size | Maximum of 1 GB (gigabyte) |
Resolution | Maximum resolution of UHD |
Video length | Maximum video length of 10 minutes |
File formats | MOV, MP4, and WEBM |
Minimum width and height | 100 pixels |
Maximum width and height | 4096 pixels |
Maximum frame rate | 120 frames per second |
Minimum video length | 0.25 seconds |
File names | File names may contain letters, numbers, spaces, and symbols, but must not begin with a period .
|
Recommended video specifications
Feature | Recommendation |
---|---|
Aspect ratio | The aspect ratio should be one of the following:
|
Bitrates | Shopify's video pipeline will process incoming videos and auto select the best quality by analyzing the input media and selecting an appropriate bitrate from the ranges below.
|
Frame rate |
|
Resolution |
|
Supported codecs |
|
Supported color spaces |
|
Generic file requirements
Generic files can be any file other than HTML, and are intended for downloading by the customer.
Attribute | Requirement |
---|---|
File size | Maximum of 20 MB |
File formats | Any file type except HTML |
File names | File names may contain letters, numbers, spaces, and symbols, but must not begin with a period .
|
File format requirements
If you're on a paid plan, then you can upload any file format other than HTML.
If you're on a trial plan, then you can upload only the following file formats:
- JS
- CSS
- GIF
- JPEG
- PNG
- JSON
- CSV
- WebP
- HEIC
You also need to verify your email address before you can upload PDF files.
If you're on a trial plan and you want to upload other file formats, then check and update your plan.
Different parts of your store, such as your theme, pages, and blogs, only support certain file formats. For more information about supported file formats, refer to the following resources:
- Using the rich text editor: for pages, blog posts, product and collection descriptions, and theme elements
- Uploading media: for images and videos in your theme
Upload a file on the Files page
You can upload files to Shopify on the Files page. You can then use the uploaded files across your Shopify admin, including as brand images, product media, and metaobjects.
Steps:
Search and filter the file list
You can filter the file list or search for a file from the Files page or in the File picker.
You can filter your files in the following ways:
- Search file attributes, including file names and types, using the search bar
- Filter by size using the File size drop-down menu
- Filter by type using the File type drop-down menu
- Filter by file reference using the Used in drop-down menu
Steps:
Save filter view
If you need to perform the same searches or filter by the same terms regularly, then you can save the filters as views so that they're more easily accessible. Saved views are added as tabs at the top of the Files page. You can click the tab to filter the files using the saved filter parameters.
Steps:
Change the sort order of the file list
By default, files are listed from newest to oldest based on the date that they were uploaded.
If you want to change the sort order, then you can sort your files by date added, by size, or alphabetically by file name.
Steps:
Make a file available for download
If you want to make a file available for visitors to download, then you can upload it using the Files page, then add a link to it in a page's content or in your online store navigation. You can copy a link to the file to your clipboard by clicking the Link button beside the file.
Original media downloads
Shopify's Imagery service manages your images and videos to ensure the best possible format is displayed at the appropriate place in your online store.
You can download the original, unoptimized file to your device using the download button in the Preview and edit window.
Steps:
Editing files
You can preview and edit files by clicking the file's thumbnail from the Files page. Edits that you make on the Files page apply to all places the file is used in your store.
Review the following table to learn more about how to edit your files:
Action | Description |
---|---|
Rename a file | Update the name of your file by changing the URL Handle of your file. When you change your file's URL, the previous URL for that file no longer works. |
Replace a file | Replace an existing file with a new file, and keep the same file name and URL handle. You can replace a file only with the same file format, such as replace a JPG file with another JPG file. |
Add alt text | Add a brief description of the image or video for people with visual impairment or low-bandwidth connections. |
Add a focal point to an image | Select the most important part of the image to help themes crop the image more intelligently. |
Update a video cover image | Update the video cover image that acts as a preview image for your video. |
You can also edit media files using the media editor and media generation powered by Shopify Magic.
To make other types of edits, download the file, make the edits in an editing software of your choice, and then upload it again to the Files page.
Delete a file
You can delete one or more files from the Files page. Learn more about bulk actions.
Steps:
Replacing files
- From your Shopify admin, go to Content > Files.
- Click the Replace icon next to the file name.
- Select the file that you want to upload.
Edit files without overwriting the existing file
In the file editor, it's possible to make destructive edits to an image, such as changing the background of an image. To make changes without overwriting an existing file, save the changes as new.
Steps:
- From your Shopify admin, go to Content > Files.
- Select a media file to open the file editor.
- Make file edits.
- From the Save dropdown menu, select Save as new.
Saving as new saves the new file to your store's file system while preserving the original image in its original state.
File storage limits by plan
Plan | Limit per store |
---|---|
Shopify Enterprise | 10 TB (terabyte) |
Shopify Plus | 300 GB (gigabyte) |
Advanced | 300 GB (gigabyte) |
Shopify | 300 GB (gigabyte) |
Basic | 100 GB (gigabyte) |
Starter | 100 GB (gigabyte) |
Retail | 100 GB (gigabyte) |