Get started with Vietnam Address Assistant

Since 1 July 2025, Vietnam uses a two-tier administrative model with 34 provinces and 3,321 wards. Many customers still enter addresses in the old format at checkout. Vietnam Address Assistant matches each order to the new province and ward, and asks the customer to confirm it on the Thank you page.

How it works

1. The customer places an order. The app matches the checkout address to the new province and ward.
2. The customer confirms. On the Thank you page, the customer checks the ward, chooses another one if needed, and enters the house number and street.
3. The order is updated. The confirmed address is added to the order as additional details. See Read the confirmed address on orders.

Set it up

Customers see nothing until you add the block to the Thank you page.

1. Open Vietnam Address Assistant and click Open Checkout Editor. You can also go to Settings > Checkout in your Shopify admin and click Customize.
2. In the page selector at the top of the editor, choose Thank you.
3. Click Add block and select Vietnam Address Assistant under Apps.
4. Place it near the top of the page so customers see it right away.
5. Click Save.

A setup video is linked from Setup video in the app.

Change the block's text

Select the block in the checkout editor. You can set a title and a description in Vietnamese and in English. Leave a field blank to use the default text. The block follows the customer's checkout language.

When the block shows

The block shows on the Thank you page when the order:

• ships to Vietnam, and
• has a shipping address, so it is not a local pickup order.

In the checkout editor, the block always shows so you can position it.

Good to know

• The Shopify shipping address is not changed. The app adds the confirmed address next to it.
• Nothing changes until the customer confirms. If the customer does not click Confirm, the order is not updated.
• Customer addresses are not stored by the app. They are written only to the order in your store.
• Orders older than 30 days cannot be confirmed.

Need help?

Wrong ward, or the block is not showing? Open a ticket at support.lisive.com with the order number and a screenshot. We reply within 8 hours.