FileDeletePayload

The IDs of the deleted files.

The list of errors that occurred from executing the mutation.

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.