---
title: File - GraphQL Admin
description: A file interface.
api_version: unstable
api_name: admin
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/File'
  md: 'https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/File.md'
metadata:
  domain: admin
---

# File

interface

Requires `read_products` access scope, `read_files` access scope, `read_themes` access scope, `read_orders` access scope, `read_draft_orders` access scope, `read_images` access scope or `read_quick_sale` access scope.

A file interface.

## Fields

* alt

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

  A word or phrase to describe the contents or the function of a file.

* created​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/DateTime)

  non-null

  The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) when the file was created.

* file​Errors

  [\[File​Error!\]!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/FileError)

  non-null

  Any errors that have occurred on the file.

* file​Status

  [File​Status!](https://shopify.dev/docs/api/admin-graphql/unstable/enums/FileStatus)

  non-null

  The status of the file.

* id

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

  non-null

  A globally-unique ID.

* preview

  [Media​Preview​Image](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MediaPreviewImage)

  The preview image for the media.

* updated​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/DateTime)

  non-null

  The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) when the file was last updated.

* update​Status

  [File​Status](https://shopify.dev/docs/api/admin-graphql/unstable/enums/FileStatus)

  Status resulting from the latest update operation. See fileErrors for details.

***

##### Variables

```json
{
	"alt": "",
	"createdAt": "",
	"fileErrors": "",
	"fileStatus": "",
	"id": "",
	"preview": "",
	"updatedAt": "",
	"updateStatus": ""
}
```

##### Schema

```graphql
interface File {
  alt: String
  createdAt: DateTime!
  fileErrors: [FileError!]!
  fileStatus: FileStatus!
  id: ID!
  preview: MediaPreviewImage
  updateStatus: FileStatus
  updatedAt: DateTime!
}
```