Adding the what3words Shopify app

There are a number of settings that can be altered via the “Settings” page of the app:

Enable what3words field: By default the what3words address field will be visible on your site. Uncheck this to remove the what3words field.

Enable tooltip: By default an (i) icon will appear next to the field with a tooltip to explain what3words and a link to the what3words Map Site. Uncheck this to remove the icon and tooltip.

Custom field label: By default the field label is what3words address (optional). We recommend keeping this as is but it can be changed if desired.

Custom placeholder: Changes the placeholder text of the field.

AutoSuggest Focus: If the website knows the user’s location then use the location to provide better what3words address suggestions.

Add what3words address to your Order Notes: You can easily add the what3words address as an optional note that a shop owner can attach to the order. Currently, the what3words address is added by default as extra information in the Additional details section of an order details page.

Clipping options: Restrict suggestions to a country, circle, bounding box, or polygon

The what3words address is saved against an order within the Additional Details section of the order page. This can then be printed on order summaries or exported with orders to pass on to delivery companies.

1. Go to the Dashboard of the plugin.
2. From your Shopify admin, go to Settings > Notifications > Order confirmation.
3. Find the Liquid variable {{ shipping_address | format_address }} that references the shipping address.
4. Insert this code immediately below:

   {% if attributes["what3words address"] %} 
      <h4>what3words address</h4> 
      <p>{{ attributes["what3words address"] }}</p> 
   {% endif %}

1. Go to the Dashboard of the plugin.
2. From your Shopify admin, go to Settings > Notifications > Order confirmation.
3. Find the Liquid variable {{ shipping_address | format_address }} that references the shipping address.
4. Insert this code immediately below:

   {% if attributes["what3words address"] %} 
       <h4>what3words address</h4> 
     <p>{{ attributes["what3words address"] }}</p> 
   {% endif %}

Note: This section is for customers that would like to share the what3words address of each order with Order Management Systems.

In Shopify, the what3words address attributes are stored in the customers’ orders of the Shopify Orders REST API as note_attributes and also as note.

For more information on how endpoints and requests to the Shopify REST ADMIN API, please follow this guide.

The API request to make to the Shopify Orders REST API should be:
GET {{your-shopify-site}}/admin/api/2022-07/orders/{{your-order-number}}.json

The API response should be:

"note": "what3words address: ///filled.count.soap"
"note_attributes": [{
    "name": "what3words address",
    "value": "filled.count.soap"
}]

Another way to display easily what you can retrieve from the Shopify REST ADMIN API is by going to the
Admin page > Orders > (number of order) and adding at the end of this path .json.

For example: https://<your-store-site>.myshopify.com/admin/orders/4253206970468.json.

Search for note and note_attributes, your what3words address will be stored within this parameter.

Note: By attaching what3words address to the note the store owner can now print shipping labels and packaging slips with the what3words address as a note of the order.