For the complete documentation index, see llms.txt. This page is also available as Markdown.

📞Why is my customer's shipping address invalid? (Phone number formatting)

Phone numbers that don't match Shopify's required format might throw an invalid shipping address error.

As of 2023, Shopify has changed the requirements for what format a phone number must be in for a customer's shipping address.

Screenshot of Shopify's accepted/valid phone number formats (eg. +16135551212, 6135551212, (613)555-1212)

Tip: To check your store's Shopify settings on requiring a phone number for orders, navigate to Settings > Checkout and scroll to Shipping address phone number. We recommend this be set to either or Don't include or Optional. If set to Required, than all previously purchased customer subscriptions without a phone number will fail to process.

Gif guiding to the shipping address phone number setting under Checkout. If a subscription was created before this setting is set to "Required", then a customer will have an issue updating their address unless they add a phone number (if one was not added before).

If your store has Required checked for customer shopping address phone number, the phone number must match one of the formats required by Shopify. For US-based phone numbers, (starting with +1), these formats include:

  • +1 ###-###-####

  • (###)###-####

  • +1##########

  • ##########

For example:

  • +1 234-567-8901

  • (234)567-8901

  • +12346578901

  • 2346578901

Last updated