HasMetafieldDefinitions

The name of the author of the article.

The blog containing the article.

The text of the article's body, complete with HTML markup.

List of the article's comments.

Count of comments.

The date and time (ISO 8601 format) when the article was created.

A default cursor that returns the single next record, sorted ascending by ID.

The paginated list of events associated with the host subject.

A unique, human-friendly string for the article that's automatically generated from the article's title. The handle is used in the article's URL.

A globally-unique ID.

The image associated with the article.

Whether or not the article is visible.

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

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

The date and time (ISO 8601 format) when the article became or will become visible. Returns null when the article isn't visible.

A summary of the article, which can include HTML markup. The summary is used by the online store theme to display the article on other pages, such as the home page or the main blog page.

A comma-separated list of tags. Tags are additional short descriptors formatted as a string of comma-separated values.

The name of the template an article is using if it's using an alternate template. If an article is using the default article.liquid template, then the value returned is null.

The title of the article.

The published translations associated with the resource.

The date and time (ISO 8601 format) when the article was last updated.

List of the blog's articles.

Count of articles.

Indicates whether readers can post comments to the blog and if comments are moderated or not.

The date and time when the blog was created.

The paginated list of events associated with the host subject.

FeedBurner provider details. Any blogs that aren't already integrated with FeedBurner can't use the service.

A unique, human-friendly string for the blog. If no handle is specified, a handle will be generated automatically from the blog title. The handle is customizable and is used by the Liquid templating language to refer to the blog.

A globally-unique ID.

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

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

A list of tags associated with the 200 most recent blog articles.

The name of the template a blog is using if it's using an alternate template. Returns null if a blog is using the default blog.liquid template.

The title of the blog.

The published translations associated with the resource.

The date and time when the blog was update.

The number of publications that a resource is published to, without feedback errors.

A single-line, text-only description of the collection, stripped of any HTML tags and formatting that were included in the description.

The description of the collection, including any HTML tags and formatting. This content is typically displayed to customers, such as on an online store, depending on the theme.

The paginated list of events associated with the host subject.

Information about the collection that's provided through resource feedback.

A unique string that identifies the collection. If a handle isn't specified when a collection is created, it's automatically generated from the collection's original title, and typically includes words from the title separated by hyphens. For example, a collection that was created with the title Summer Catalog 2022 might have the handle summer-catalog-2022.

If the title is changed, the handle doesn't automatically change.

The handle can be used in themes by the Liquid templating language to refer to the collection, but using the ID is preferred because it never changes.

Whether the collection includes the specified product.

A globally-unique ID.

The image associated with the collection.

The ID of the corresponding resource in the REST Admin API.

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

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

The products that are included in the collection.

The number of products in the collection.

Whether the resource is published to the app's publication. For example, the resource might be published to the app's online store channel.

Whether the resource is published to a specified publication.

The list of resources that are published to a publication.

The number of publications that a resource is published to, without feedback errors.

The list of resources that are either published or staged to be published to a publication.

For a smart (automated) collection, specifies the rules that determine whether a product is included.

If the default SEO fields for page title and description have been modified, contains the modified information.

The order in which the products in the collection are displayed by default in the Shopify admin and in sales channels, such as an online store.

The suffix of the Liquid template being used to show the collection in an online store. For example, if the value is custom, then the collection is using the collection.custom.liquid template. If the value is null, then the collection is using the default collection.liquid template.

The name of the collection. It's displayed in the Shopify admin and is typically displayed in sales channels, such as an online store.

The published translations associated with the resource.

The list of publications that the resource isn't published to.

The date and time (ISO 8601 format) when the collection was last modified.

The list of roles for the company contacts.

The list of contacts in the company.

The number of contacts that belong to the company.

The date and time (ISO 8601 format) at which the company was created in Shopify.

The date and time (ISO 8601 format) at which the company became the customer.

A default cursor that returns the single next record, sorted ascending by ID.

The role proposed by default for a contact at the company.

The list of the company's draft orders.

The paginated list of events associated with the host subject.

A unique externally-supplied ID for the company.

Whether the merchant added a timeline comment to the company.

A globally-unique ID.

The lifetime duration of the company, since it became a customer of the shop. Examples: 2 days, 3 months, 1 year.

The list of locations in the company.

The number of locations that belong to the company.

The main contact for the company.

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

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

