Merchant-to-customer content

    Shopify creates content for different audiences. One of those audiences is merchants’ customers. A customer is a person or organization who interacts with a Shopify merchant or a merchant’s sale channel.

    Merchant-to-customer content represents the merchant, not Shopify, and should optimize the customers’ online or retail store experience.

    Every UX discipline is encouraged to create content at Shopify. Use this guide when you’re writing content that a customer will see on a Shopify store or receive from a merchant.

    You’ll find merchant-to-customer content in places such as:

    • Online store checkout pages
    • Shipping update emails
    • Return labels and emails
    • Point of Sale (POS) screens, such as digital receipts and payment errors

    What it isn’t

    If you write for multiple audiences, it’s important to note that merchant-to-customer content isn’t:

    • Shopify-to-buyer (see definition for buyer content, such as Shopify Pay or Arrive)
    • Shopify-to-merchant content, such as the Shopify admin
    • Shopify-to-world content, such as or blog posts

    Experience values for customers

    Shopify has a set of experience values. The ones to focus on when creating merchant-to-customer content are:


    Wherever and however a customer uses a Shopify experience (even if they don’t know it’s Shopify), we want it to work for them. The best Shopify experiences work on every screen, on every platform, in every language, and in every country.


    Shopify experiences help customers achieve goals faster, more accurately, and with less effort. We break complex tasks down into simple steps, use friction to highlight important decisions, and always set expectations about what will happen next.


    Shopify experiences are genuine, always honest, and transparent. We show customers that merchants act in the customer’s best interest. We create communication that strengthens the trust customers have in merchants.

    Merchant voice and tone

    Merchant voice and tone is customer-focused.

    Shopify merchants sell everything from physical products, such as eco-sneakers, to digital products, like music downloads. The language they use is very different from store to store. This means that when writing from a merchant perspective, we use a voice that’s appropriate on any store, and for any type of customer. Merchant-to-customer content shouldn’t sound out of place coming from any merchant.

    Human, but not individual

    Too much personality is inappropriate for some stores. Customers aren’t going through the purchase experience to admire the witty content. Research shows that the majority of people want content that’s easy to understand and communicates concepts efficiently. Not robotic. Not full of personality. Just clear and straightforward to help them complete their task.

    Keep in mind that some content, such as emails, can be personalized by merchants. You’re providing a default for them to work from.


    • Your payment details couldn’t be verified. Check your card details and try again.

    • All transactions are secure and encrypted.

    • Select the address that matches your card or payment method.

    • Thanks!

      This example is when the customer finishes checkout in person (all other examples are from online checkout).


    • A fatal error occurred.

    Whoops! Houston, we have a problem!

    • Don’t worry, your details are safe with us!
    • Address must correspond with that held by your payment provider.
    • Thanks for stopping by! or See you again soon!

    Shopping, not ecommerce: use shopper terms

    Avoid technical or ecommerce terms. Customers are interested in their order and their delivery, not in inventory and fulfillment. They might want to sign up for news and exclusive offers, but not marketing emails.


    • Enter your name exactly as it’s written on your card.
    • You’ll get shipping and delivery updates by email.


    • There was a server verification error with your payment provider.
    • We’ll inform you when we’ve fulfilled your order.

    Concise, but not short

    It’s important that any purchase flow is efficient. Use short, easy-to-understand words and phrases. For example:


    • Use “to”
    • Use “go to”
    • There was a problem with our payments


    • Don’t use “in order to”
    • Don’t use “proceed to”
    • No payment gateway is currently configured

    But remember that clear beats short. Don’t use content that can be interpreted in different ways. For example, does “bi-weekly” mean twice a week or every two weeks? It’s clearer to say “Every 2 weeks.” Using more words is okay if it provides clarity.


    • Every two weeks
    • Getting available shipping rates


    • Bi-weekly
    • Loading

    No matter who the audience is, all Shopify content follows the same grammar and mechanics and product content guidelines.

    Read our general voice and tone guidelines to compare how Shopify talks to merchants.

    Vocabulary considerations

    “Buyer” and “customer” are similar so it’s easy to confuse the use of these terms.

    A “buyer” interacts with multiple Shopify stores or has a direct relationship with Shopify, such as through Shopify Pay.

    In contrast, a “customer” is a person or organization who interacts with a Shopify merchant or a merchant’s sale channel.

    In the Shopify admin and Point-of-Sale (POS), a customer appears on the Customers page when they engage with a merchant in an identifiable way. This could be because they:

    • were added or imported by the merchant
    • started a purchase but abandoned it at checkout
    • made a purchase
    • create a customer account
    • subscribed to the merchant's mailing list

    Word usage to use/avoid:


    • Use the store name in place of “merchant”
    • Be direct and use “you”
    • Focus on the merchant-to-customer relationship
    • Use “text message” or “message” when writing for North American audiences
    • Use noun + verb phrases for success messages, for example, ”payment sent”
    • There was a problem with our payments


    • Merchant (in place of store name)
    • Customer or customer (in place of “you”)
    • Shopify (keep Shopify out of the conversation)
    • SMS
    • Oh happy day! (don’t be over-congratulatory)
    • Wrong, fail, failure, error (avoid sounding robotic or negative)