--- title: String - Storefront 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: storefront type: scalar api_type: graphql source_url: html: 'https://shopify.dev/docs/api/storefront/2024-10/scalars/String' md: 'https://shopify.dev/docs/api/storefront/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 * <-|[Api​Version.displayName](https://shopify.dev/docs/api/storefront/2024-10/objects/ApiVersion#field-displayName) * <-|[Api​Version.handle](https://shopify.dev/docs/api/storefront/2024-10/objects/ApiVersion#field-handle) * <-|[Applied​Gift​Card.lastCharacters](https://shopify.dev/docs/api/storefront/2024-10/objects/AppliedGiftCard#field-lastCharacters) * <-|[Article.content](https://shopify.dev/docs/api/storefront/2024-10/objects/Article#field-content) * <-|[Article.excerpt](https://shopify.dev/docs/api/storefront/2024-10/objects/Article#field-excerpt) * <-|[Article.handle](https://shopify.dev/docs/api/storefront/2024-10/objects/Article#field-handle) * <-|[Article.tags](https://shopify.dev/docs/api/storefront/2024-10/objects/Article#field-tags) * <-|[Article.title](https://shopify.dev/docs/api/storefront/2024-10/objects/Article#field-title) * <-|[Article.trackingParameters](https://shopify.dev/docs/api/storefront/2024-10/objects/Article#field-trackingParameters) * <-|[Article​Author.bio](https://shopify.dev/docs/api/storefront/2024-10/objects/ArticleAuthor#field-bio) * <-|[Article​Author.email](https://shopify.dev/docs/api/storefront/2024-10/objects/ArticleAuthor#field-email) * <-|[Article​Author.firstName](https://shopify.dev/docs/api/storefront/2024-10/objects/ArticleAuthor#field-firstName) * <-|[Article​Author.lastName](https://shopify.dev/docs/api/storefront/2024-10/objects/ArticleAuthor#field-lastName) * <-|[Article​Author.name](https://shopify.dev/docs/api/storefront/2024-10/objects/ArticleAuthor#field-name) * <-|[Article​Edge.cursor](https://shopify.dev/docs/api/storefront/2024-10/objects/ArticleEdge#field-cursor) * <-|[Attribute.key](https://shopify.dev/docs/api/storefront/2024-10/objects/Attribute#field-key) * <-|[Attribute.value](https://shopify.dev/docs/api/storefront/2024-10/objects/Attribute#field-value) * <-|[Automatic​Discount​Application.title](https://shopify.dev/docs/api/storefront/2024-10/objects/AutomaticDiscountApplication#field-title) * <-|[Base​Cart​Line​Edge.cursor](https://shopify.dev/docs/api/storefront/2024-10/objects/BaseCartLineEdge#field-cursor) * <-|[Blog.handle](https://shopify.dev/docs/api/storefront/2024-10/objects/Blog#field-handle) * <-|[Blog.title](https://shopify.dev/docs/api/storefront/2024-10/objects/Blog#field-title) * <-|[Blog​Edge.cursor](https://shopify.dev/docs/api/storefront/2024-10/objects/BlogEdge#field-cursor) * <-|[Brand.shortDescription](https://shopify.dev/docs/api/storefront/2024-10/objects/Brand#field-shortDescription) * <-|[Brand.slogan](https://shopify.dev/docs/api/storefront/2024-10/objects/Brand#field-slogan) * <-|[Cart.note](https://shopify.dev/docs/api/storefront/2024-10/objects/Cart#field-note) * <-|[Cart​Automatic​Discount​Allocation.title](https://shopify.dev/docs/api/storefront/2024-10/objects/CartAutomaticDiscountAllocation#field-title) * <-|[Cart​Buyer​Identity.email](https://shopify.dev/docs/api/storefront/2024-10/objects/CartBuyerIdentity#field-email) * <-|[Cart​Buyer​Identity.phone](https://shopify.dev/docs/api/storefront/2024-10/objects/CartBuyerIdentity#field-phone) * <-|[Cart​Code​Discount​Allocation.code](https://shopify.dev/docs/api/storefront/2024-10/objects/CartCodeDiscountAllocation#field-code) * <-|[Cart​Custom​Discount​Allocation.title](https://shopify.dev/docs/api/storefront/2024-10/objects/CartCustomDiscountAllocation#field-title) ### Inputs with this scalar * [Attribute​Input.key](https://shopify.dev/docs/api/storefront/2024-10/input-objects/AttributeInput#field-key) * [Attribute​Input.value](https://shopify.dev/docs/api/storefront/2024-10/input-objects/AttributeInput#field-value) * [Buyer​Input.customerAccessToken](https://shopify.dev/docs/api/storefront/2024-10/input-objects/BuyerInput#field-customerAccessToken) * [Cart​Buyer​Identity​Input.email](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartBuyerIdentityInput#field-email) * [Cart​Buyer​Identity​Input.phone](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartBuyerIdentityInput#field-phone) * [Cart​Buyer​Identity​Input.customerAccessToken](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartBuyerIdentityInput#field-customerAccessToken) * [Cart​Delivery​Preference​Input.pickupHandle](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartDeliveryPreferenceInput#field-pickupHandle) * [Cart​Input.discountCodes](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartInput#field-discountCodes) * [Cart​Input.giftCardCodes](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartInput#field-giftCardCodes) * [Cart​Input.note](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartInput#field-note) * [Cart​Input​Metafield​Input.key](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartInputMetafieldInput#field-key) * [Cart​Input​Metafield​Input.value](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartInputMetafieldInput#field-value) * [Cart​Input​Metafield​Input.type](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartInputMetafieldInput#field-type) * [Cart​Metafield​Delete​Input.key](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartMetafieldDeleteInput#field-key) * [Cart​Metafields​Set​Input.key](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartMetafieldsSetInput#field-key) * [Cart​Metafields​Set​Input.value](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartMetafieldsSetInput#field-value) * [Cart​Metafields​Set​Input.type](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartMetafieldsSetInput#field-type) * [Cart​Preferences​Input.wallet](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartPreferencesInput#field-wallet) * [Cart​Selected​Delivery​Option​Input.deliveryOptionHandle](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CartSelectedDeliveryOptionInput#field-deliveryOptionHandle) * [Customer​Access​Token​Create​Input.email](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CustomerAccessTokenCreateInput#field-email) * [Customer​Access​Token​Create​Input.password](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CustomerAccessTokenCreateInput#field-password) * [Customer​Activate​Input.activationToken](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CustomerActivateInput#field-activationToken) * [Customer​Activate​Input.password](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CustomerActivateInput#field-password) * [Customer​Create​Input.firstName](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CustomerCreateInput#field-firstName) * [Customer​Create​Input.lastName](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CustomerCreateInput#field-lastName) * [Customer​Create​Input.email](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CustomerCreateInput#field-email) * [Customer​Create​Input.phone](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CustomerCreateInput#field-phone) * [Customer​Create​Input.password](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CustomerCreateInput#field-password) * [Customer​Reset​Input.resetToken](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CustomerResetInput#field-resetToken) * [Customer​Reset​Input.password](https://shopify.dev/docs/api/storefront/2024-10/input-objects/CustomerResetInput#field-password) ### Mutations with this scalar * <\~>[cart​Discount​Codes​Update](https://shopify.dev/docs/api/storefront/2024-10/mutations/cartDiscountCodesUpdate#argument-discountCodes) * <\~>[cart​Gift​Card​Codes​Update](https://shopify.dev/docs/api/storefront/2024-10/mutations/cartGiftCardCodesUpdate#argument-giftCardCodes) * <\~>[cart​Note​Update](https://shopify.dev/docs/api/storefront/2024-10/mutations/cartNoteUpdate#argument-note) * <\~>[customer​Access​Token​Create​With​Multipass](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAccessTokenCreateWithMultipass#argument-multipassToken) * <\~>[customer​Access​Token​Delete](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAccessTokenDelete#argument-customerAccessToken) * <\~>[customer​Access​Token​Renew](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAccessTokenRenew#argument-customerAccessToken) * <\~>[customer​Activate​By​Url](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerActivateByUrl#argument-password) * <\~>[customer​Address​Create](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAddressCreate#argument-customerAccessToken) * <\~>[customer​Address​Delete](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAddressDelete#argument-customerAccessToken) * <\~>[customer​Address​Update](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAddressUpdate#argument-customerAccessToken) * <\~>[customer​Default​Address​Update](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerDefaultAddressUpdate#argument-customerAccessToken) * <\~>[customer​Recover](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerRecover#argument-email) * <\~>[customer​Reset​By​Url](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerResetByUrl#argument-password) * <\~>[customer​Update](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerUpdate#argument-customerAccessToken) * <\~>[shop​Pay​Payment​Request​Session​Create](https://shopify.dev/docs/api/storefront/2024-10/mutations/shopPayPaymentRequestSessionCreate#argument-sourceIdentifier) * <\~>[shop​Pay​Payment​Request​Session​Submit](https://shopify.dev/docs/api/storefront/2024-10/mutations/shopPayPaymentRequestSessionSubmit#argument-token) * <\~>[shop​Pay​Payment​Request​Session​Submit](https://shopify.dev/docs/api/storefront/2024-10/mutations/shopPayPaymentRequestSessionSubmit#argument-idempotencyKey) * <\~>[shop​Pay​Payment​Request​Session​Submit](https://shopify.dev/docs/api/storefront/2024-10/mutations/shopPayPaymentRequestSessionSubmit#argument-orderName) ### Queries with this scalar * \[articles.after](https://shopify.dev/docs/api/storefront/2024-10/queries/articles#field-after) * \[articles.before](https://shopify.dev/docs/api/storefront/2024-10/queries/articles#field-before) * \[articles.query](https://shopify.dev/docs/api/storefront/2024-10/queries/articles#field-query) * \[blog.handle](https://shopify.dev/docs/api/storefront/2024-10/queries/blog#field-handle) * \[blogs.after](https://shopify.dev/docs/api/storefront/2024-10/queries/blogs#field-after) * \[blogs.before](https://shopify.dev/docs/api/storefront/2024-10/queries/blogs#field-before) * \[blogs.query](https://shopify.dev/docs/api/storefront/2024-10/queries/blogs#field-query) * \[collection.handle](https://shopify.dev/docs/api/storefront/2024-10/queries/collection#field-handle) * \[collections.after](https://shopify.dev/docs/api/storefront/2024-10/queries/collections#field-after) * \[collections.before](https://shopify.dev/docs/api/storefront/2024-10/queries/collections#field-before) * \[collections.query](https://shopify.dev/docs/api/storefront/2024-10/queries/collections#field-query) * \[customer.customerAccessToken](https://shopify.dev/docs/api/storefront/2024-10/queries/customer#field-customerAccessToken) * \[locations.after](https://shopify.dev/docs/api/storefront/2024-10/queries/locations#field-after) * \[locations.before](https://shopify.dev/docs/api/storefront/2024-10/queries/locations#field-before) * \[menu.handle](https://shopify.dev/docs/api/storefront/2024-10/queries/menu#field-handle) * \[metaobjects.type](https://shopify.dev/docs/api/storefront/2024-10/queries/metaobjects#field-type) * \[metaobjects.sortKey](https://shopify.dev/docs/api/storefront/2024-10/queries/metaobjects#field-sortKey) * \[metaobjects.after](https://shopify.dev/docs/api/storefront/2024-10/queries/metaobjects#field-after) * \[metaobjects.before](https://shopify.dev/docs/api/storefront/2024-10/queries/metaobjects#field-before) * \[page.handle](https://shopify.dev/docs/api/storefront/2024-10/queries/page#field-handle) * \[pages.after](https://shopify.dev/docs/api/storefront/2024-10/queries/pages#field-after) * \[pages.before](https://shopify.dev/docs/api/storefront/2024-10/queries/pages#field-before) * \[pages.query](https://shopify.dev/docs/api/storefront/2024-10/queries/pages#field-query) * \[predictive​Search.query](https://shopify.dev/docs/api/storefront/2024-10/queries/predictiveSearch#field-query) * \[product.handle](https://shopify.dev/docs/api/storefront/2024-10/queries/product#field-handle) * \[product​Recommendations.productHandle](https://shopify.dev/docs/api/storefront/2024-10/queries/productRecommendations#field-productHandle) * \[products.after](https://shopify.dev/docs/api/storefront/2024-10/queries/products#field-after) * \[products.before](https://shopify.dev/docs/api/storefront/2024-10/queries/products#field-before) * \[products.query](https://shopify.dev/docs/api/storefront/2024-10/queries/products#field-query) * \[search.after](https://shopify.dev/docs/api/storefront/2024-10/queries/search#field-after) ### Arguments with this scalar * <-|[Article.comments(after)](https://shopify.dev/docs/api/storefront/2024-10/objects/Article#field-comments) * <-|[Article.comments(before)](https://shopify.dev/docs/api/storefront/2024-10/objects/Article#field-comments) * <-|[Article.metafield(namespace)](https://shopify.dev/docs/api/storefront/2024-10/objects/Article#field-metafield) * <-|[Article.metafield(key)](https://shopify.dev/docs/api/storefront/2024-10/objects/Article#field-metafield) * <-|[Base​Cart​Line.attribute(key)](https://shopify.dev/docs/api/storefront/2024-10/objects/BaseCartLine#field-attribute) * <-|[Blog.articleByHandle(handle)](https://shopify.dev/docs/api/storefront/2024-10/objects/Blog#field-articleByHandle) * <-|[Blog.articles(after)](https://shopify.dev/docs/api/storefront/2024-10/objects/Blog#field-articles) * <-|[Blog.articles(before)](https://shopify.dev/docs/api/storefront/2024-10/objects/Blog#field-articles) * <-|[Blog.articles(query)](https://shopify.dev/docs/api/storefront/2024-10/objects/Blog#field-articles) * <-|[Blog.metafield(namespace)](https://shopify.dev/docs/api/storefront/2024-10/objects/Blog#field-metafield) * <-|[Blog.metafield(key)](https://shopify.dev/docs/api/storefront/2024-10/objects/Blog#field-metafield) * <-|[Cart.attribute(key)](https://shopify.dev/docs/api/storefront/2024-10/objects/Cart#field-attribute) * <-|[Cart.deliveryGroups(after)](https://shopify.dev/docs/api/storefront/2024-10/objects/Cart#field-deliveryGroups) * <-|[Cart.deliveryGroups(before)](https://shopify.dev/docs/api/storefront/2024-10/objects/Cart#field-deliveryGroups) * <-|[Cart.lines(after)](https://shopify.dev/docs/api/storefront/2024-10/objects/Cart#field-lines) * <-|[Cart.lines(before)](https://shopify.dev/docs/api/storefront/2024-10/objects/Cart#field-lines) * <-|[Cart.metafield(namespace)](https://shopify.dev/docs/api/storefront/2024-10/objects/Cart#field-metafield) * <-|[Cart.metafield(key)](https://shopify.dev/docs/api/storefront/2024-10/objects/Cart#field-metafield) * <-|[Cart​Delivery​Group.cartLines(after)](https://shopify.dev/docs/api/storefront/2024-10/objects/CartDeliveryGroup#field-cartLines) * <-|[Cart​Delivery​Group.cartLines(before)](https://shopify.dev/docs/api/storefront/2024-10/objects/CartDeliveryGroup#field-cartLines) * <-|[Cart​Line.attribute(key)](https://shopify.dev/docs/api/storefront/2024-10/objects/CartLine#field-attribute) * <-|[Collection.metafield(namespace)](https://shopify.dev/docs/api/storefront/2024-10/objects/Collection#field-metafield) * <-|[Collection.metafield(key)](https://shopify.dev/docs/api/storefront/2024-10/objects/Collection#field-metafield) * <-|[Collection.products(after)](https://shopify.dev/docs/api/storefront/2024-10/objects/Collection#field-products) * <-|[Collection.products(before)](https://shopify.dev/docs/api/storefront/2024-10/objects/Collection#field-products) * <-|[Company.metafield(namespace)](https://shopify.dev/docs/api/storefront/2024-10/objects/Company#field-metafield) * <-|[Company.metafield(key)](https://shopify.dev/docs/api/storefront/2024-10/objects/Company#field-metafield) * <-|[Company​Location.metafield(namespace)](https://shopify.dev/docs/api/storefront/2024-10/objects/CompanyLocation#field-metafield) * <-|[Company​Location.metafield(key)](https://shopify.dev/docs/api/storefront/2024-10/objects/CompanyLocation#field-metafield) * <-|[Componentizable​Cart​Line.attribute(key)](https://shopify.dev/docs/api/storefront/2024-10/objects/ComponentizableCartLine#field-attribute)