FilesUserError

The error code.

The path to the input field that caused the error.

The error message.

Acknowledges file update failure by resetting FAILED status to READY and clearing any media errors.

Creates file assets for a store from external URLs or files that were previously uploaded using the stagedUploadsCreate mutation.

Use the fileCreate mutation to add various types of media and documents to your store. These files are added to the Files page in the Shopify admin and can be referenced by other resources in your store.

The fileCreate mutation supports multiple file types:

• Images: Product photos, variant images, and general store imagery
• Videos: Shopify-hosted videos for product demonstrations and marketing
• External videos: YouTube and Vimeo videos for enhanced product experiences
• 3D models: Interactive 3D representations of products
• Generic files: PDFs, documents, and other file types for store resources

The mutation handles duplicate filenames using configurable resolution modes that automatically append UUIDs, replace existing files, or raise errors when conflicts occur.

After creating files, you can make subsequent updates using the following mutations:

• fileUpdate: Update file properties such as alt text or replace file contents while preserving the same URL.
• fileDelete: Remove files from your store when they are no longer needed.

To list all files in your store, use the files query.

Learn how to manage product media and file assets in your app.

Deletes file assets that were previously uploaded to your store.

Use the fileDelete mutation to permanently remove media and file assets from your store when they are no longer needed. This mutation handles the complete removal of files from both your store's file library and any associated references to products or other resources.

The fileDelete mutation supports removal of multiple file types:

• Images: Product photos, variant images, and general store imagery
• Videos: Shopify-hosted videos for product demonstrations and marketing content
• External Videos: YouTube and Vimeo videos linked to your products
• 3D models: Interactive 3D representations of products
• Generic files: PDFs, documents, and other file types stored in your Files page

When you delete files that are referenced by products, the mutation automatically removes those references and reorders any remaining media to maintain proper positioning. Product file references are database relationships managed through a media reference system, not just links in product descriptions. The Shopify admin provides a UI to manage these relationships, and when files are deleted, the system automatically cleans up all references. Files that are currently being processed by other operations are rejected to prevent conflicts.

Learn how to manage product media and file assets in your app.

Updates properties, content, and metadata associated with an existing file asset that has already been uploaded to Shopify.

Use the fileUpdate mutation to modify various aspects of files already stored in your store. Files can be updated individually or in batches.

The fileUpdate mutation supports updating multiple file properties:

• Alt text: Update accessibility descriptions for images and other media.
• File content: Replace image or generic file content while maintaining the same URL.
• Filename: Modify file names (extension must match the original).
• Product references: Add or remove associations between files and products. Removing file-product associations deletes the file from the product's media gallery and clears the image from any product variants that were using it.

The mutation handles different file types with specific capabilities:

• Images: Update preview images, original source, filename, and alt text.
• Generic files: Update original source, filename, and alt text.
• Videos and 3D models: Update alt text and product references.

After updating files, you can use related mutations for additional file management:

• fileCreate: Create new file assets from external URLs or staged uploads.
• fileDelete: Remove files from your store when they are no longer needed.

Learn how to manage product media and file assets in your app.