---
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: 2025-01
api_name: customer
type: scalar
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/customer/2025-01/scalars/String'
  md: 'https://shopify.dev/docs/api/customer/2025-01/scalars/String.md'
---

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

### Inputs with this scalar

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

### Arguments with this scalar

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