(old version) v02- Locker map - Order confirmation email - Shopify Basic

Modified on Sun, 25 Oct at 1:44 AM

v0.2  The locker map available for the new Checkout version


With the recent changes in Shopify that remove access to customizing the Checkout and Thank You pages, there is no longer a method to add scripts in the Order Status Page - Additional Scripts section to display the locker map on the Thank You page. Only stores subscribed to Shopify Plus can still benefit from this functionality, allowing the locker map to be displayed directly in Checkout.


To support the Shopify stores that do not have Shopify Plus activated, we have implemented a solution that still allows them to offer locker delivery to their customers. 



How does it work?


  1. The Locker Delivery shipping method is displayed on the Checkout page.
  2. The customer selects the Locker Delivery option and completes the order.
  3. The customer receive the Order Confirmation email sent by Shopify.
  4. In the email body, a link is provided. When accessed, it opens the locker map.
  5. The customer selects a locker, and it is saved at the order details level.
  6. In xConnector, the order is marked as Locker Delivery, has a selected locker, and you can generate a shipping label with locker delivery.





Steps to Implement the Locker Map Widget in the Order Confirmation Email



  1. Save the script for adding the locker map in the Order Confirmation email

    (click here to open the new script - V0.2 script) 

  2. Shopify > Settings > Notifications > Customer Notifications > Order Confirmation > Edit Code 

  3. Add the script just before the following line of code:

    {% if order_status_url %}

  4. Replace the following two parameters in the script:

    • locker-delivery: The shipping method name defined in Shopify > Settings > Shipping and Delivery (you can name it as you wish; "Locker Delivery" is just an example).

    • access-token-from-profile-tools: The access token from xConnector > Profile > Tools > Access Token.

  5. In xConnector, activate the locker function for the connected couriers:

    • xConnector > Profile > Connected Services > Courier > Collect Points > Collect Points [ON] > Save



Enhancing Clarity in Checkout for the customers



To make it clearer for customers where they will select the locker, you can display a helper text below the Locker Delivery method in Checkout:

  • Shopify > Settings > Shipping and Delivery > Edit Rate





After the customer has completed the order, they will receive the Shipping Confirmation, which includes this link.








The customer clicks on the Choose the locker link, the locker map opens, and then selects the desired locker.


One of the most common mistakes when saving the script is using quatation marks in a different format than the ones accepted by the script especially in the following line of code
{% if shipping_method.title == "delivery-method-name-from-Shopify" and showMap == true %}


✅ "" (correct)
❌ ““ (incorrect)






How can I add a locker if it’s missing from the order?



If you offer the locker delivery option it can happen that in some cases, the customer might forget selecting a locker.


For this situation, we have implemented a Flow where the store is notified and will receive an email every time an order is placed with locker delivery, but a locker has not been selected (within 10 minutes of placing the order.



https://xconnector.freshdesk.com/support/solutions/articles/103000310539-delivery-to-a-locker-order-but-locker-is-not-selected



To save a locker  to the order or to modify an existent one, you can select the desired locker from the map by clicking the icon below. 


You can find it on the Recipient page when generating an individual shipping label.





How to check if the locker is selected?


  • Go to xConnector
  • Click on the order number
  • Up-right there is Additional details
  • Here should be displayed a Location ID, the Location name and the ConnectorID












This feature is available to xConnectoAdvanced plan

Feel free to contact us if you need any further information:


Chat: click on the blue chat icon (bottom-right)

E-mail: support@xconnector.app

Phone: +4 0373 747 991










Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article