--- title: Customer - Storefront API description: A customer represents a customer account with the shop. Customer accounts store contact information for the customer, saving logged-in customers the trouble of having to provide it at every checkout. api_version: 2025-10 api_name: storefront type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/storefront/latest/objects/customer md: https://shopify.dev/docs/api/storefront/latest/objects/customer.md --- # Customer object Requires `unauthenticated_read_customers` access scope. A customer represents a customer account with the shop. Customer accounts store contact information for the customer, saving logged-in customers the trouble of having to provide it at every checkout. ## Fields * accepts​Marketing [Boolean!](https://shopify.dev/docs/api/storefront/latest/scalars/Boolean) non-null Token access required Indicates whether the customer has consented to be sent marketing material via email. * addresses [Mailing​Address​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/MailingAddressConnection) non-null Token access required A list of addresses for the customer. * created​At [Date​Time!](https://shopify.dev/docs/api/storefront/latest/scalars/DateTime) non-null Token access required The date and time when the customer was created. * default​Address [Mailing​Address](https://shopify.dev/docs/api/storefront/latest/objects/MailingAddress) Token access required The customer’s default address. * display​Name [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String) non-null Token access required The customer’s name, email or phone number. * email [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) Token access required The customer’s email address. * first​Name [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) Token access required The customer’s first name. * id [ID!](https://shopify.dev/docs/api/storefront/latest/scalars/ID) non-null Token access required A unique ID for the customer. * last​Name [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) Token access required The customer’s last name. * metafield [Metafield](https://shopify.dev/docs/api/storefront/latest/objects/Metafield) Token access required A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. * metafields [\[Metafield\]!](https://shopify.dev/docs/api/storefront/latest/objects/Metafield) non-null Token access required A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. * number​Of​Orders [Unsigned​Int64!](https://shopify.dev/docs/api/storefront/latest/scalars/UnsignedInt64) non-null Token access required The number of orders that the customer has made at the store in their lifetime. * orders [Order​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/OrderConnection) non-null Token access required The orders associated with the customer. * phone [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) Token access required The customer’s phone number. * tags [\[String!\]!](https://shopify.dev/docs/api/storefront/latest/scalars/String) non-null Token access required A comma separated list of tags that have been added to the customer. Additional access scope required: unauthenticated\_read\_customer\_tags. * updated​At [Date​Time!](https://shopify.dev/docs/api/storefront/latest/scalars/DateTime) non-null Token access required The date and time when the customer information was updated. *** ## Map ### Fields with this object * {}[CartBuyerIdentity.customer](https://shopify.dev/docs/api/storefront/latest/objects/CartBuyerIdentity#field-CartBuyerIdentity.fields.customer) ### Possible type in * [Metafield​Parent​Resource](https://shopify.dev/docs/api/storefront/latest/unions/MetafieldParentResource) *** ## Queries * [customer](https://shopify.dev/docs/api/storefront/latest/queries/customer) query The customer associated with the given access token. Tokens are obtained by using the [`customerAccessTokenCreate` mutation](https://shopify.dev/docs/api/storefront/latest/mutations/customerAccessTokenCreate). *** ## \Customer Queries ### Queried by * \[customer](https://shopify.dev/docs/api/storefront/latest/queries/customer) *** ## Mutations * [customer​Activate](https://shopify.dev/docs/api/storefront/latest/mutations/customerActivate) mutation Activates a customer. * [customer​Activate​By​Url](https://shopify.dev/docs/api/storefront/latest/mutations/customerActivateByUrl) mutation Activates a customer with the activation url received from `customerCreate`. * [customer​Create](https://shopify.dev/docs/api/storefront/latest/mutations/customerCreate) mutation Creates a new customer. * [customer​Default​Address​Update](https://shopify.dev/docs/api/storefront/latest/mutations/customerDefaultAddressUpdate) mutation Updates the default address of an existing customer. * [customer​Reset](https://shopify.dev/docs/api/storefront/latest/mutations/customerReset) mutation "Resets a customer’s password with the token received from a reset password email. You can send a reset password email with the [`customerRecover`](https://shopify.dev/api/storefront/latest/mutations/customerRecover) mutation." * [customer​Reset​By​Url](https://shopify.dev/docs/api/storefront/latest/mutations/customerResetByUrl) mutation "Resets a customer’s password with the reset password URL received from a reset password email. You can send a reset password email with the [`customerRecover`](https://shopify.dev/api/storefront/latest/mutations/customerRecover) mutation." * [customer​Update](https://shopify.dev/docs/api/storefront/latest/mutations/customerUpdate) mutation Updates an existing customer. *** ## <\~> Customer Mutations ### Mutated by * <\~>[customer​Activate](https://shopify.dev/docs/api/storefront/latest/mutations/customerActivate) * <\~>[customer​Activate​By​Url](https://shopify.dev/docs/api/storefront/latest/mutations/customerActivateByUrl) * <\~>[customer​Create](https://shopify.dev/docs/api/storefront/latest/mutations/customerCreate) * <\~>[customer​Default​Address​Update](https://shopify.dev/docs/api/storefront/latest/mutations/customerDefaultAddressUpdate) * <\~>[customer​Reset](https://shopify.dev/docs/api/storefront/latest/mutations/customerReset) * <\~>[customer​Reset​By​Url](https://shopify.dev/docs/api/storefront/latest/mutations/customerResetByUrl) * <\~>[customer​Update](https://shopify.dev/docs/api/storefront/latest/mutations/customerUpdate) *** ## Interfaces * [Has​Metafields](https://shopify.dev/docs/api/storefront/latest/interfaces/HasMetafields) interface *** ## ||-Customer Implements ### Implements * ||-[Has​Metafields](https://shopify.dev/docs/api/storefront/latest/interfaces/HasMetafields)