---
title: "Image"
description: "image information"
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/storefront-api/common-objects/objects/image'
  md: 'https://developer.shopline.com/docs/storefront-api/common-objects/objects/image.md'
---
# Image

image information

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Type Signature

`Image`

## Fields

* `altText`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  A word or phrase to share the nature or contents of an image.

* `height`

  [Int](https://developer.shopline.com/docs/storefront-api/common/scalars/int.md)

  The original height of the image in pixels. Returns null if the image isn't hosted by shopline.

* `id`

  [ID](https://developer.shopline.com/docs/storefront-api/common/scalars/id.md)

  A unique ID for the image. Note that `previewImage` does not yet support this field

* `url`

  [URI](https://developer.shopline.com/docs/storefront-api/common/scalars/uri.md)

  The location of the image as a URL.

* `width`

  [Int](https://developer.shopline.com/docs/storefront-api/common/scalars/int.md)

  The original width of the image in pixels. Returns null if the image isn't hosted by shopline.

## Schema Definition

```graphql
type Image { 
	altText: String
	height: Int
	id: ID
	url: URI
	width: Int 
}
```

## Field from

* [ProductVariant](https://developer.shopline.com/docs/storefront-api/products/objects/product-variant.md).image

  Image associated with the product variant. 

* [Video](https://developer.shopline.com/docs/storefront-api/common-objects/objects/video.md).previewImage

  媒体的预览图像

* [MediaImage](https://developer.shopline.com/docs/storefront-api/common-objects/objects/media-image.md).image

  The image for the media.

* [MediaImage](https://developer.shopline.com/docs/storefront-api/common-objects/objects/media-image.md).previewImage

  媒体的预览图像

* [ImageConnection](https://developer.shopline.com/docs/storefront-api/common-objects/objects/image-connection.md).nodes

  ImageEdge 中包含的节点列表

* [Article](https://developer.shopline.com/docs/storefront-api/online-store/objects/article.md).image

  Cover chart

* [Media](https://developer.shopline.com/docs/storefront-api/common-objects/interfaces/media.md).previewImage

  The preview image for the media.

* [Collection](https://developer.shopline.com/docs/storefront-api/products/objects/collection.md).banner

  Banner associated with the collection.
  

* [Collection](https://developer.shopline.com/docs/storefront-api/products/objects/collection.md).image

  Image associated with the collection.

* [Product](https://developer.shopline.com/docs/storefront-api/products/objects/product.md).featuredImage

  The featured image for the product.
  
  :::tip{title="tip"}
  This field is functionally equivalent to `imagesV2(first: 1)`.
  :::

* [Product](https://developer.shopline.com/docs/storefront-api/products/objects/product.md).images

  List of images associated with the product.

* [ImageEdge](https://developer.shopline.com/docs/storefront-api/common-objects/objects/image-edge.md).node

  The item at the end of ImageEdge.

* [ExternalVideo](https://developer.shopline.com/docs/storefront-api/common-objects/objects/external-video.md).previewImage

  媒体的预览图像

## Error Handling

For detailed information about common codes, see [Status and error codes](https://developer.shopline.com/docs/apps/api-instructions-for-use/storefront-api/overview.md#status-and-error-codes).