---
title: FileSetInput - GraphQL Admin
description: The input fields required to create or update a file object.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/input-objects/FileSetInput'
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/FileSetInput.md
api_name: admin
api_type: graphql
type: input-object
---

# File​Set​Input

input\_object

The input fields required to create or update a file object.

## Fields

* alt

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The alt text description of the file for screen readers and accessibility.

* content​Type

  [File​Content​Type](https://shopify.dev/docs/api/admin-graphql/latest/enums/FileContentType)

  The file content type. If omitted, then Shopify will attempt to determine the content type during file processing.

* duplicate​Resolution​Mode

  [File​Create​Input​Duplicate​Resolution​Mode](https://shopify.dev/docs/api/admin-graphql/latest/enums/FileCreateInputDuplicateResolutionMode)

  Default:APPEND\_UUID

  How to handle if filename is already in use.

* filename

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The name of the file. If provided, then the file is created with the specified filename. If not provided, then the filename from the `originalSource` is used.

* id

  [ID](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  The ID of an existing file.

* original​Source

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The source URL of the file. An external URL can be used for images, generic files, or external videos. Videos and 3D models require a [staged upload URL](https://shopify.dev/api/admin-graphql/latest/mutations/stageduploadscreate).

***

## Input objects using this input

* [Gift​Card​Product​Set​Input.files](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/GiftCardProductSetInput#fields-files)

  INPUT OBJECT

  The input fields for creating or updating a gift card product with the [`giftCardProductSet`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardProductSet) mutation.

  For list fields like [`variants`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardProductSet#arguments-input.fields.variants), the mutation creates new entries, updates existing ones, and deletes any entries not included in the input. All other fields update only when explicitly provided, leaving omitted fields unchanged.

* [Gift​Card​Product​Variant​Set​Input.file](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/GiftCardProductVariantSetInput#fields-file)

  INPUT OBJECT

  The input fields for specifying a gift card product variant to create or update with the [`giftCardProductSet`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardProductSet) mutation.

  Include an [`id`](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/GiftCardProductSetVariantInput#field-GiftCardProductSetVariantInput.fields.id) to update an existing variant, or omit it to create a new one. Gift card variant defaults are applied automatically, meaning variants are set to non-taxable, don't require shipping, and their inventory is untracked.

* [Product​Set​Input.files](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ProductSetInput#fields-files)

  INPUT OBJECT

  The input fields required to create or update a product via ProductSet mutation.

* [Product​Variant​Set​Input.file](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ProductVariantSetInput#fields-file)

  INPUT OBJECT

  The input fields for specifying a product variant to create or update.

***

## Map

### Input objects using this input

* [Gift​Card​Product​Set​Input.files](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/GiftCardProductSetInput#fields-files)
* [Gift​Card​Product​Variant​Set​Input.file](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/GiftCardProductVariantSetInput#fields-file)
* [Product​Set​Input.files](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ProductSetInput#fields-files)
* [Product​Variant​Set​Input.file](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ProductVariantSetInput#fields-file)