The name of the company.

A note about the company.

The list of the company's orders.

The total number of orders placed for this company, across all its locations.

The total amount spent by this company, across all its locations.

The date and time (ISO 8601 format) at which the company was last modified.

The address used as billing address for the location.

The configuration for the buyer's B2B checkout.

The list of catalogs associated with the company location.

The number of catalogs associated with the company location. Limited to a maximum of 10000 by default.

The company that the company location belongs to.

The date and time (ISO 8601 format) at which the company location was created in Shopify.

The location's currency based on the shipping address. If the shipping address is empty, then the value is the shop's primary market.

A default cursor that returns the single next record, sorted ascending by ID.

The list of draft orders for the company location.

The paginated list of events associated with the host subject.

A unique externally-supplied ID for the company location.

Whether the merchant added a timeline comment to the company location.

A globally-unique ID.

Whether the company location is assigned a specific catalog.

The preferred locale of the company location.

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

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

The name of the company location.

A note about the company location.

The list of orders for the company location.

The total number of orders placed for the location.

The phone number of the company location.

The list of roles assigned to the company location.

The address used as shipping address for the location.

The list of staff members assigned to the company location.

The tax settings for the company location.

The total amount spent by the location.

The date and time (ISO 8601 format) at which the company location was last modified.

A list of addresses associated with the customer.

The addresses associated with the customer.

The total amount that the customer has spent on orders in their lifetime.

Whether the merchant can delete the customer from their store.

A customer can be deleted from a store only if they haven't yet made an order. After a customer makes an order, they can't be deleted from a store.

A list of the customer's company contact profiles.

The date and time when the customer was added to the store.

Whether the customer has opted out of having their data sold.

The default address associated with the customer.

The customer's default email address.

The customer's default phone number.

The full name of the customer, based on the values for first_name and last_name. If the first_name and last_name are not available, then this falls back to the customer's email address, and if that is not available, the customer's phone number.

A list of events associated with the customer.

The customer's first name.

A globally-unique ID.

The image associated with the customer.

The customer's last name.

The customer's last order.

The ID of the corresponding resource in the REST Admin API.

The amount of time since the customer was first added to the store.

Example: 'about 12 years'.

The customer's locale.

Whether the customer can be merged with another customer.

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

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

A unique identifier for the customer that's used with Multipass login.

A note about the customer.

The number of orders that the customer has made at the store in their lifetime.

A list of the customer's orders.

A list of the customer's payment methods.

Possible subscriber states of a customer defined by their subscription contracts.

The state of the customer's account with the shop.

Please note that this only meaningful when Classic Customer Accounts is active.

The statistics for a given customer.

Returns a list of store credit accounts that belong to the owner resource. A store credit account owner can hold multiple accounts each with a different currency.

A list of the customer's subscription contracts.

A comma separated list of tags that have been added to the customer.

Whether the customer is exempt from being charged taxes on their orders.

The list of tax exemptions applied to the customer.

The date and time when the customer was last updated.

Whether the customer has verified their email address. Defaults to true if the customer is created through the Shopify admin or API.

The enabled status of the delivery customization.

The error history on the most recent version of the delivery customization.

The ID of the Shopify Function implementing the delivery customization.

A globally-unique ID.

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

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

The Shopify Function implementing the delivery customization.

The title of the delivery customization.

A discount that's applied automatically when an order meets specific criteria. Learn more about automatic discounts.

The paginated list of events associated with the host subject.

A globally-unique ID.

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

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

The underlying code discount object.

The paginated list of events associated with the host subject.

A globally-unique ID.

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

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

A discount that's applied at checkout or on cart.

Discounts can be automatic or code-based.

The paginated list of events associated with the host subject.

A globally-unique ID.

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

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

Whether the location can be reactivated. If false, then trying to activate the location with the LocationActivate mutation will return an error that describes why the location can't be activated.

The address of this location.

Whether the location address has been verified.

The date and time (ISO 8601 format) that the location was added to a shop.

Whether this location can be deactivated. If true, then the location can be deactivated by calling the LocationDeactivate mutation. If false, then calling the mutation to deactivate it will return an error that describes why the location can't be deactivated.

The date and time (ISO 8601 format) that the location was deactivated at. For example, 3:30 pm on September 7, 2019 in the time zone of UTC (Universal Time Coordinated) is represented as "2019-09-07T15:50:00Z".

