--- title: HasMetafields - Customer API description: The information about the metafields associated with the specified resource. api_version: 2025-10 api_name: customer type: interface api_type: graphql source_url: html: https://shopify.dev/docs/api/customer/latest/interfaces/hasmetafields md: https://shopify.dev/docs/api/customer/latest/interfaces/hasmetafields.md --- # Has​Metafields interface The information about the metafields associated with the specified resource. ## Fields * metafield [Metafield](https://shopify.dev/docs/api/customer/latest/objects/Metafield) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A metafield found by namespace and key. * metafields [\[Metafield\]!](https://shopify.dev/docs/api/customer/latest/objects/Metafield) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The metafields associated with the resource matching the supplied list of namespaces and keys. *** ## Types implemented in * [Company](https://shopify.dev/docs/api/customer/latest/objects/Company) OBJECT Represents a company's information. * draft​Orders [Draft​Order​Connection!](https://shopify.dev/docs/api/customer/latest/connections/DraftOrderConnection) non-null The list of company draft orders. * external​Id [String](https://shopify.dev/docs/api/customer/latest/scalars/String) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A unique externally-supplied ID for the company. * id [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A globally-unique ID. * locations [Company​Location​Connection!](https://shopify.dev/docs/api/customer/latest/connections/CompanyLocationConnection) non-null The list of locations that the business of the business contact belongs to. * metafield [Metafield](https://shopify.dev/docs/api/customer/latest/objects/Metafield) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A metafield found by namespace and key. * metafields [\[Metafield\]!](https://shopify.dev/docs/api/customer/latest/objects/Metafield) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The metafields associated with the resource matching the supplied list of namespaces and keys. * name [String!](https://shopify.dev/docs/api/customer/latest/scalars/String) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The name of the company. * orders [Order​Connection!](https://shopify.dev/docs/api/customer/latest/connections/OrderConnection) non-null The list of customer orders under the company. * [Company​Location](https://shopify.dev/docs/api/customer/latest/objects/CompanyLocation) OBJECT Represents a company's business location. * billing​Address [Company​Address](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The billing address of the company location. * buyer​Experience​Configuration [Buyer​Experience​Configuration](https://shopify.dev/docs/api/customer/latest/objects/BuyerExperienceConfiguration) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The configuration of the buyer's B2B checkout. * contacts [Company​Contact​Connection!](https://shopify.dev/docs/api/customer/latest/connections/CompanyContactConnection) non-null The list of contacts under a particular business location. * draft​Orders [Draft​Order​Connection!](https://shopify.dev/docs/api/customer/latest/connections/DraftOrderConnection) non-null The list of company draft orders. * external​Id [String](https://shopify.dev/docs/api/customer/latest/scalars/String) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A unique externally-supplied ID for the location. * id [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A globally-unique ID. * metafield [Metafield](https://shopify.dev/docs/api/customer/latest/objects/Metafield) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A metafield found by namespace and key. * metafields [\[Metafield\]!](https://shopify.dev/docs/api/customer/latest/objects/Metafield) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The metafields associated with the resource matching the supplied list of namespaces and keys. * name [String!](https://shopify.dev/docs/api/customer/latest/scalars/String) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The name of the company location. * orders [Order​Connection!](https://shopify.dev/docs/api/customer/latest/connections/OrderConnection) non-null The list of customer orders under the company. * role​Assignments [Company​Contact​Role​Assignment​Connection!](https://shopify.dev/docs/api/customer/latest/connections/CompanyContactRoleAssignmentConnection) non-null The list of roles assigned to this location. * shipping​Address [Company​Address](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The shipping address of the company location. * store​Credit​Accounts [Store​Credit​Account​Connection!](https://shopify.dev/docs/api/customer/latest/connections/StoreCreditAccountConnection) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A list of the owner resource's store credit accounts. Store credit accounts are not shown for shops with store credit disabled at checkout. * tax​Identifier [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The tax id of the company location. * market [Market!](https://shopify.dev/docs/api/customer/latest/objects/Market) non-nullDeprecated[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) * [Customer](https://shopify.dev/docs/api/customer/latest/objects/Customer) OBJECT Represents the personal information of a customer. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data). * addresses [Customer​Address​Connection!](https://shopify.dev/docs/api/customer/latest/connections/CustomerAddressConnection) non-null The addresses associated with the customer. * company​Contacts [Company​Contact​Connection!](https://shopify.dev/docs/api/customer/latest/connections/CompanyContactConnection) non-null The list of contacts the customer is associated with. * creation​Date [Date​Time!](https://shopify.dev/docs/api/customer/latest/scalars/DateTime) non-null The date and time when the customer was created. * default​Address [Customer​Address](https://shopify.dev/docs/api/customer/latest/objects/CustomerAddress) The default address of the customer. * display​Name [String!](https://shopify.dev/docs/api/customer/latest/scalars/String) non-null The full name of the customer, based on the first\_name and last\_name values. If these aren't available, it falls back to the customer's email address, and if that isn't available, the customer's phone number. * draft​Orders [Draft​Order​Connection!](https://shopify.dev/docs/api/customer/latest/connections/DraftOrderConnection) non-null The Draft Orders associated with the customer. * email​Address [Customer​Email​Address](https://shopify.dev/docs/api/customer/latest/objects/CustomerEmailAddress) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The email address of the customer. * first​Name [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The first name of the customer. * id [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A globally-unique ID. * image​Url [URL!](https://shopify.dev/docs/api/customer/latest/scalars/URL) non-null The URL to the avatar image of the customer. * last​Incomplete​Checkout [Checkout](https://shopify.dev/docs/api/customer/latest/objects/Checkout) The customer's most recently updated, incomplete checkout. * last​Name [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The last name of the customer. * metafield [Metafield](https://shopify.dev/docs/api/customer/latest/objects/Metafield) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A metafield found by namespace and key. * metafields [\[Metafield\]!](https://shopify.dev/docs/api/customer/latest/objects/Metafield) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The metafields associated with the resource matching the supplied list of namespaces and keys. * orders [Order​Connection!](https://shopify.dev/docs/api/customer/latest/connections/OrderConnection) non-null The orders associated with the customer. * phone​Number [Customer​Phone​Number](https://shopify.dev/docs/api/customer/latest/objects/CustomerPhoneNumber) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The phone number of the customer. * store​Credit​Accounts [Store​Credit​Account​Connection!](https://shopify.dev/docs/api/customer/latest/connections/StoreCreditAccountConnection) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A list of the owner resource's store credit accounts. Store credit accounts are not shown for shops with store credit disabled at checkout. * subscription​Contract [Subscription​Contract](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionContract) Returns a `SubscriptionContract` resource by ID. * subscription​Contracts [Subscription​Contract​Connection!](https://shopify.dev/docs/api/customer/latest/connections/SubscriptionContractConnection) non-null The Subscription Contracts associated with the customer. * tags [\[String!\]!](https://shopify.dev/docs/api/customer/latest/scalars/String) non-null A comma-separated list of tags that have been added to the customer. * [Order](https://shopify.dev/docs/api/customer/latest/objects/Order) OBJECT A customer’s completed request to purchase one or more products from a shop. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data). * agreements [Sales​Agreement​Connection!](https://shopify.dev/docs/api/customer/latest/connections/SalesAgreementConnection) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A list of sales agreements associated with the order. * billing​Address [Customer​Address](https://shopify.dev/docs/api/customer/latest/objects/CustomerAddress) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The mailing address provided by the customer. Not all orders have a mailing address. * cancelled​At [Date​Time](https://shopify.dev/docs/api/customer/latest/scalars/DateTime) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The date and time when the order was canceled. Returns `null` if the order wasn't canceled. * cancel​Reason [Order​Cancel​Reason](https://shopify.dev/docs/api/customer/latest/enums/OrderCancelReason) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The reason for the cancellation of the order. Returns `null` if the order wasn't canceled. * confirmation​Number [String](https://shopify.dev/docs/api/customer/latest/scalars/String) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) 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. * created​At [Date​Time!](https://shopify.dev/docs/api/customer/latest/scalars/DateTime) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The date and time when the order was created. * currency​Code [Currency​Code!](https://shopify.dev/docs/api/customer/latest/enums/CurrencyCode) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The shop currency when the order was placed. * customer [Customer](https://shopify.dev/docs/api/customer/latest/objects/Customer) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The customer who placed the order. * customer​Locale [String](https://shopify.dev/docs/api/customer/latest/scalars/String) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The locale code representing the region where this specific order was placed. * discount​Applications [Discount​Application​Connection!](https://shopify.dev/docs/api/customer/latest/connections/DiscountApplicationConnection) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The discounts that have been applied to the order. * draft​Order [Draft​Order](https://shopify.dev/docs/api/customer/latest/objects/DraftOrder) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The draft order associated with the order. * edited [Boolean!](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) Whether the order has been edited or not. * email [String](https://shopify.dev/docs/api/customer/latest/scalars/String) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The email address of the customer. * financial​Status [Order​Financial​Status](https://shopify.dev/docs/api/customer/latest/enums/OrderFinancialStatus) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The financial status of the order. * fulfillments [Fulfillment​Connection!](https://shopify.dev/docs/api/customer/latest/connections/FulfillmentConnection) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The fulfillments associated with the order. * fulfillment​Status [Order​Fulfillment​Status!](https://shopify.dev/docs/api/customer/latest/enums/OrderFulfillmentStatus) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The fulfillment status of the order. * id [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A globally-unique ID. * line​Items [Line​Item​Connection!](https://shopify.dev/docs/api/customer/latest/connections/LineItemConnection) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The list of line items of the order. * location​Name [String](https://shopify.dev/docs/api/customer/latest/scalars/String) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The name of the fulfillment location assigned at the time of order creation. * metafield [Metafield](https://shopify.dev/docs/api/customer/latest/objects/Metafield) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A metafield found by namespace and key. * metafields [\[Metafield\]!](https://shopify.dev/docs/api/customer/latest/objects/Metafield) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The metafields associated with the resource matching the supplied list of namespaces and keys. * name [String!](https://shopify.dev/docs/api/customer/latest/scalars/String) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The identifier for the order that appears on the order. For example, *#1000* or \_Store1001. * note [String](https://shopify.dev/docs/api/customer/latest/scalars/String) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The order's notes. * number [Int!](https://shopify.dev/docs/api/customer/latest/scalars/Int) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A unique numeric identifier for the order, used by both the shop owner and customer. * payment​Information [Order​Payment​Information](https://shopify.dev/docs/api/customer/latest/objects/OrderPaymentInformation) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The payment information for the order. * phone [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The phone number of the customer for SMS notifications. * po​Number [String](https://shopify.dev/docs/api/customer/latest/scalars/String) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The purchase order number of the order. * processed​At [Date​Time!](https://shopify.dev/docs/api/customer/latest/scalars/DateTime) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The date and time when the order was processed. This value can be set to dates in the past when importing from other systems. If no value is provided, it will be auto-generated based on current date and time. * purchasing​Entity [Purchasing​Entity](https://shopify.dev/docs/api/customer/latest/unions/PurchasingEntity) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The purchasing entity for the order. * refunds [\[Refund!\]!](https://shopify.dev/docs/api/customer/latest/objects/Refund) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A list of refunds associated with the order. * requires​Shipping [Boolean!](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) Whether the order requires shipping. * return​Information [Order​Return​Information!](https://shopify.dev/docs/api/customer/latest/objects/OrderReturnInformation) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The return information for the order. * returns [Return​Connection!](https://shopify.dev/docs/api/customer/latest/connections/ReturnConnection) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The list of returns for the order with pagination. * shipping​Address [Customer​Address](https://shopify.dev/docs/api/customer/latest/objects/CustomerAddress) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The mailing address to which the order items are shipped. * shipping​Discount​Allocations [\[Discount​Allocation!\]!](https://shopify.dev/docs/api/customer/latest/objects/DiscountAllocation) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The discounts that have been allocated onto the shipping line by discount applications. * shipping​Line [Shipping​Line](https://shopify.dev/docs/api/customer/latest/objects/ShippingLine) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A summary of all shipping costs on the order. * status​Page​Url [URL!](https://shopify.dev/docs/api/customer/latest/scalars/URL) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The unique URL for the status page of the order. * subscription​Contracts [Subscription​Contract​Connection](https://shopify.dev/docs/api/customer/latest/connections/SubscriptionContractConnection) The customer Subscription Contracts associated with the order. * subtotal [Money​V2](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The price of the order before duties, shipping, and taxes. * total​Duties [Money​V2](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The total amount of duties after returns. * total​Price [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The total amount of the order (including taxes and discounts) minus the amounts for line items that have been returned. * total​Refunded [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The total amount refunded. * total​Shipping [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The total cost of shipping. * total​Tax [Money​V2](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The total cost of taxes. * total​Tip [Money​V2](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The total value of tips. * transactions [\[Order​Transaction!\]!](https://shopify.dev/docs/api/customer/latest/objects/OrderTransaction) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A list of transactions associated with the order. * updated​At [Date​Time!](https://shopify.dev/docs/api/customer/latest/scalars/DateTime) non-null The date and time when the order was last updated. * [Shop](https://shopify.dev/docs/api/customer/latest/objects/Shop) OBJECT A collection of the general information about the shop. * email [String!](https://shopify.dev/docs/api/customer/latest/scalars/String) non-null The email of the shop. * id [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A globally-unique ID. * metafield [Metafield](https://shopify.dev/docs/api/customer/latest/objects/Metafield) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A metafield found by namespace and key. * metafields [\[Metafield\]!](https://shopify.dev/docs/api/customer/latest/objects/Metafield) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The metafields associated with the resource matching the supplied list of namespaces and keys. * myshopify​Domain [String!](https://shopify.dev/docs/api/customer/latest/scalars/String) non-null The shop's .myshopify.com domain name. * name [String!](https://shopify.dev/docs/api/customer/latest/scalars/String) non-null The name of the shop. * shop​Policies [\[Shop​Policy!\]!](https://shopify.dev/docs/api/customer/latest/objects/ShopPolicy) non-null The list of all legal policies associated with the shop. * url [URL!](https://shopify.dev/docs/api/customer/latest/scalars/URL) non-null The URL of the shop's online store. *** ```json { "metafield": { "namespace": "", "key": "" }, "metafields": [ { "identifiers": "" } ] } ```