---
title: String - Customer API
description: >-
  Represents textual data as UTF-8 character sequences. This type is most often
  used by GraphQL to represent free-form human-readable text.
api_version: 2024-10
api_name: customer
type: scalar
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/customer/2024-10/scalars/String'
  md: 'https://shopify.dev/docs/api/customer/2024-10/scalars/String.txt'
---

# String

scalar

Represents textual data as UTF-8 character sequences. This type is most often used by GraphQL to represent free-form human-readable text.

## Map

### Fields with this scalar

* <-|[Applied​Gift​Card.lastCharacters](https://shopify.dev/docs/api/customer/2024-10/objects/AppliedGiftCard#field-lastCharacters)
* <-|[Attribute.key](https://shopify.dev/docs/api/customer/2024-10/objects/Attribute#field-key)
* <-|[Attribute.value](https://shopify.dev/docs/api/customer/2024-10/objects/Attribute#field-value)
* <-|[Automatic​Discount​Application.title](https://shopify.dev/docs/api/customer/2024-10/objects/AutomaticDiscountApplication#field-title)
* <-|[Business​Customer​User​Error.field](https://shopify.dev/docs/api/customer/2024-10/objects/BusinessCustomerUserError#field-field)
* <-|[Business​Customer​User​Error.message](https://shopify.dev/docs/api/customer/2024-10/objects/BusinessCustomerUserError#field-message)
* <-|[Card​Payment​Details.cardBrand](https://shopify.dev/docs/api/customer/2024-10/objects/CardPaymentDetails#field-cardBrand)
* <-|[Card​Payment​Details.last4](https://shopify.dev/docs/api/customer/2024-10/objects/CardPaymentDetails#field-last4)
* <-|[Checkout.email](https://shopify.dev/docs/api/customer/2024-10/objects/Checkout#field-email)
* <-|[Checkout.note](https://shopify.dev/docs/api/customer/2024-10/objects/Checkout#field-note)
* <-|[Checkout​Line​Item.title](https://shopify.dev/docs/api/customer/2024-10/objects/CheckoutLineItem#field-title)
* <-|[Checkout​Line​Item.variantTitle](https://shopify.dev/docs/api/customer/2024-10/objects/CheckoutLineItem#field-variantTitle)
* <-|[Checkout​Line​Item​Edge.cursor](https://shopify.dev/docs/api/customer/2024-10/objects/CheckoutLineItemEdge#field-cursor)
* <-|[Company.externalId](https://shopify.dev/docs/api/customer/2024-10/objects/Company#field-externalId)
* <-|[Company.name](https://shopify.dev/docs/api/customer/2024-10/objects/Company#field-name)
* <-|[Company​Address.address1](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyAddress#field-address1)
* <-|[Company​Address.address2](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyAddress#field-address2)
* <-|[Company​Address.city](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyAddress#field-city)
* <-|[Company​Address.companyName](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyAddress#field-companyName)
* <-|[Company​Address.country](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyAddress#field-country)
* <-|[Company​Address.firstName](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyAddress#field-firstName)
* <-|[Company​Address.formattedAddress](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyAddress#field-formattedAddress)
* <-|[Company​Address.formattedArea](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyAddress#field-formattedArea)
* <-|[Company​Address.lastName](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyAddress#field-lastName)
* <-|[Company​Address.phone](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyAddress#field-phone)
* <-|[Company​Address.province](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyAddress#field-province)
* <-|[Company​Address.recipient](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyAddress#field-recipient)
* <-|[Company​Address.zip](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyAddress#field-zip)
* <-|[Company​Address.zoneCode](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyAddress#field-zoneCode)
* <-|[Company​Contact.title](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyContact#field-title)

### Inputs with this scalar

* [Company​Address​Input.firstName](https://shopify.dev/docs/api/customer/2024-10/input-objects/CompanyAddressInput#field-firstName)
* [Company​Address​Input.lastName](https://shopify.dev/docs/api/customer/2024-10/input-objects/CompanyAddressInput#field-lastName)
* [Company​Address​Input.recipient](https://shopify.dev/docs/api/customer/2024-10/input-objects/CompanyAddressInput#field-recipient)
* [Company​Address​Input.address1](https://shopify.dev/docs/api/customer/2024-10/input-objects/CompanyAddressInput#field-address1)
* [Company​Address​Input.address2](https://shopify.dev/docs/api/customer/2024-10/input-objects/CompanyAddressInput#field-address2)
* [Company​Address​Input.city](https://shopify.dev/docs/api/customer/2024-10/input-objects/CompanyAddressInput#field-city)
* [Company​Address​Input.phone](https://shopify.dev/docs/api/customer/2024-10/input-objects/CompanyAddressInput#field-phone)
* [Company​Address​Input.zoneCode](https://shopify.dev/docs/api/customer/2024-10/input-objects/CompanyAddressInput#field-zoneCode)
* [Company​Address​Input.zip](https://shopify.dev/docs/api/customer/2024-10/input-objects/CompanyAddressInput#field-zip)
* [Customer​Address​Input.firstName](https://shopify.dev/docs/api/customer/2024-10/input-objects/CustomerAddressInput#field-firstName)
* [Customer​Address​Input.lastName](https://shopify.dev/docs/api/customer/2024-10/input-objects/CustomerAddressInput#field-lastName)
* [Customer​Address​Input.address1](https://shopify.dev/docs/api/customer/2024-10/input-objects/CustomerAddressInput#field-address1)
* [Customer​Address​Input.address2](https://shopify.dev/docs/api/customer/2024-10/input-objects/CustomerAddressInput#field-address2)
* [Customer​Address​Input.city](https://shopify.dev/docs/api/customer/2024-10/input-objects/CustomerAddressInput#field-city)
* [Customer​Address​Input.company](https://shopify.dev/docs/api/customer/2024-10/input-objects/CustomerAddressInput#field-company)
* [Customer​Address​Input.territoryCode](https://shopify.dev/docs/api/customer/2024-10/input-objects/CustomerAddressInput#field-territoryCode)
* [Customer​Address​Input.phoneNumber](https://shopify.dev/docs/api/customer/2024-10/input-objects/CustomerAddressInput#field-phoneNumber)
* [Customer​Address​Input.zoneCode](https://shopify.dev/docs/api/customer/2024-10/input-objects/CustomerAddressInput#field-zoneCode)
* [Customer​Address​Input.zip](https://shopify.dev/docs/api/customer/2024-10/input-objects/CustomerAddressInput#field-zip)
* [Customer​Update​Input.firstName](https://shopify.dev/docs/api/customer/2024-10/input-objects/CustomerUpdateInput#field-firstName)
* [Customer​Update​Input.lastName](https://shopify.dev/docs/api/customer/2024-10/input-objects/CustomerUpdateInput#field-lastName)
* [Has​Metafields​Identifier.namespace](https://shopify.dev/docs/api/customer/2024-10/input-objects/HasMetafieldsIdentifier#field-namespace)
* [Has​Metafields​Identifier.key](https://shopify.dev/docs/api/customer/2024-10/input-objects/HasMetafieldsIdentifier#field-key)
* [Metafield​Identifier​Input.namespace](https://shopify.dev/docs/api/customer/2024-10/input-objects/MetafieldIdentifierInput#field-namespace)
* [Metafield​Identifier​Input.key](https://shopify.dev/docs/api/customer/2024-10/input-objects/MetafieldIdentifierInput#field-key)
* [Metafields​Set​Input.namespace](https://shopify.dev/docs/api/customer/2024-10/input-objects/MetafieldsSetInput#field-namespace)
* [Metafields​Set​Input.key](https://shopify.dev/docs/api/customer/2024-10/input-objects/MetafieldsSetInput#field-key)
* [Metafields​Set​Input.value](https://shopify.dev/docs/api/customer/2024-10/input-objects/MetafieldsSetInput#field-value)
* [Metafields​Set​Input.compareDigest](https://shopify.dev/docs/api/customer/2024-10/input-objects/MetafieldsSetInput#field-compareDigest)
* [Metafields​Set​Input.type](https://shopify.dev/docs/api/customer/2024-10/input-objects/MetafieldsSetInput#field-type)

### Mutations with this scalar

* <\~>[subscription​Contract​Select​Delivery​Method](https://shopify.dev/docs/api/customer/2024-10/mutations/subscriptionContractSelectDeliveryMethod#argument-subscriptionDeliveryOptionsResultToken)

### Arguments with this scalar

* <-|[Checkout.discountApplications(after)](https://shopify.dev/docs/api/customer/2024-10/objects/Checkout#field-discountApplications)
* <-|[Checkout.discountApplications(before)](https://shopify.dev/docs/api/customer/2024-10/objects/Checkout#field-discountApplications)
* <-|[Checkout.lineItems(after)](https://shopify.dev/docs/api/customer/2024-10/objects/Checkout#field-lineItems)
* <-|[Checkout.lineItems(before)](https://shopify.dev/docs/api/customer/2024-10/objects/Checkout#field-lineItems)
* <-|[Company.draftOrders(after)](https://shopify.dev/docs/api/customer/2024-10/objects/Company#field-draftOrders)
* <-|[Company.draftOrders(before)](https://shopify.dev/docs/api/customer/2024-10/objects/Company#field-draftOrders)
* <-|[Company.draftOrders(query)](https://shopify.dev/docs/api/customer/2024-10/objects/Company#field-draftOrders)
* <-|[Company.locations(after)](https://shopify.dev/docs/api/customer/2024-10/objects/Company#field-locations)
* <-|[Company.locations(before)](https://shopify.dev/docs/api/customer/2024-10/objects/Company#field-locations)
* <-|[Company.locations(query)](https://shopify.dev/docs/api/customer/2024-10/objects/Company#field-locations)
* <-|[Company.metafield(namespace)](https://shopify.dev/docs/api/customer/2024-10/objects/Company#field-metafield)
* <-|[Company.metafield(key)](https://shopify.dev/docs/api/customer/2024-10/objects/Company#field-metafield)
* <-|[Company.orders(after)](https://shopify.dev/docs/api/customer/2024-10/objects/Company#field-orders)
* <-|[Company.orders(before)](https://shopify.dev/docs/api/customer/2024-10/objects/Company#field-orders)
* <-|[Company.orders(query)](https://shopify.dev/docs/api/customer/2024-10/objects/Company#field-orders)
* <-|[Company​Contact.draftOrders(after)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyContact#field-draftOrders)
* <-|[Company​Contact.draftOrders(before)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyContact#field-draftOrders)
* <-|[Company​Contact.draftOrders(query)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyContact#field-draftOrders)
* <-|[Company​Contact.locations(after)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyContact#field-locations)
* <-|[Company​Contact.locations(before)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyContact#field-locations)
* <-|[Company​Contact.locations(query)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyContact#field-locations)
* <-|[Company​Contact.orders(after)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyContact#field-orders)
* <-|[Company​Contact.orders(before)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyContact#field-orders)
* <-|[Company​Contact.orders(query)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyContact#field-orders)
* <-|[Company​Location.contacts(after)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyLocation#field-contacts)
* <-|[Company​Location.contacts(before)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyLocation#field-contacts)
* <-|[Company​Location.contacts(query)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyLocation#field-contacts)
* <-|[Company​Location.draftOrders(after)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyLocation#field-draftOrders)
* <-|[Company​Location.draftOrders(before)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyLocation#field-draftOrders)
* <-|[Company​Location.draftOrders(query)](https://shopify.dev/docs/api/customer/2024-10/objects/CompanyLocation#field-draftOrders)