Requires write_files access scope or write_themes access scope.

Updates an existing file asset that was uploaded to Shopify.


List of files to be updated.


Was this section helpful?

The list of updated files.

The list of errors that occurred from executing the mutation.


Was this section helpful?

Examples

Hide code
DescriptionCopy
mutation FileUpdate($input: [FileUpdateInput!]!) {
  fileUpdate(files: $input) {
    userErrors {
      code
      field
      message
    }
    files {
      alt
    }
  }
}
curl -X POST \
https://your-development-store.myshopify.com/admin/api/2024-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation FileUpdate($input: [FileUpdateInput!]!) { fileUpdate(files: $input) { userErrors { code field message } files { alt } } }",
 "variables": {
    "input": {
      "id": "gid://shopify/GenericFile/1072273203",
      "alt": "new alt text"
    }
  }
}'
const { admin } = await authenticate.admin(request);

const response = await admin.graphql(
  `#graphql
  mutation FileUpdate($input: [FileUpdateInput!]!) {
    fileUpdate(files: $input) {
      userErrors {
        code
        field
        message
      }
      files {
        alt
      }
    }
  }`,
  {
    variables: {
      "input": {
        "id": "gid://shopify/GenericFile/1072273203",
        "alt": "new alt text"
      }
    },
  },
);

const data = await response.json();
session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation FileUpdate($input: [FileUpdateInput!]!) {
    fileUpdate(files: $input) {
      userErrors {
        code
        field
        message
      }
      files {
        alt
      }
    }
  }
QUERY

variables = {
  "input": {
    "id": "gid://shopify/GenericFile/1072273203",
    "alt": "new alt text"
  }
}

response = client.query(query: query, variables: variables)
const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation FileUpdate($input: [FileUpdateInput!]!) {
      fileUpdate(files: $input) {
        userErrors {
          code
          field
          message
        }
        files {
          alt
        }
      }
    }`,
    "variables": {
      "input": {
        "id": "gid://shopify/GenericFile/1072273203",
        "alt": "new alt text"
      }
    },
  },
});
use Shopify\Clients\Graphql;

$client = new Graphql("your-development-store.myshopify.com", $accessToken);
$query = <<<QUERY
  mutation FileUpdate($input: [FileUpdateInput!]!) {
    fileUpdate(files: $input) {
      userErrors {
        code
        field
        message
      }
      files {
        alt
      }
    }
  }
QUERY;

$variables = [
  "input" => [
    "id" => "gid://shopify/GenericFile/1072273203",
    "alt" => "new alt text",
  ],
];

$response = $client->query(["query" => $query, "variables" => $variables]);
Hide code
Input variables
Copy
{
  "input": {
    "id": "gid://shopify/GenericFile/1072273203",
    "alt": "new alt text"
  }
}
Hide code
Response
JSON
{
  "fileUpdate": {
    "userErrors": [],
    "files": [
      {
        "alt": "new alt text"
      }
    ]
  }
}