---
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: 2026-01
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

* acceptsMarketing
* addresses
* avatarUrl
* createdAt
* defaultAddress
* displayName
* email
* firstName
* id
* lastName
* metafield
* metafields
* numberOfOrders
* orders
* phone
* socialLoginProvider
* tags
* updatedAt

***

## 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

***

## Customer Queries

### Queried by

* [customer](https://shopify.dev/docs/api/storefront/latest/queries/customer)

***

## Mutations

* customerActivate
* customerActivateByUrl
* customerCreate
* customerDefaultAddressUpdate
* customerReset
* customerResetByUrl
* customerUpdate

***

## 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

* HasMetafields

***

## Customer Implements

### Implements

* [Has​Metafields](https://shopify.dev/docs/api/storefront/latest/interfaces/HasMetafields)