MetafieldParentResource

A post that belongs to a Blog. Each article includes content with optional HTML formatting, an excerpt for previews, ArticleAuthor information, and an associated Image.

Articles can be organized with tags and include SEO metadata. You can manage comments when the blog's comment policy enables them.

A blog container for Article objects. Stores can have multiple blogs, for example to organize content by topic or purpose.

Each blog provides access to its articles, contributing ArticleAuthor objects, and SEO information. You can retrieve articles individually by handle or as a paginated list.

A cart represents the merchandise that a buyer intends to purchase, and the estimated cost associated with the cart, throughout a customer's session.

Use the checkoutUrl field to direct buyers to Shopify's web checkout to complete their purchase.

Learn more about interacting with carts.

A group of products organized by a merchant to make their store easier to browse. Collections can help customers discover related products by category, season, promotion, or other criteria.

Query a collection's products with filtering options like availability, price range, vendor, and tags. Each collection includes SEO information, an optional Image, and supports custom data through metafields.

A B2B organization that purchases from the shop. In the Storefront API, company information is accessed through the PurchasingCompany object on CartBuyerIdentity, which provides the associated location and contact for the current purchasing context.

You can store custom data using metafields.

A branch or office of a Company where B2B customers can place orders. When a B2B customer selects a location after logging in, the Storefront API contextualizes product queries to return location-specific pricing and quantity rules.

Access through the PurchasingCompany object, which associates the location with the buyer's Cart.

A customer account with the shop. Includes data such as contact information, addresses and marketing preferences for logged-in customers, so they don't have to provide these details at every checkout.

Access the customer through the customer query using a customer access token obtained from the customerAccessTokenCreate mutation.

The object implements the HasMetafields interface, enabling retrieval of custom data associated with the customer.

A physical store location where product inventory is held and that supports in-store pickup. Provides the location's name, address, and geographic coordinates for proximity-based sorting. Use with StoreAvailability to show customers where a ProductVariant is available for pickup.

Learn more about supporting local pickup on storefronts.

An audience of buyers that a merchant targets for sales. Audiences can include geographic regions, company locations, and retail locations. Markets enable localized shopping experiences with region-specific languages, currencies, and pricing.

Each market has a unique handle for identification and supports custom data through metafields. Learn more about building localized experiences with Shopify Markets.

An order is a customer’s completed request to purchase one or more products from a shop. An order is created when a customer completes the checkout process, during which time they provides an email address, billing address and payment information.

A custom content page on a merchant's store. Pages display HTML-formatted content, such as "About Us", contact details, or store policies.

Each page has a unique handle for URL routing and includes SEO information for search engine optimization. Pages support Metafield attachments for storing additional custom data.

Represents an item listed in a shop's catalog.

Products support multiple product variants, representing different versions of the same product, and can include various media types. Use the selectedOrFirstAvailableVariant or variantBySelectedOptions fields to help customers find the right variant based on their selections.

Products can be organized into collections, associated with selling plans for subscriptions, and extended with custom data through metafields.

Learn more about working with products and collections.

A specific version of a product available for sale, differentiated by options like size or color. For example, a small blue t-shirt and a large blue t-shirt are separate variants of the same product. For more information, see the docs on Shopify's product model.

For products with quantity rules, variants enforce minimum, maximum, and increment constraints on purchases.

Variants also support subscriptions and pre-orders through selling plan allocations objects, bundle configurations through product variant components objects, and shop pay installments pricing for flexible payment options.

Represents deferred or recurring purchase options for products and product variants, such as subscriptions, pre-orders, or try-before-you-buy. Each selling plan belongs to a SellingPlanGroup and defines billing, pricing, inventory, and delivery policies.

The central hub for store-wide settings and information accessible through the Storefront API. Provides the shop's name, description, and branding configuration including logos and colors through the Brand object.

Access store policies such as privacy, refund, shipping, and terms of service via ShopPolicy, and the subscription policy via ShopPolicyWithDefault. PaymentSettings expose accepted card brands, supported digital wallets, and enabled presentment currencies. The object also includes the primary Domain, countries the shop ships to, ShopPayInstallmentsPricing, and SocialLoginProvider options for customer accounts.