Image object

Version unstable

Represents an image resource.

Connections

  • metafields (MetafieldConnection!)

    List of metafields that belong to the resource.

    Argument Description
    after ( String )

    Returns the elements that come after the specified cursor.

    before ( String )

    Returns the elements that come before the specified cursor.

    first ( Int )

    Returns up to the first n elements from the list.

    last ( Int )

    Returns up to the last n elements from the list.

    namespace ( String )

    The metafield namespace to filter by.

    reverse ( Boolean )

    Reverse the order of the underlying list.
    Default value: false

  • privateMetafields (PrivateMetafieldConnection!)

    List of private metafields that belong to the resource.

    Argument Description
    after ( String )

    Returns the elements that come after the specified cursor.

    before ( String )

    Returns the elements that come before the specified cursor.

    first ( Int )

    Returns up to the first n elements from the list.

    last ( Int )

    Returns up to the last n elements from the list.

    namespace ( String )

    Filter the private metafields by namespace.

    reverse ( Boolean )

    Reverse the order of the underlying list.
    Default value: false

Fields

  • altText (String)

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

  • height (Int)

    The original height of the image in pixels. Returns null if the image is not hosted by Shopify.

  • id (ID)

    A unique identifier for the image.

  • metafield (Metafield)

    Returns a metafield by namespace and key that belongs to the resource.

    Argument Description
    key ( String! ) required

    The key for the metafield.

    namespace ( String! ) required

    The namespace for the metafield.

  • originalSrc (URL!)

    The location of the original image as a URL.

    If there are any existing transformations in the original source URL, they will remain and not be stripped.

  • privateMetafield (PrivateMetafield)

    Returns a private metafield by namespace and key that belongs to the resource.

    Argument Description
    key ( String! ) required

    The key for the private metafield.

    namespace ( String! ) required

    The namespace for the private metafield.

  • transformedSrc (URL!)

    The location of the transformed image as a URL.

    All transformation arguments are considered "best-effort". If they can be applied to an image, they will be. Otherwise any transformations which an image type does not support will be ignored.

    Argument Description
    crop ( CropRegion )

    Crops the image according to the specified region.

    maxHeight ( Int )

    Image height in pixels between 1 and 5760.

    maxWidth ( Int )

    Image width in pixels between 1 and 5760.

    preferredContentType ( ImageContentType )

    Best effort conversion of image into content type (SVG -> PNG, Anything -> JGP, Anything -> WEBP are supported).

    scale ( Int )

    Image size multiplier for high-resolution retina displays. Must be between 1 and 3.
    Default value: 1

  • width (Int)

    The original width of the image in pixels. Returns null if the image is not hosted by Shopify.

Types that return Image