---
title: FileUpdatePayload - GraphQL Admin
description: Return type for `fileUpdate` mutation.
api_version: 2025-07
api_name: admin
type: payload
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/2025-07/payloads/fileupdatepayload
  md: https://shopify.dev/docs/api/admin-graphql/2025-07/payloads/fileupdatepayload.md
---

# File​Update​Payload

payload

Return type for `fileUpdate` mutation.

## Fields

* files

  [\[File!\]](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/File)

  The list of updated files.

* user​Errors

  [\[Files​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/FilesUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [file​Update](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/fileUpdate)

  mutation

  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.

  ***

  **Note:** Files must be in \<code>ready\</code> state before they can be updated. The mutation includes file locking to prevent conflicts during updates. You can\&#39;t simultaneously update both \<code>\<span class="PreventFireFoxApplyingGapToWBR">original\<wbr/>Source\</span>\</code> and \<code>\<span class="PreventFireFoxApplyingGapToWBR">preview\<wbr/>Image\<wbr/>Source\</span>\</code>.

  ***

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

  * [`fileCreate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/fileCreate): Create new file assets from external URLs or staged uploads.
  * [`fileDelete`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/fileDelete): Remove files from your store when they are no longer needed.

  Learn how to manage [product media and file assets](https://shopify.dev/docs/apps/build/online-store/product-media) in your app.

  * files

    [\[File​Update​Input!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/input-objects/FileUpdateInput)

    required

    ### Arguments

    List of files to be updated.

  ***

***

## Map

### Mutations with this payload

* [file​Update](https://shopify.dev/docs/api/admin-graphql/2025-07/types/fileUpdate)