Whether this location can be deleted.

Name of the service provider that fulfills from this location.

Whether this location can fulfill online orders.

Whether this location has active inventory.

Whether this location has orders that need to be fulfilled.

A globally-unique ID.

The quantities of an inventory item at this location.

A list of the quantities of the inventory items that can be stocked at this location.

Whether the location is active. A deactivated location can be activated (change isActive: true) if it has activatable set to true by calling the locationActivate mutation.

Whether this location is a fulfillment service.

The ID of the corresponding resource in the REST Admin API.

Local pickup settings for the location.

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

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

The name of the location.

Whether this location is used for calculating shipping rates. In multi-origin shipping mode, this flag is ignored.

List of suggested addresses for this location (empty if none).

The date and time (ISO 8601 format) when the location was last updated.

Whether the market has a customization with the given ID.

The catalogs that belong to the market.

The number of catalogs that belong to the market.

The conditions under which a visitor is in the market.

The market’s currency settings.

A short, human-readable unique identifier for the market. This is changeable by the merchant.

A globally-unique ID.

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

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

The name of the market. Not shown to customers.

The inclusive pricing strategy for a market. This determines if prices include duties and / or taxes.

Status of the market. Replaces the enabled field.

The type of the market.

The market’s web presences, which defines its SEO strategy. This can be a different domain, subdomain, or subfolders of the primary domain. Each web presence comprises one or more language variants. If a market doesn't have any web presences, then the market is accessible on the primary market's domains using country selectors.

A list of additional fees applied to an order, such as duties, import fees, or tax lines.

A list of sales agreements associated with the order, such as contracts defining payment terms, or delivery schedules between merchants and customers.

A list of messages that appear on the Orders page in the Shopify admin. These alerts provide merchants with important information about an order's status or required actions.

The application that created the order. For example, "Online Store", "Point of Sale", or a custom app name. Use this to identify the order source for attribution and fulfillment workflows. Learn more about building apps for orders and fulfillment.

The billing address associated with the payment method selected by the customer for an order. Returns null if no billing address was provided during checkout.

Whether the billing address matches the shipping address. Returns true if both addresses are the same, and false if they're different or if an address is missing.

Details of an order's cancellation, if it has been canceled. This includes the reason, date, and any staff notes.

The date and time in ISO 8601 format when an order was canceled. Returns null if the order hasn't been canceled.

The reason provided for an order cancellation. For example, a merchant might cancel an order if there's insufficient inventory. Returns null if the order hasn't been canceled.

Whether an order can be manually marked as paid. Returns false if the order is already paid, is canceled, has pending Shopify Payments transactions, or has a negative payment amount.

Whether order notifications can be sent to the customer. Returns true if the customer has a valid email address.

Whether an authorized payment for an order can be captured. Returns true if an authorized payment exists that hasn't been fully captured yet. Learn more about capturing payments.

The total discount amount applied at the time the order was created, displayed in both shop and presentment currencies, before returns, refunds, order edits, and cancellations. This field only includes discounts applied to the entire order.

Details about the sales channel that created the order, such as the channel app type and channel name, which helps to track order sources.

The IP address of the customer who placed the order. Useful for fraud detection and geographic analysis.

Whether an order is closed. An order is considered closed if all its line items have been fulfilled or canceled, and all financial transactions are complete.

The date and time ISO 8601 format when an order was closed. Shopify automatically records this timestamp when all items have been fulfilled or canceled, and all financial transactions are complete. Returns null if the order isn't closed.

A customer-facing order identifier, often shown instead of the sequential order name. It uses a random alphanumeric format (for example, XPAV284CT) and isn't guaranteed to be unique across orders.

Whether inventory has been reserved for an order. Returns true if inventory quantities for an order's line items have been reserved. Learn more about managing inventory quantities and states.

The date and time in ISO 8601 format when an order was created. This timestamp is set when the customer completes checkout and remains unchanged throughout an order's lifecycle.

The shop currency when the order was placed. For example, "USD" or "CAD".

The current total of all discounts applied to the entire order, after returns, refunds, order edits, and cancellations. This includes discount codes, automatic discounts, and other promotions that affect the whole order rather than individual line items. To get the original discount amount at the time of order creation, use the cartDiscountAmountSet field.

