Skip to main content
object

Represents a collection of general settings and information about the shop.

Anchor to Fields and connectionsFields and connections

•StaffMember!
non-null

Account owner information.

•[ShopAlert!]!
non-null

A list of the shop's active alert messages that appear in the Shopify admin.

Anchor to allProductCategoriesListallProductCategoriesList
•[TaxonomyCategory!]!
non-null

A list of the shop's product categories. Limit: 1000 product categories.

Anchor to availableChannelAppsavailableChannelApps
•AppConnection!
non-null

The list of sales channels not currently installed on the shop.

•ShopAddress!
non-null

The shop's billing address information.

Anchor to channelDefinitionsForInstalledChannelschannelDefinitionsForInstalledChannels
•[AvailableChannelDefinitionsByChannel!]!
non-null

List of all channel definitions associated with a shop.

Anchor to checkoutApiSupportedcheckoutApiSupported
•Boolean!
non-null

Specifies whether the shop supports checkouts via Checkout API.

•String!
non-null

The public-facing contact email address for the shop. Customers will use this email to communicate with the shop owner.

Anchor to countriesInShippingZonescountriesInShippingZones
•CountriesInShippingZones!
non-null

Countries that have been defined in shipping zones for the shop.

•DateTime!
non-null

The date and time when the shop was created.

•CurrencyCode!
non-null

The three letter code for the currency that the shop sells in.

•CurrencyFormats!
non-null

How currencies are displayed on your store.

•CurrencySettingConnection!
non-null

The presentment currency settings for the shop excluding the shop's own currency.

•ShopCustomerAccountsSetting!
non-null

Whether customer accounts are required, optional, or disabled for the shop.

•CustomerAccountsV2!
non-null

Information about the shop's customer accounts.

•StringConnection!
non-null

A list of tags that have been added to customer accounts.

•String

The shop's meta description used in search engine results.

•StringConnection!
non-null

A list of tags that have been added to draft orders.

•String!
non-null

The shop owner's email address. Shopify will use this email address to communicate with the shop owner.

Anchor to enabledPresentmentCurrenciesenabledPresentmentCurrencies
•[CurrencyCode!]!
non-null

The presentment currencies enabled for the shop.

•EntitlementsType!
non-null

The entitlements for a shop.

•ShopFeatures!
non-null

The set of features enabled for the shop.

•[FulfillmentService!]!
non-null

List of the shop's installed fulfillment services.

•String!
non-null

The shop's time zone as defined by the IANA.

•ID!
non-null

A globally-unique ID.

Anchor to marketingSmsConsentEnabledAtCheckoutmarketingSmsConsentEnabledAtCheckout
•Boolean!
non-null

Whether SMS marketing has been enabled on the shop's checkout configuration settings.

Anchor to merchantApprovalSignalsmerchantApprovalSignals
•MerchantApprovalSignals

The approval signals for a shop to support onboarding to channel apps.

•Metafield

A custom field, including its namespace and key, that's associated with a Shopify resource for the purposes of adding and storing additional information.

•MetafieldConnection!
non-null

A list of custom fields that a merchant associates with a Shopify resource.

•String!
non-null

The shop's .myshopify.com domain name.

•String!
non-null

The shop's name.

•[NavigationItem!]!
non-null

The shop's settings related to navigation.

Anchor to orderNumberFormatPrefixorderNumberFormatPrefix
•String!
non-null

The prefix that appears before order numbers.

Anchor to orderNumberFormatSuffixorderNumberFormatSuffix
•String!
non-null

The suffix that appears after order numbers.

•StringConnection!
non-null

A list of tags that have been added to orders.

•PaymentSettings!
non-null

The shop's settings related to payments.

•ShopPlan!
non-null

The shop's billing plan.

•Domain!
non-null

The primary domain of the shop's online store.

•ShopResourceLimits!
non-null

The shop's limits for specific resources. For example, the maximum number ofvariants allowed per product, or the maximum number of locations allowed.

•URL!
non-null

The URL of the rich text editor that can be used for mobile devices.

•SearchResultConnection!
non-null

Fetches a list of admin search results by a specified query.

•SearchFilterOptions!
non-null

The list of search filter options for the shop. These can be used to filter productvisibility for the shop.

•Boolean!
non-null

Whether the shop has outstanding setup steps.

•[CountryCode!]!
non-null

The list of countries that the shop ships to.

•String!
non-null

The name of the shop owner.

•[ShopPolicy!]!
non-null

The list of all legal policies associated with a shop.

Anchor to storefrontAccessTokensstorefrontAccessTokens
•StorefrontAccessTokenConnection!
non-null

The storefront access token of a private application. These are scoped per-application.

•Boolean!
non-null

Whether applicable taxes are included in the shop's product prices.

•Boolean!
non-null

Whether the shop charges taxes for shipping.

Anchor to timezoneAbbreviationtimezoneAbbreviation
•String!
non-null

