Order Page Extensions API
The Shop Minis Extensions API is a GraphQL API that powers Minis Extensions. This page shows the schema that is available to Extensions targeting the Order Confirmation Page or Order Management Feed.
Order Page Extensions targets
The Extensions targets determines where an extension will be rendered within the Shop app. However, Shop is responsible for determining the specific placement of extensions on its screens. The Order schema can be used to render the Extension on the following targets on Order Confirmation Page and Order Management Feed:
Target | Description |
---|---|
shop.order-confirmation-page.order-details.render-after | The extension will render on the order confirmation page after the order details section within the Shop app. |
shop.order-management.order-details.render-after | The extension will render on the order management feed after the order details section within the Shop app. |
shop.order-management.visit-shop.render-after | The extension will render on the order management feed after the visit shop section within the Shop app. |
Table of Contents
- Query
- Objects
- Collection
- CollectionConnection
- CollectionEdge
- Domain
- Fulfillment
- FulfillmentConnection
- FulfillmentEdge
- Image
- MediaImage
- Metafield
- MetafieldReferenceConnection
- MetafieldReferenceEdge
- Metaobject
- MetaobjectField
- MoneyV2
- Order
- PageInfo
- Product
- ProductConnection
- ProductEdge
- ProductOption
- ProductPriceRange
- ProductVariant
- ProductVariantConnection
- ProductVariantEdge
- SelectedOption
- Shop
- Video
- VideoSource
- Inputs
- Enums
- Scalars
- Unions
Query
This acts as the public, top-level API from which all queries start.
Field | Argument | Type | Description |
---|---|---|---|
order | Order | The current order. | |
shop | Shop | The current shop. |
Objects
Collection
A collection represents a grouping of products that a shop owner can create to organize them or make their shops easier to browse.
Field | Argument | Type | Description |
---|---|---|---|
id | ID! | A globally-unique ID. | |
products | ProductConnection! | List of products in the collection. | |
after | String | Returns the elements in the list that come after the specified cursor. | |
before | String | Returns the elements in the list that come before the specified cursor. | |
filters | [ProductFilter!] | Returns a subset of products matching all product filters. The input must not contain more than | |
first | Int | Returns the first n elements from the list. | |
last | Int | Returns the last n elements from the list. | |
reverse | Boolean | Reverse the order of the underlying list. | |
sortKey | ProductCollectionSortKeys | Sort the underlying list by the given key. | |
title | String! | The collection’s name. Limit of 255 characters. |
CollectionConnection
An auto-generated type for paginating through multiple Collections.
Field | Argument | Type | Description |
---|---|---|---|
edges | [CollectionEdge!]! | A list of edges. | |
nodes | [Collection!]! | A list of the nodes contained in CollectionEdge. | |
pageInfo | PageInfo! | Information to aid in pagination. |
CollectionEdge
An auto-generated type which holds one Collection and a cursor during pagination.
Field | Argument | Type | Description |
---|---|---|---|
cursor | String! | A cursor for use in pagination. | |
node | Collection! | The item at the end of CollectionEdge. |
Domain
Represents an web address.
Field | Argument | Type | Description |
---|---|---|---|
host | String! | The host name of the domain (eg: example.com). | |
sslEnabled | Boolean! | Whether SSL is enabled or not. | |
url | URL! | The URL of the domain (eg: https://example.com). |
Fulfillment
Represents a single fulfillment in an order.
Field | Argument | Type | Description |
---|---|---|---|
id | ID! | A globally-unique ID. | |
latestShipmentStatus | FulfillmentEventStatus | The latest shipment status for the fulfillment. | |
status | FulfillmentStatus | The status of the fulfillment. | |
updatedAt | DateTime! | The date and time when the fulfillment was updated. |
FulfillmentConnection
An auto-generated type for paginating through multiple Fulfillments.
Field | Argument | Type | Description |
---|---|---|---|
edges | [FulfillmentEdge!]! | The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node. | |
nodes | [Fulfillment!]! | A list of nodes that are contained in FulfillmentEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve. | |
pageInfo | PageInfo! | An object that’s used to retrieve cursor information about the current page. |
FulfillmentEdge
An auto-generated type which holds one Fulfillment and a cursor during pagination.
Field | Argument | Type | Description |
---|---|---|---|
cursor | String! | The position of each node in an array, used in pagination. | |
node | Fulfillment! | The item at the end of FulfillmentEdge. |
Image
Represents an image resource.
Field | Argument | Type | Description |
---|---|---|---|
id | ID | A unique ID for the image. | |
url | URL! | The location of the image as a URL. If no transform options are specified, then the original image will be preserved including any pre-applied transforms. All transformation options are considered "best-effort". Any transformation that the original image type doesn't support will be ignored. If you need multiple variations of the same image, then you can use GraphQL aliases. | |
transform | ImageTransformInput | A set of options to transform the original image. |
MediaImage
Represents a Shopify hosted image.
Field | Argument | Type | Description |
---|---|---|---|
id | ID! | A globally-unique ID. | |
image | Image | The image for the media. |
Metafield
The custom metadata attached to a resource. Metafields can be sorted into namespaces and are comprised of keys, values, and value types.
Field | Argument | Type | Description |
---|---|---|---|
id | ID! | A globally-unique ID. | |
reference | MetafieldReference | Returns a reference object if the metafield's type is a resource reference. | |
references | MetafieldReferenceConnection | A list of reference objects if the metafield's type is a resource reference list. | |
after | String | Returns the elements in the list that come after the specified cursor. | |
before | String | Returns the elements in the list that come before the specified cursor. | |
first | Int | Returns the first n elements from the list. | |
last | Int | Returns the last n elements from the list. | |
type | String! | The type name of the metafield. See the list of supported types. | |
value | String! | The value of a metafield. |
MetafieldReferenceConnection
An auto-generated type for paginating through multiple MetafieldReferences.
Field | Argument | Type | Description |
---|---|---|---|
edges | [MetafieldReferenceEdge!]! | A list of edges. | |
nodes | [MetafieldReference!]! | A list of the nodes contained in MetafieldReferenceEdge. | |
pageInfo | PageInfo! | Information to aid in pagination. |
MetafieldReferenceEdge
An auto-generated type which holds one MetafieldReference and a cursor during pagination.
Field | Argument | Type | Description |
---|---|---|---|
cursor | String! | A cursor for use in pagination. | |
node | MetafieldReference! | The item at the end of MetafieldReferenceEdge. |
Metaobject
An instance of a user-defined model based on a MetaobjectDefinition.
Field | Argument | Type | Description |
---|---|---|---|
field | MetaobjectField | Accesses a field of the object by key. | |
key | String! | The key of the field. | |
id | ID! | A globally-unique ID. |
MetaobjectField
Provides the value of a Metaobject field.
Field | Argument | Type | Description |
---|---|---|---|
reference | MetafieldReference | A referenced object if the field type is a resource reference. | |
references | MetafieldReferenceConnection | A list of referenced objects if the field type is a resource reference list. | |
after | String | Returns the elements in the list that come after the specified cursor. | |
before | String | Returns the elements in the list that come before the specified cursor. | |
first | Int | Returns the first n elements from the list. | |
last | Int | Returns the last n elements from the list. | |
value | String | The field value. |
MoneyV2
A monetary value with currency.
Field | Argument | Type | Description |
---|---|---|---|
amount | Decimal! | Decimal money amount. | |
currencyCode | CurrencyCode! | Currency of the money. |
Order
An order is a customer's request to purchase one or more products from a shop.
Field | Argument | Type | Description |
---|---|---|---|
confirmationNumber | String | A randomly generated alpha-numeric identifier for the order that may be shown to the customer instead of the sequential order name. For example, "XPAV284CT", "R50KELTJP" or "35PKUN0UJ". This value isn't guaranteed to be unique. | |
String | The email address of the customer. | ||
fulfillments | FulfillmentConnection! | The fulfillments associated with the order. | |
after | String | Returns the elements in the list that come after the specified cursor. | |
before | String | Returns the elements in the list that come before the specified cursor. | |
first | Int | Returns the first n elements from the list. | |
last | Int | Returns the last n elements from the list. | |
query | String | A filter made up of terms, connectives, modifiers, and comparators.
| name | type | description | acceptable_values | default_value | example_use |
| ---- | ---- | ---- | ---- | ---- | ---- |
| id | id | Filter by | |
reverse | Boolean | Reverse the order of the underlying list. | |
sortKey | FulfillmentSortKeys | Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search. | |
id | ID! | A globally-unique ID. | |
metafield | Metafield | A metafield found by namespace and key. | |
key | String! | The identifier for the metafield. | |
namespace | String! | A container for a set of metafields. | |
metafields | [Metafield]! | The metafields associated with the resource matching the supplied list of namespaces and keys. | |
identifiers | [HasMetafieldsIdentifier!]! | The list of metafields to retrieve by namespace and key. | |
name | String! | The identifier for the order that appears on the order. For example, #1000 or _Store1001. |
PageInfo
Returns information about pagination in a connection, in accordance with the Relay specification. For more information, please read our GraphQL Pagination Usage Guide.
Field | Argument | Type | Description |
---|---|---|---|
endCursor | String | The cursor corresponding to the last node in edges. | |
hasNextPage | Boolean! | Whether there are more pages to fetch following the current page. | |
hasPreviousPage | Boolean! | Whether there are any pages prior to the current page. | |
startCursor | String | The cursor corresponding to the first node in edges. |
Product
A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be. For example, a digital download (such as a movie, music or ebook file) also qualifies as a product, as do services (such as equipment rental, work for hire, customization of another product or an extended warranty).
Field | Argument | Type | Description |
---|---|---|---|
availableForSale | Boolean! | Indicates if at least one product variant is available for sale. | |
collections | CollectionConnection! | List of collections a product belongs to. | |
after | String | Returns the elements in the list that come after the specified cursor. | |
before | String | Returns the elements in the list that come before the specified cursor. | |
first | Int | Returns the first n elements from the list. | |
last | Int | Returns the last n elements from the list. | |
reverse | Boolean | Reverse the order of the underlying list. | |
featuredImage | Image | The featured image for the product. This field is functionally equivalent to | |
id | ID! | A globally-unique ID. | |
metafield | Metafield | Returns a metafield found by namespace and key. | |
key | String! | The identifier for the metafield. | |
namespace | String | The container the metafield belongs to. If omitted, the app-reserved namespace will be used. | |
metafields | [Metafield]! | The metafields associated with the resource matching the supplied list of namespaces and keys. | |
identifiers | [HasMetafieldsIdentifier!]! | The list of metafields to retrieve by namespace and key. The input must not contain more than | |
options | [ProductOption!]! | List of product options. | |
first | Int | Truncate the array result to this size. | |
priceRange | ProductPriceRange! | The price range. | |
reviewsAverageRating | Float | The average rating of the product. | |
reviewsCount | Int | The number of reviews for the product. | |
title | String! | The product’s title. | |
variants | ProductVariantConnection! | List of the product’s variants. | |
after | String | Returns the elements in the list that come after the specified cursor. | |
before | String | Returns the elements in the list that come before the specified cursor. | |
first | Int | Returns the first n elements from the list. | |
last | Int | Returns the last n elements from the list. | |
reverse | Boolean | Reverse the order of the underlying list. | |
sortKey | ProductVariantSortKeys | Sort the underlying list by the given key. |
ProductConnection
An auto-generated type for paginating through multiple Products.
Field | Argument | Type | Description |
---|---|---|---|
edges | [ProductEdge!]! | A list of edges. | |
nodes | [Product]! | A list of the nodes contained in ProductEdge. | |
pageInfo | PageInfo! | Information to aid in pagination. |
ProductEdge
An auto-generated type which holds one Product and a cursor during pagination.
Field | Argument | Type | Description |
---|---|---|---|
cursor | String! | A cursor for use in pagination. | |
node | Product | The item at the end of ProductEdge. |
ProductOption
Product property names like "Size", "Color", and "Material" that the customers can select. Variants are selected based on permutations of these options. 255 characters limit each.
Field | Argument | Type | Description |
---|---|---|---|
id | ID! | A globally-unique ID. | |
name | String! | The product option’s name. | |
values | [String!]! | The corresponding value to the product option name. |
ProductPriceRange
The price range of the product.
Field | Argument | Type | Description |
---|---|---|---|
maxVariantPrice | MoneyV2! | The highest variant's price. | |
minVariantPrice | MoneyV2! | The lowest variant's price. |
ProductVariant
A product variant represents a different version of a product, such as differing sizes or differing colors.
Field | Argument | Type | Description |
---|---|---|---|
availableForSale | Boolean! | Indicates if the product variant is available for sale. | |
compareAtPrice | MoneyV2 | The compare at price of the variant. This can be used to mark a variant as on
sale, when | |
currentlyNotInStock | Boolean! | Whether a product is out of stock but still available for purchase (used for backorders). | |
id | ID! | A globally-unique ID. | |
image | Image | Image associated with the product variant. This field falls back to the product image if no image is available. | |
isFavorited | Boolean! | Whether the product variant is favorited by the current user. | |
metafield | Metafield | Returns a metafield found by namespace and key. | |
key | String! | The identifier for the metafield. | |
namespace | String | The container the metafield belongs to. If omitted, the app-reserved namespace will be used. | |
price | MoneyV2! | The product variant’s price. | |
product | Product! | The product object that the product variant belongs to. | |
selectedOptions | [SelectedOption!]! | List of product options applied to the variant. | |
title | String! | The product variant’s title. |
ProductVariantConnection
An auto-generated type for paginating through multiple ProductVariants.
Field | Argument | Type | Description |
---|---|---|---|
edges | [ProductVariantEdge!]! | A list of edges. | |
nodes | [ProductVariant!]! | A list of the nodes contained in ProductVariantEdge. | |
pageInfo | PageInfo! | Information to aid in pagination. |
ProductVariantEdge
An auto-generated type which holds one ProductVariant and a cursor during pagination.
Field | Argument | Type | Description |
---|---|---|---|
cursor | String! | A cursor for use in pagination. | |
node | ProductVariant! | The item at the end of ProductVariantEdge. |
SelectedOption
Properties used by customers to select a product variant. Products can have multiple options, like different sizes or colors.
Field | Argument | Type | Description |
---|---|---|---|
name | String! | The product option’s name. | |
value | String! | The product option’s value. |
Shop
Shop represents a collection of the general settings and information about the shop.
Field | Argument | Type | Description |
---|---|---|---|
id | ID! | A globally-unique ID. | |
metafield | Metafield | Returns a metafield found by namespace and key. | |
key | String! | The identifier for the metafield. | |
namespace | String | The container the metafield belongs to. If omitted, the app-reserved namespace will be used. | |
metafields | [Metafield]! | The metafields associated with the resource matching the supplied list of namespaces and keys. | |
identifiers | [HasMetafieldsIdentifier!]! | The list of metafields to retrieve by namespace and key. The input must not contain more than | |
myshopifyDomain | Domain! | The shop’s permanent domain. | |
name | String! | The shop’s name. |
Video
Represents a Shopify hosted video.
Field | Argument | Type | Description |
---|---|---|---|
id | ID! | A globally-unique ID. | |
sources | [VideoSource!]! | The sources for a video. |
VideoSource
Represents a source for a Shopify hosted video.
Field | Argument | Type | Description |
---|---|---|---|
url | String! | The URL of the video. |
Inputs
CategoryFilter
A filter used to view a subset of products in a collection matching a specific category value.
Field | Type | Description | |
---|---|---|---|
id | String! | The id of the category to filter on. |
CategoryMetafieldFilter
A filter used to view a subset of products in a collection matching a specific category metafield value.
Field | Type | Description | |
---|---|---|---|
key | String! | The key of the metafield to filter on. | |
namespace | String! | The namespace of the metafield to filter on. | |
value | String! | The value of the metafield. |
CropRegionInput
The input fields for defining an arbitrary cropping region.
Field | Type | Description | |
---|---|---|---|
height | Int! | Height of the region of the image to extract when using the region crop mode. | |
left | Int! | Left position of the region of the image to extract when using the region crop mode. | |
top | Int! | Top position of the region of the image to extract when using the region crop mode. | |
width | Int! | Width of the region of the image to extract when using the region crop mode. |
HasMetafieldsIdentifier
The input fields to identify a metafield on an owner resource by namespace and key.
Field | Type | Description | |
---|---|---|---|
key | String! | The identifier for the metafield. | |
namespace | String! | A container for a set of metafields. |
ImageTransformInput
The available options for transforming an image.
All transformation options are considered best effort. Any transformation that the original image type doesn't support will be ignored.
Field | Type | Description | |
---|---|---|---|
crop | CropRegion | The region of the image to remain after cropping.
Must be used in conjunction with the | |
cropRegion | CropRegionInput | Defines an arbitrary cropping region. | |
maxHeight | Int | Image height in pixels between 1 and 5760. | |
maxWidth | Int | Image width in pixels between 1 and 5760. | |
preferredContentType | ImageContentType | Convert the source image into the preferred content type.
Supported conversions: | |
scale | Int | Image size multiplier for high-resolution retina displays. Must be within 1..3. |
MetafieldFilter
A filter used to view a subset of products in a collection matching a specific metafield value.
Only the following metafield types are currently supported:
number_integer
number_decimal
single_line_text_field
boolean
as of 2022-04.
Field | Type | Description | |
---|---|---|---|
key | String! | The key of the metafield to filter on. | |
namespace | String! | The namespace of the metafield to filter on. | |
value | String! | The value of the metafield. |
PriceRangeFilter
The input fields for a filter used to view a subset of products in a collection matching a specific price range.
Field | Type | Description | |
---|---|---|---|
max | Float | The maximum price in the range. Empty indicates no max price. | |
min | Float | The minimum price in the range. Defaults to zero. |
ProductFilter
The input fields for a filter used to view a subset of products in a collection.
By default, the available
and price
filters are enabled. Filters are customized with the Shopify Search & Discovery app.
Learn more about customizing storefront filtering.
Field | Type | Description | |
---|---|---|---|
available | Boolean | Filter on if the product is available for sale. | |
category | CategoryFilter | A product category to filter on. | |
categoryMetafield | CategoryMetafieldFilter | A category metafield to filter on. | |
price | PriceRangeFilter | A range of prices to filter with-in. | |
productMetafield | MetafieldFilter | A product metafield to filter on. | |
productType | String | The product type to filter on. | |
productVendor | String | The product vendor to filter on. | |
tag | String | A product tag to filter on. | |
variantMetafield | MetafieldFilter | A variant metafield to filter on. | |
variantOption | VariantOptionFilter | A variant option to filter on. |
VariantOptionFilter
The input fields for a filter used to view a subset of products in a collection matching a specific variant option.
Field | Type | Description | |
---|---|---|---|
name | String! | The name of the variant option to filter on. | |
value | String! | The value of the variant option to filter on. |
Enums
CropRegion
The part of the image that should remain after cropping.
Value | Description |
---|---|
BOTTOM | Keep the bottom of the image. |
CENTER | Keep the center of the image. |
LEFT | Keep the left of the image. |
REGION | Crop the exact region of the image specified by the crop_left, crop_top, crop_width and crop_height parameters. |
RIGHT | Keep the right of the image. |
TOP | Keep the top of the image. |
CurrencyCode
The three-letter currency codes that represent the world currencies used in stores. These include standard ISO 4217 codes, legacy codes, and non-standard codes.
Value | Description |
---|---|
AED | United Arab Emirates Dirham (AED). |
AFN | Afghan Afghani (AFN). |
ALL | Albanian Lek (ALL). |
AMD | Armenian Dram (AMD). |
ANG | Netherlands Antillean Guilder. |
AOA | Angolan Kwanza (AOA). |
ARS | Argentine Pesos (ARS). |
AUD | Australian Dollars (AUD). |
AWG | Aruban Florin (AWG). |
AZN | Azerbaijani Manat (AZN). |
BAM | Bosnia and Herzegovina Convertible Mark (BAM). |
BBD | Barbadian Dollar (BBD). |
BDT | Bangladesh Taka (BDT). |
BGN | Bulgarian Lev (BGN). |
BHD | Bahraini Dinar (BHD). |
BIF | Burundian Franc (BIF). |
BMD | Bermudian Dollar (BMD). |
BND | Brunei Dollar (BND). |
BOB | Bolivian Boliviano (BOB). |
BRL | Brazilian Real (BRL). |
BSD | Bahamian Dollar (BSD). |
BTN | Bhutanese Ngultrum (BTN). |
BWP | Botswana Pula (BWP). |
BYN | Belarusian Ruble (BYN). |
BYR | Belarusian Ruble (BYR). |
BZD | Belize Dollar (BZD). |
CAD | Canadian Dollars (CAD). |
CDF | Congolese franc (CDF). |
CHF | Swiss Francs (CHF). |
CLP | Chilean Peso (CLP). |
CNY | Chinese Yuan Renminbi (CNY). |
COP | Colombian Peso (COP). |
CRC | Costa Rican Colones (CRC). |
CVE | Cape Verdean escudo (CVE). |
CZK | Czech Koruny (CZK). |
DJF | Djiboutian Franc (DJF). |
DKK | Danish Kroner (DKK). |
DOP | Dominican Peso (DOP). |
DZD | Algerian Dinar (DZD). |
EGP | Egyptian Pound (EGP). |
ERN | Eritrean Nakfa (ERN). |
ETB | Ethiopian Birr (ETB). |
EUR | Euro (EUR). |
FJD | Fijian Dollars (FJD). |
FKP | Falkland Islands Pounds (FKP). |
GBP | United Kingdom Pounds (GBP). |
GEL | Georgian Lari (GEL). |
GHS | Ghanaian Cedi (GHS). |
GIP | Gibraltar Pounds (GIP). |
GMD | Gambian Dalasi (GMD). |
GNF | Guinean Franc (GNF). |
GTQ | Guatemalan Quetzal (GTQ). |
GYD | Guyanese Dollar (GYD). |
HKD | Hong Kong Dollars (HKD). |
HNL | Honduran Lempira (HNL). |
HRK | Croatian Kuna (HRK). |
HTG | Haitian Gourde (HTG). |
HUF | Hungarian Forint (HUF). |
IDR | Indonesian Rupiah (IDR). |
ILS | Israeli New Shekel (NIS). |
INR | Indian Rupees (INR). |
IQD | Iraqi Dinar (IQD). |
IRR | Iranian Rial (IRR). |
ISK | Icelandic Kronur (ISK). |
JEP | Jersey Pound. |
JMD | Jamaican Dollars (JMD). |
JOD | Jordanian Dinar (JOD). |
JPY | Japanese Yen (JPY). |
KES | Kenyan Shilling (KES). |
KGS | Kyrgyzstani Som (KGS). |
KHR | Cambodian Riel. |
KID | Kiribati Dollar (KID). |
KMF | Comorian Franc (KMF). |
KRW | South Korean Won (KRW). |
KWD | Kuwaiti Dinar (KWD). |
KYD | Cayman Dollars (KYD). |
KZT | Kazakhstani Tenge (KZT). |
LAK | Laotian Kip (LAK). |
LBP | Lebanese Pounds (LBP). |
LKR | Sri Lankan Rupees (LKR). |
LRD | Liberian Dollar (LRD). |
LSL | Lesotho Loti (LSL). |
LTL | Lithuanian Litai (LTL). |
LVL | Latvian Lati (LVL). |
LYD | Libyan Dinar (LYD). |
MAD | Moroccan Dirham. |
MDL | Moldovan Leu (MDL). |
MGA | Malagasy Ariary (MGA). |
MKD | Macedonia Denar (MKD). |
MMK | Burmese Kyat (MMK). |
MNT | Mongolian Tugrik. |
MOP | Macanese Pataca (MOP). |
MRU | Mauritanian Ouguiya (MRU). |
MUR | Mauritian Rupee (MUR). |
MVR | Maldivian Rufiyaa (MVR). |
MWK | Malawian Kwacha (MWK). |
MXN | Mexican Pesos (MXN). |
MYR | Malaysian Ringgits (MYR). |
MZN | Mozambican Metical. |
NAD | Namibian Dollar. |
NGN | Nigerian Naira (NGN). |
NIO | Nicaraguan Córdoba (NIO). |
NOK | Norwegian Kroner (NOK). |
NPR | Nepalese Rupee (NPR). |
NZD | New Zealand Dollars (NZD). |
OMR | Omani Rial (OMR). |
PAB | Panamian Balboa (PAB). |
PEN | Peruvian Nuevo Sol (PEN). |
PGK | Papua New Guinean Kina (PGK). |
PHP | Philippine Peso (PHP). |
PKR | Pakistani Rupee (PKR). |
PLN | Polish Zlotych (PLN). |
PYG | Paraguayan Guarani (PYG). |
QAR | Qatari Rial (QAR). |
RON | Romanian Lei (RON). |
RSD | Serbian dinar (RSD). |
RUB | Russian Rubles (RUB). |
RWF | Rwandan Franc (RWF). |
SAR | Saudi Riyal (SAR). |
SBD | Solomon Islands Dollar (SBD). |
SCR | Seychellois Rupee (SCR). |
SDG | Sudanese Pound (SDG). |
SEK | Swedish Kronor (SEK). |
SGD | Singapore Dollars (SGD). |
SHP | Saint Helena Pounds (SHP). |
SLL | Sierra Leonean Leone (SLL). |
SOS | Somali Shilling (SOS). |
SRD | Surinamese Dollar (SRD). |
SSP | South Sudanese Pound (SSP). |
STD | Sao Tome And Principe Dobra (STD). |
STN | Sao Tome And Principe Dobra (STN). |
SYP | Syrian Pound (SYP). |
SZL | Swazi Lilangeni (SZL). |
THB | Thai baht (THB). |
TJS | Tajikistani Somoni (TJS). |
TMT | Turkmenistani Manat (TMT). |
TND | Tunisian Dinar (TND). |
TOP | Tongan Pa'anga (TOP). |
TRY | Turkish Lira (TRY). |
TTD | Trinidad and Tobago Dollars (TTD). |
TWD | Taiwan Dollars (TWD). |
TZS | Tanzanian Shilling (TZS). |
UAH | Ukrainian Hryvnia (UAH). |
UGX | Ugandan Shilling (UGX). |
USD | United States Dollars (USD). |
UYU | Uruguayan Pesos (UYU). |
UZS | Uzbekistan som (UZS). |
VED | Venezuelan Bolivares (VED). |
VEF | Venezuelan Bolivares (VEF). |
VES | Venezuelan Bolivares Soberanos (VES). |
VND | Vietnamese đồng (VND). |
VUV | Vanuatu Vatu (VUV). |
WST | Samoan Tala (WST). |
XAF | Central African CFA Franc (XAF). |
XCD | East Caribbean Dollar (XCD). |
XOF | West African CFA franc (XOF). |
XPF | CFP Franc (XPF). |
XXX | Unrecognized currency. |
YER | Yemeni Rial (YER). |
ZAR | South African Rand (ZAR). |
ZMW | Zambian Kwacha (ZMW). |
FulfillmentEventStatus
The status of a fulfillment event.
Value | Description |
---|---|
ATTEMPTED_DELIVERY | A delivery was attempted. |
CARRIER_PICKED_UP | The fulfillment has been picked up by the carrier. |
CONFIRMED | The fulfillment is confirmed. |
DELAYED | The fulfillment is delayed. |
DELIVERED | The fulfillment was successfully delivered. |
FAILURE | The fulfillment request failed. |
IN_TRANSIT | The fulfillment is in transit. |
LABEL_PRINTED | A purchased shipping label has been printed. |
LABEL_PURCHASED | A shipping label has been purchased. |
OUT_FOR_DELIVERY | The fulfillment is out for delivery. |
PICKED_UP | The fulfillment was successfully picked up. |
READY_FOR_PICKUP | The fulfillment is ready to be picked up. |
FulfillmentSortKeys
The set of valid sort keys for the Fulfillment query.
Value | Description |
---|---|
CREATED_AT | Sort by the |
ID | Sort by the |
RELEVANCE | Sort by relevance to the search terms when the |
FulfillmentStatus
The status of a fulfillment.
Value | Description |
---|---|
CANCELLED | The fulfillment was canceled. |
ERROR | There was an error with the fulfillment request. |
FAILURE | The fulfillment request failed. |
OPEN | The third-party fulfillment service has acknowledged the fulfillment and is processing it. |
PENDING | Shopify has created the fulfillment and is waiting for the third-party
fulfillment service to transition it to |
SUCCESS | The fulfillment was completed successfully. |
ImageContentType
List of supported image content types.
Value | Description |
---|---|
BMP | A BMP image. |
JPG | A JPG image. |
PNG | A PNG image. |
WEBP | A WEBP image. |
ProductCollectionSortKeys
The set of valid sort keys for the ProductCollection query.
Value | Description |
---|---|
BEST_SELLING | Sort by the |
COLLECTION_DEFAULT | Sort by the |
CREATED | Sort by the |
ID | Sort by the |
MANUAL | Sort by the |
PRICE | Sort by the |
RELEVANCE | Sort by relevance to the search terms when the |
TITLE | Sort by the |
ProductVariantSortKeys
The set of valid sort keys for the ProductVariant query.
Value | Description |
---|---|
ID | Sort by the |
POSITION | Sort by the |
RELEVANCE | Sort by relevance to the search terms when the |
SKU | Sort by the |
TITLE | Sort by the |
Scalars
Boolean
The Boolean
scalar type represents true
or false
.
DateTime
Represents an ISO 8601-encoded date and time string.
For example, 3:50 pm on September 7, 2019 in the time zone of UTC (Coordinated Universal Time) is
represented as "2019-09-07T15:50:00Z
".
Decimal
A signed decimal number, which supports arbitrary precision and is serialized as a string.
Example values: "29.99"
, "29.999"
.
Float
The Float
scalar type represents signed double-precision fractional values as specified by IEEE 754.
ID
The ID
scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4"
) or integer (such as 4
) input value will be accepted as an ID.
Int
The Int
scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
String
The String
scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
URL
Represents an RFC 3986 and RFC 3987-compliant URI string.
For example, "https://example.myshopify.com"
is a valid URL. It includes a scheme (https
) and a host
(example.myshopify.com
).
Unions
MetafieldReference
Returns the resource which is being referred to by a metafield.
Type | Description |
---|---|
Collection | A collection represents a grouping of products that a shop owner can create to organize them or make their shops easier to browse. |
MediaImage | Represents a Shopify hosted image. |
Metaobject | An instance of a user-defined model based on a MetaobjectDefinition. |
Product | A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be. For example, a digital download (such as a movie, music or ebook file) also qualifies as a product, as do services (such as equipment rental, work for hire, customization of another product or an extended warranty). |
ProductVariant | A product variant represents a different version of a product, such as differing sizes or differing colors. |
Video | Represents a Shopify hosted video. |