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

# String

scalar

The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

## Map

### Fields with this scalar

* [Attribute.key](https://shopify.dev/docs/api/customer/latest/objects/Attribute#field-Attribute.fields.key)
* [Attribute.value](https://shopify.dev/docs/api/customer/latest/objects/Attribute#field-Attribute.fields.value)
* [Automatic​Discount​Application.title](https://shopify.dev/docs/api/customer/latest/objects/AutomaticDiscountApplication#field-AutomaticDiscountApplication.fields.title)
* [Business​Customer​User​Error.field](https://shopify.dev/docs/api/customer/latest/objects/BusinessCustomerUserError#field-BusinessCustomerUserError.fields.field)
* [Business​Customer​User​Error.message](https://shopify.dev/docs/api/customer/latest/objects/BusinessCustomerUserError#field-BusinessCustomerUserError.fields.message)
* [Calculated​Requested​Order​Edit​Line​Item​Edge.cursor](https://shopify.dev/docs/api/customer/latest/objects/CalculatedRequestedOrderEditLineItemEdge#field-CalculatedRequestedOrderEditLineItemEdge.fields.cursor)
* [Calculated​Return​Line​Item​Edge.cursor](https://shopify.dev/docs/api/customer/latest/objects/CalculatedReturnLineItemEdge#field-CalculatedReturnLineItemEdge.fields.cursor)
* [Card​Payment​Details.cardBrand](https://shopify.dev/docs/api/customer/latest/objects/CardPaymentDetails#field-CardPaymentDetails.fields.cardBrand)
* [Card​Payment​Details.last4](https://shopify.dev/docs/api/customer/latest/objects/CardPaymentDetails#field-CardPaymentDetails.fields.last4)
* [Company.externalId](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.externalId)
* [Company.name](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.name)
* [Company​Address.address1](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-CompanyAddress.fields.address1)
* [Company​Address.address2](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-CompanyAddress.fields.address2)
* [Company​Address.city](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-CompanyAddress.fields.city)
* [Company​Address.companyName](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-CompanyAddress.fields.companyName)
* [Company​Address.country](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-CompanyAddress.fields.country)
* [Company​Address.firstName](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-CompanyAddress.fields.firstName)
* [Company​Address.formattedAddress](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-CompanyAddress.fields.formattedAddress)
* [Company​Address.formattedArea](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-CompanyAddress.fields.formattedArea)
* [Company​Address.lastName](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-CompanyAddress.fields.lastName)
* [Company​Address.phone](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-CompanyAddress.fields.phone)
* [Company​Address.province](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-CompanyAddress.fields.province)
* [Company​Address.recipient](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-CompanyAddress.fields.recipient)
* [Company​Address.zip](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-CompanyAddress.fields.zip)
* [Company​Address.zoneCode](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress#field-CompanyAddress.fields.zoneCode)
* [Company​Contact.title](https://shopify.dev/docs/api/customer/latest/objects/CompanyContact#field-CompanyContact.fields.title)
* [Company​Contact​Edge.cursor](https://shopify.dev/docs/api/customer/latest/objects/CompanyContactEdge#field-CompanyContactEdge.fields.cursor)
* [Company​Contact​Role.name](https://shopify.dev/docs/api/customer/latest/objects/CompanyContactRole#field-CompanyContactRole.fields.name)
* [Company​Contact​Role​Assignment​Edge.cursor](https://shopify.dev/docs/api/customer/latest/objects/CompanyContactRoleAssignmentEdge#field-CompanyContactRoleAssignmentEdge.fields.cursor)
* [Company​Location.externalId](https://shopify.dev/docs/api/customer/latest/objects/CompanyLocation#field-CompanyLocation.fields.externalId)

### Inputs with this scalar

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

### Arguments with this scalar

* [Calculated​Requested​Order​Edit​Line​Items.removals(after)](https://shopify.dev/docs/api/customer/latest/objects/CalculatedRequestedOrderEditLineItems#field-CalculatedRequestedOrderEditLineItems.fields.removals.arguments.after)
* [Calculated​Requested​Order​Edit​Line​Items.removals(before)](https://shopify.dev/docs/api/customer/latest/objects/CalculatedRequestedOrderEditLineItems#field-CalculatedRequestedOrderEditLineItems.fields.removals.arguments.before)
* [Calculated​Return.returnLineItems(after)](https://shopify.dev/docs/api/customer/latest/objects/CalculatedReturn#field-CalculatedReturn.fields.returnLineItems.arguments.after)
* [Calculated​Return.returnLineItems(before)](https://shopify.dev/docs/api/customer/latest/objects/CalculatedReturn#field-CalculatedReturn.fields.returnLineItems.arguments.before)
* [Company.draftOrders(after)](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.draftOrders.arguments.after)
* [Company.draftOrders(before)](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.draftOrders.arguments.before)
* [Company.draftOrders(query)](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.draftOrders.arguments.query)
* [Company.locations(after)](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.locations.arguments.after)
* [Company.locations(before)](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.locations.arguments.before)
* [Company.locations(query)](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.locations.arguments.query)
* [Company.metafield(key)](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.metafield.arguments.key)
* [Company.metafield(namespace)](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.metafield.arguments.namespace)
* [Company.orders(after)](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.orders.arguments.after)
* [Company.orders(before)](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.orders.arguments.before)
* [Company.orders(query)](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.orders.arguments.query)
* [Company​Contact.draftOrders(after)](https://shopify.dev/docs/api/customer/latest/objects/CompanyContact#field-CompanyContact.fields.draftOrders.arguments.after)
* [Company​Contact.draftOrders(before)](https://shopify.dev/docs/api/customer/latest/objects/CompanyContact#field-CompanyContact.fields.draftOrders.arguments.before)
* [Company​Contact.draftOrders(query)](https://shopify.dev/docs/api/customer/latest/objects/CompanyContact#field-CompanyContact.fields.draftOrders.arguments.query)
* [Company​Contact.locations(after)](https://shopify.dev/docs/api/customer/latest/objects/CompanyContact#field-CompanyContact.fields.locations.arguments.after)
* [Company​Contact.locations(before)](https://shopify.dev/docs/api/customer/latest/objects/CompanyContact#field-CompanyContact.fields.locations.arguments.before)
* [Company​Contact.locations(query)](https://shopify.dev/docs/api/customer/latest/objects/CompanyContact#field-CompanyContact.fields.locations.arguments.query)
* [Company​Contact.orders(after)](https://shopify.dev/docs/api/customer/latest/objects/CompanyContact#field-CompanyContact.fields.orders.arguments.after)
* [Company​Contact.orders(before)](https://shopify.dev/docs/api/customer/latest/objects/CompanyContact#field-CompanyContact.fields.orders.arguments.before)
* [Company​Contact.orders(query)](https://shopify.dev/docs/api/customer/latest/objects/CompanyContact#field-CompanyContact.fields.orders.arguments.query)
* [Company​Location.contacts(after)](https://shopify.dev/docs/api/customer/latest/objects/CompanyLocation#field-CompanyLocation.fields.contacts.arguments.after)
* [Company​Location.contacts(before)](https://shopify.dev/docs/api/customer/latest/objects/CompanyLocation#field-CompanyLocation.fields.contacts.arguments.before)
* [Company​Location.contacts(query)](https://shopify.dev/docs/api/customer/latest/objects/CompanyLocation#field-CompanyLocation.fields.contacts.arguments.query)
* [Company​Location.draftOrders(after)](https://shopify.dev/docs/api/customer/latest/objects/CompanyLocation#field-CompanyLocation.fields.draftOrders.arguments.after)
* [Company​Location.draftOrders(before)](https://shopify.dev/docs/api/customer/latest/objects/CompanyLocation#field-CompanyLocation.fields.draftOrders.arguments.before)
* [Company​Location.draftOrders(query)](https://shopify.dev/docs/api/customer/latest/objects/CompanyLocation#field-CompanyLocation.fields.draftOrders.arguments.query)