Files

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude

Overview

The Files feature lets merchants upload storefront assets (images, videos, documents, fonts, and code files) and use them on the storefront using public URLs.

These URLs are designed to be stable, meaning merchants can update file content without changing the URL, ensuring storefront references remain intact.

The public URL format of the files is domain/files/{file_name}

Important considerations:

• Max file size: 1 MB per file
• Supported file types:
  • Images: PNG, JPEG, JPG, GIF, WEBP, BMP, SVG, AVIF, XML, TIFF
  • Videos: MP4, WEBM, OGG, FLV, M3U8, TS, 3GP, MOV, AVI, WMV
  • Documents: CSV, XLSX, PPT, PPTX, PDF, PPTX, DOC, DOCX, ODF, XLS, SQL, ODP, ODS, ODT
  • Others: CSS, JS, HTML, WOFF, WOFF2
• File name can have a maximum of 30 characters
• File name can use only letters (a–z), numbers (0–9), hyphen (-), underscore (_), and dot (.).

Best practice:

• Use clear, stable filenames and avoid versioned naming (for example, banner_final_v4.png) if the intent is to keep a single long-term URL.

How to add a file

1. Files can be uploaded through 3 methods:
   1. Upload File: Click Upload File and select a file from your system.
   2. Drag and Drop: Drag a file into the upload area on the page.
   3. Add URL (optional): Click Add URL to add a file using an existing hosted URL.
2. Select the file name to be used.
3. Click on the upload button.

Existing file name behaviour

1. When a new file is provided a file name belonging to an existing file, then the user is provided the option to replace the existing file

File listing table

1. The table lists all uploaded files with the following columns:
   1. Filename - This column shows the file name along with its extension.
   2. Type - This column shows the file category, such as Images, Videos, Documents, or Others.
   3. Size - This column shows the size of the uploaded file.
   4. Created - This column shows the date and time when the file was added to the storefront.
   5. Actions - This column provides actions you can take on the file, such as deleting it from the storefront.
2. It also supports:
   1. Search by file name - Merchants can search for a file by entering its name in the search field.
   2. Filter by type - Merchants can filter the list to view files of a specific type.

How to delete a file

1. Locate the file in the table.
2. Under Actions, click the delete icon.
3. Confirm deletion.

Once deleted, the public URL stops working and any storefront references to that file will fail.