The shop's time zone abbreviation.

•String!
non-null

The shop's time zone offset.

Anchor to timezoneOffsetMinutestimezoneOffsetMinutes
•Int!
non-null

The shop's time zone offset expressed as a number of minutes.

Anchor to transactionalSmsDisabledtransactionalSmsDisabled
•Boolean!
non-null

Whether transactional SMS sent by Shopify have been disabled for a shop.

•[Translation!]!
non-null

The published translations associated with the resource.

•UnitSystem!
non-null

The shop's unit system for weights and measures.

•DateTime!
non-null

The date and time when the shop was last updated.

•URL!
non-null

The URL of the shop's online store.

•WeightUnit!
non-null

The shop's primary unit of weight for products and shipping.

Deprecated fields and connections

Anchor to allProductCategoriesallProductCategories
•[ProductCategory!]!
non-nullDeprecated
•String!
non-nullDeprecated
Anchor to assignedFulfillmentOrdersassignedFulfillmentOrders
•FulfillmentOrderConnection!
non-nullDeprecated
•ChannelConnection!
non-nullDeprecated
•CollectionConnection!
non-nullDeprecated
•CustomerConnection!
non-nullDeprecated
•[Domain!]!
non-nullDeprecated
•DraftOrderConnection!
non-nullDeprecated
•FulfillmentOrderConnection!
non-nullDeprecated
•InventoryItemConnection!
non-nullDeprecated
Anchor to limitedPendingOrderCountlimitedPendingOrderCount
•LimitedPendingOrderCount!
non-nullDeprecated
•LocationConnection!
non-nullDeprecated
•OrderConnection!
non-nullDeprecated
•ImageConnection!
non-nullDeprecated
•ProductConnection!
non-nullDeprecated
•StringConnection!
non-nullDeprecated
•StringConnection!
non-nullDeprecated
•ProductVariantConnection!
non-nullDeprecated
•StringConnection!
non-nullDeprecated
•Int!
non-nullDeprecated
•StaffMemberConnection!
non-nullDeprecated
•URL!
non-nullDeprecated

Was this section helpful?

•query

Returns the Shop resource corresponding to the access token used in the request. The Shop resource contains business and store management settings for the shop.


Was this section helpful?

•mutation

Deletes a collection.

Arguments

•CollectionDeleteInput!
required

The collection to delete.


Fields

•ID

The ID of the collection that was deleted. Returns null if the collection doesn't exist.

•Shop!
non-null

The shop associated with the collection.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation

Delete a customer. As of API version 2022-10, apps using protected customer data must meet the protected customer data requirements.

Arguments

•CustomerDeleteInput!
required

Specifies the customer to delete.


Fields

•ID

The ID of the deleted customer.

•Shop!
non-null

The shop of the deleted customer.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation

Creates a delegate access token.

To learn more about creating delegate access tokens, refer to Delegate OAuth access tokens to subsystems.

Arguments

•DelegateAccessTokenInput!
required

The input fields for creating a delegate access token.


Fields

•DelegateAccessToken

The delegate access token.

•Shop!
non-null

The user's shop.

•[DelegateAccessTokenCreateUserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation

Destroys a delegate access token.

Arguments

•String!
required

Provides the delegate access token to destroy.


Fields

•Shop!
non-null

The user's shop.

•Boolean

The status of the delegate access token destroy operation. Returns true if successful.

•[DelegateAccessTokenDestroyUserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation

Creates a product with attributes such as title, description, vendor, and media.

The productCreate mutation helps you create many products at once, avoiding the tedious or time-consuming process of adding them one by one in the Shopify admin. Common examples include creating products for a new collection, launching a new product line, or adding seasonal products.

You can define product options and values, allowing you to create products with different variations like sizes or colors. You can also associate media files to your products, including images and videos.

The productCreate mutation only supports creating a product with its initial product variant. To create multiple product variants for a single product and manage prices, use the productVariantsBulkCreate mutation.


Note

The productCreate mutation has a throttle that takes effect when a store has 50,000 product variants. After this threshold is reached, no more than 1,000 new product variants can be created per day.


After you create a product, you can make subsequent edits to the product using one of the following mutations:

  • publishablePublish: Used to publish the product and make it available to customers. The productCreate mutation creates products in an unpublished state by default, so you must perform a separate operation to publish the product.
  • productUpdate: Used to update a single product, such as changing the product's title, description, vendor, or associated media.
  • productSet: Used to perform multiple operations on products, such as creating or modifying product options and variants.

Learn more about the product model and adding product data.

Arguments

•ProductInput
Deprecated
•[CreateMediaInput!]

The media to add to the product.

•ProductCreateInput

The attributes of the new product.


Fields

•Product

The product object.

•Shop!
non-null

The shop associated with the product.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation

Deletes a product, including all associated variants and media.

As of API version 2023-01, if you need to delete a large product, such as one that has many variants that are active at several locations, you may encounter timeout errors. To avoid these timeout errors, you can instead use the asynchronous ProductDeleteAsync mutation.

Arguments

•ProductDeleteInput!
required

Specifies the product to delete by its ID.

•Boolean
Default:true

Specifies whether or not to run the mutation synchronously.


Fields

•ID

The ID of the deleted product.

Anchor to productDeleteOperationproductDeleteOperation
•ProductDeleteOperation

The product delete operation, returned when run in asynchronous mode.

•Shop!
non-null

The shop associated with the product.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation

Duplicates a product.

If you need to duplicate a large product, such as one that has many variants that are active at several locations, you might encounter timeout errors.

To avoid these timeout errors, you can instead duplicate the product asynchronously.

In API version 2024-10 and higher, include synchronous: false argument in this mutation to perform the duplication asynchronously.

In API version 2024-07 and lower, use the asynchronous ProductDuplicateAsyncV2.

Metafield values are not duplicated if the unique values capability is enabled.

Arguments

•Boolean
Default:false

Specifies whether or not to duplicate images.

•Boolean
Default:false

Specifies whether or not to duplicate translations.

•ProductStatus

The new status of the product. If no value is provided the status will be inherited from the original product.

•String!
required

The new title of the product.

•ID!
required

The ID of the product to be duplicated.

•Boolean
Default:true

Specifies whether or not to run the mutation synchronously.


Fields

•Job

The asynchronous job that duplicates the product images.

•Product

The duplicated product.

Anchor to productDuplicateOperationproductDuplicateOperation
•ProductDuplicateOperation

The product duplicate operation, returned when run in asynchronous mode.

•Shop!
non-null

The user's shop.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation

Publishes a resource to a channel. If the resource is a product, then it's visible in the channel only if the product status is active. Products that are sold exclusively on subscription (requiresSellingPlan: true) can be published only on online stores.

Arguments

•ID!
required

The resource to create or update publications for.

•[PublicationInput!]!
required

Specifies the input fields required to publish a resource.


Fields

•Publishable

Resource that has been published.

•Shop!
non-null

The user's shop.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation

Publishes a resource to current channel. If the resource is a product, then it's visible in the channel only if the product status is active. Products that are sold exclusively on subscription (requiresSellingPlan: true) can be published only on online stores.

Arguments

•ID!
required

The resource to create or update publications for.


Fields

•Publishable

Resource that has been published.

•Shop!
non-null

The user's shop.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation

Unpublishes a resource from a channel. If the resource is a product, then it's visible in the channel only if the product status is active.

Arguments

•ID!
required

The resource to delete or update publications for.

•[PublicationInput!]!
required

Specifies the input fields required to unpublish a resource.


Fields

•Publishable

Resource that has been unpublished.

•Shop!
non-null

The user's shop.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation

Unpublishes a resource from the current channel. If the resource is a product, then it's visible in the channel only if the product status is active.

Arguments

•ID!
required

The resource to delete or update publications for.


Fields

•Publishable

Resource that has been unpublished.

•Shop!
non-null

The user's shop.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation

Delete a saved search.

Arguments

•SavedSearchDeleteInput!
required

The input fields to delete a saved search.


Fields

Anchor to deletedSavedSearchIddeletedSavedSearchId
•ID

The ID of the saved search that was deleted.

•Shop!
non-null

The shop of the saved search that was deleted.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation

Creates a storefront access token for use with the Storefront API.

An app can have a maximum of 100 active storefront access tokens for each shop.

Get started with the Storefront API.

Arguments

•StorefrontAccessTokenInput!
required

Provides the input fields for creating a storefront access token.


Fields

•Shop!
non-null

The user's shop.

Anchor to storefrontAccessTokenstorefrontAccessToken
•StorefrontAccessToken

The storefront access token.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.

Deprecated mutations

•mutation
Deprecated

Arguments

•CollectionPublishInput!
required

Specify a collection to publish and the sales channels to publish it to.


Fields

•Collection

The published collection.

Anchor to collectionPublicationscollectionPublications
•[CollectionPublication!]

The channels where the collection has been published.

•Shop!
non-null

The shop associated with the collection.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation
Deprecated

Arguments

•CollectionUnpublishInput!
required

Specify a collection to unpublish and the sales channels to remove it from.


Fields

•Collection

The collection that has been unpublished.

•Shop!
non-null

The shop associated with the collection.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation
Deprecated

Arguments

•ProductPublishInput!
required

Specifies the product to publish and the channels to publish it to.


Fields

•Product

The product that has been published.

•Shop!
non-null

The user's shop.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.

•[ProductPublication!]
Deprecated
•mutation
Deprecated

Arguments

•ProductUnpublishInput!
required

Specifies the product to unpublish and the channel to unpublish it from.


Fields

•Product

The product that has been unpublished.

•Shop!
non-null

The user's shop.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.


Was this section helpful?


Was this section helpful?