The current shipping price after applying refunds and discounts. If the parent order.taxesIncluded field is true, then this price includes taxes. Otherwise, this field is the pre-tax price.

The current sum of the quantities for all line items that contribute to the order's subtotal price, after returns, refunds, order edits, and cancellations.

The total price of the order, after returns and refunds, in shop and presentment currencies. This includes taxes and discounts.

A list of all tax lines applied to line items on the order, after returns. Tax line prices represent the total price for all tax lines with the same rate and title.

The current total of all additional fees for an order, after any returns or modifications. Modifications include returns, refunds, order edits, and cancellations. Additional fees can include charges such as duties, import fees, and special handling.

The total amount discounted on the order after returns and refunds, in shop and presentment currencies. This includes both order and line level discounts.

The current total duties amount for an order, after any returns or modifications. Modifications include returns, refunds, order edits, and cancellations.

The total price of the order, after returns, in shop and presentment currencies. This includes taxes and discounts.

The sum of the prices of all tax lines applied to line items on the order, after returns and refunds, in shop and presentment currencies.

The total weight of the order after returns and refunds, in grams.

A list of additional information that has been attached to the order. For example, gift message, delivery instructions, or internal notes.

The customer who placed an order. Returns null if an order was created through a checkout without customer authentication, such as a guest checkout. Learn more about customer accounts.

Whether the customer agreed to receive marketing emails at the time of purchase. Use this to ensure compliance with marketing consent laws and to segment customers for email campaigns. Learn more about building customer segments.

The customer's visits and interactions with the online store before placing the order. Use this to understand customer behavior, attribution sources, and marketing effectiveness to optimize your sales funnel.

The customer's language and region preference at the time of purchase. For example, "en" for English, "fr-CA" for French (Canada), or "es-MX" for Spanish (Mexico). Use this to provide localized customer service and targeted marketing in the customer's preferred language.

A list of discounts that are applied to the order, excluding order edits and refunds. Includes discount codes, automatic discounts, and other promotions that reduce the order total.

The discount code used for an order. Returns null if no discount code was applied.

The discount codes used for the order. Multiple codes can be applied to a single order.

The primary address of the customer, prioritizing shipping address over billing address when both are available. Returns null if neither shipping address nor billing address was provided.

An order's financial status for display in the Shopify admin.

The order's fulfillment status that displays in the Shopify admin to merchants. For example, an order might be unfulfilled or scheduled. For detailed processing, use the FulfillmentOrder object.

A list of payment disputes associated with the order, such as chargebacks or payment inquiries. Disputes occur when customers challenge transactions with their bank or payment provider.

Whether duties are included in the subtotal price of the order. Duties are import taxes charged by customs authorities when goods cross international borders.

Whether the order has had any edits applied. For example, adding or removing line items, updating quantities, or changing prices.

The email address associated with the customer for this order. Used for sending order confirmations, shipping notifications, and other order-related communications. Returns null if no email address was provided during checkout.

Whether taxes on the order are estimated. This field returns false when taxes on the order are finalized and aren't subject to any changes.

A list of events associated with the order. Events track significant changes and activities related to the order, such as creation, payment, fulfillment, and cancellation.

Whether there are line items that can be fulfilled. This field returns false when the order has no fulfillable line items. For a more granular view of the fulfillment status, refer to the FulfillmentOrder object.

A list of fulfillment orders for an order. Each fulfillment order groups line items that are fulfilled together, allowing an order to be processed in parts if needed.

A list of shipments for the order. Fulfillments represent the physical shipment of products to customers.

The total number of fulfillments for the order, including canceled ones.

Whether the order has been paid in full. This field returns true when the total amount received equals or exceeds the order total.

Whether the merchant has added a timeline comment to the order.

A globally-unique ID.

The ID of the corresponding resource in the REST Admin API.

A list of the order's line items. Line items represent the individual products and quantities that make up the order.

List of localized fields for the resource.

The legal business structure that the merchant operates under for this order, such as an LLC, corporation, or partnership. Used for tax reporting, legal compliance, and determining which business entity is responsible for the order.

Whether the order can be edited by the merchant. Returns false for orders that can't be modified, such as canceled orders or orders with specific payment statuses.

A list of reasons why the order can't be edited. For example, canceled orders can't be edited.

The application acting as the Merchant of Record for the order. The Merchant of Record is responsible for tax collection and remittance.

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