OneStudio Vietnam Address for WooCommerce

Integrates the latest Vietnamese administrative addresses into WooCommerce. Supports converting old addresses to new addresses.

10+ active installs

5.0

(1 ratings)

Free on WordPress.org

View on WordPress.org Support forum

Will this break my store?

What the WordPress.org registry says about keeping OneStudio Vietnam Address for WooCommerce running.

WordPress compatibility

Tested to 7.1

Tested against the WordPress branch in use today.

Last updated

16 days ago

Requires PHP

7.4

Your host must be running at least this version.

Requires WordPress

5.8

Requires other plugins

woocommerce

These must be installed and active first.

Contributors

1

A single maintainer. Worth knowing if the plugin is load-bearing for your store.

10+ active installsWordPress.org reports installs in bands, not exact counts.

Maintenance & trust

Scored on how OneStudio Vietnam Address for WooCommerce is looked after — not on how many stores run it.

Well maintained

Not enough public feedback to put a confident number on this one. Little public feedback — score rests mostly on release activity. What we can see is below.

Maintenance

35 / 35

Updated 2 days ago.

WordPress compatibility

20 / 20

Tested to WP 7.1 (current).

Support responsiveness

Not enough data

Only 0 support thread(s) — not enough to judge.

Merchant satisfaction

10 / 15

5.0/5 across 1 rating(s).

Listing transparency

10 / 10

Provides: screenshots, description, homepage

1 of 5 measures had too little evidence to score. They are left out of the total rather than counted as zero — otherwise a plugin would be marked down for being small rather than for being poorly kept.Measured 2026-09-09 from the WordPress.org plugin registry.

Ratings

5.0

1 rating

5★1

4★0

3★0

2★0

1★0

Every rating WordPress.org holds for this plugin, not a sample. Written reviews live in the plugin's WordPress.org reviews forum.

OneStudio Vietnam Address for WooCommerce integrates the Vietnamese administrative address system into the WooCommerce checkout form. All Province/City, District, and Ward data is bundled with the plugin – no API key required, no dependency on an external service, no risk of interruption.

This is an independent plugin, not affiliated with, endorsed by, or sponsored by WooCommerce or Automattic. WooCommerce is a trademark of Automattic Inc.

Key features

Vietnamese address integration: Replaces or extends WooCommerce’s default address fields with the Province/City – District – Ward system
Supports both structures:
- Old structure (before 1 July 2025): 63 provinces with 3 levels (Province – District – Ward)
- New structure (after 1 July 2025): 34 provinces with 2 levels (Province – Ward)
Both Classic Checkout and Block Checkout supported: see “Block Checkout support” below
Searchable dropdowns: Province/City, District, and Ward fields are searchable (type to filter) on Classic Checkout, using the Select2 library already bundled with WooCommerce – toggleable in settings if it ever conflicts with a theme
Bundled data: The full list of Provinces/Cities, Districts, and Wards (both structures) ships inside the plugin – works immediately after installation, no external API calls, no internet connection or API key required
Central data server: Defaults to https://api.onestudio.vn to receive administrative changes as soon as they’re published, without needing a plugin update. Can be pointed at a self-hosted server instead, or left blank to use only the bundled data – however it’s configured, the plugin always automatically falls back to the bundled data if the server is unreachable, so checkout is never interrupted
Automatic conversion: Converts existing orders from the old address structure to the new one, using a bundled conversion table
Friendly interface: A complete, easy-to-use settings page inside WooCommerce Admin
Admin display: View detailed address information on the order edit screen

Requirements

WordPress 5.8 or later
WooCommerce 5.0 or later
PHP 7.4 or later

Block Checkout support

The plugin supports both Classic Checkout (shortcode) and Block Checkout (the default for new stores since WooCommerce 8.3+):

Classic Checkout: full support for both address structures (new: Province/City → Ward, and old: Province/City → District → Ward).
Block Checkout: new structure only (Province/City → Ward) with a real-time ward-search autocomplete field. Requires WooCommerce 8.9 or later. The old structure (with District) is currently only available on Classic Checkout.

If your WooCommerce version is older than 8.9 and you’re using Block Checkout, the plugin shows a notice in the admin area, and you can enable “Cart and checkout shortcodes” under WooCommerce > Settings > Advanced > Features to switch to Classic Checkout.

Languages

Vietnamese and English are supported out of the box. When your site language is set to Tiếng Việt, WordPress installs and updates the Vietnamese translation automatically, with nothing to configure. Translations into other languages are welcome at https://translate.wordpress.org/projects/wp-plugins/onestudio-vietnam-address-for-woocommerce/

Usage

Install and activate the plugin
Go to WooCommerce > Vietnam Address
Choose the default address structure (new or old)
To convert existing orders, scroll to the “Old-to-new address conversion tool” section and click “Convert Now”

External services

This plugin can optionally connect to a central data server, https://api.onestudio.vn, operated by the plugin author (OneStudio, https://onestudio.vn), to fetch up-to-date Vietnamese administrative address data (provinces, wards, and old-to-new mapping tables) without requiring a plugin update whenever administrative boundaries change (renames, mergers, new codes).

What is sent: only administrative lookup codes (e.g. a province or ward code) as GET request query parameters. No personal data, customer information, or order data is ever sent to this service.

When it is used: when a customer loads the checkout page (to look up province/ward lists for the address autocomplete), when a site administrator clicks “Test Connection” on the plugin’s settings page, and via a background cache-warming job that runs shortly after the API Server setting is saved (never automatically on plugin activation).

This connection is entirely optional. Leaving the “API Server” field blank, or if the server is temporarily unreachable, the plugin automatically and transparently falls back to the Vietnamese administrative address data bundled inside the plugin itself – checkout is never interrupted by this.

Site owners who prefer not to connect to this service at all may run their own copy instead: the server is open source at https://github.com/onestudiovn/onestudio-vietnam-address-api-server.

Support

If you need support, please visit https://onestudio.vn

Credits

Developed by OneStudio (https://onestudio.vn)
Vietnamese administrative address data provided by VietMap (https://github.com/vietmap-company/vietnam_administrative_address), used under the VietMap Administrative Data License
Built for WooCommerce

Does the plugin require an API key or an external account?

No. All Province/District/Ward data is bundled with the plugin and works immediately after installation, with no registration or connection to an external service required.

Can I use both address structures at the same time?

No, you can only choose one of the two structures (old or new) at a time.

How does old-to-new address conversion work? Is it reliable?

When you click “Convert Now” in the Old-to-new address conversion tool section of the settings page, the plugin looks up each order against a bundled old-to-new mapping table (built from administrative mapping data officially published by VietMap, not a live API). The lookup happens entirely locally on your own server – no network requests are made during conversion, even if you have an API Server configured, so the speed and reliability of conversion never depend on any external service.

About 97% of old wards convert automatically with an exact 1-to-1 match. A small number (~3%) were split into multiple new wards after the administrative merger; those cases are flagged as “needs manual review” instead of being guessed, so you can confirm the correct address yourself for those orders. The original address the customer entered is never overwritten or deleted – the converted result is saved to separate fields, entirely apart from the original data, so it can always be cross-checked if needed.

Is the plugin compatible with my theme?

The plugin is designed to be compatible with most WooCommerce themes. If you run into a display issue, please reach out via support.

What is the “API Server” field on the settings page?

This is where continuously-updated Vietnamese administrative address data is served from, defaulting to https://api.onestudio.vn. We recommend keeping this default so you receive administrative changes (renamings, province/ward mergers, etc.) as soon as they’re published, without needing to update the plugin. Administrative data comes from VietMap (https://github.com/vietmap-company/vietnam_administrative_address).

This isn’t a requirement: leaving this field blank, the plugin still works fully using the data bundled with the plugin, and if the server is unreachable for any reason, the plugin automatically falls back to the bundled data immediately – checkout is never interrupted because of this. If you’d rather be fully self-sufficient, you can self-host your own server based on the open-source code at https://github.com/onestudiovn/onestudio-vietnam-address-api-server and point the plugin at it.

Plugin details

Version1.1.6

Last updated2026-09-07 4:59am GMT

Added2026-08-23

Requires WordPress5.8

Tested up to7.1

Requires PHP7.4

Tags on WordPress.org

address

checkout

provinces

vietnam

woocommerce

Alternatives

Other plugins in the same categories.

Checkout Field Editor (Checkout Manager) for WooCommerce

400K+ installs

4.9(1,056)

Price Based on Country for WooCommerce

20K+ installs

4.8(262)

Calculadora de Frete e Campos Checkout para o Brasil

5K+ installs

4.9(45)

Admin Columns

100K+ installs

4.9(1,651)

Kikote – Location Picker at Checkout & Google Address AutoFill Plugin for WooCommerce

1K+ installs

5.0(65)

Custom Post Type WooCommerce Integration – Sell Any CPT with WooCommerce

400+ installs

5.0(17)

OneStudio Vietnam Address for WooCommerce

Integrates the latest Vietnamese administrative addresses into WooCommerce. Supports converting old addresses to new addresses.

10+ active installs

5.0

(1 ratings)

Free on WordPress.org

View on WordPress.org Support forum

Will this break my store?

What the WordPress.org registry says about keeping OneStudio Vietnam Address for WooCommerce running.

WordPress compatibility

Tested to 7.1

Tested against the WordPress branch in use today.

Last updated

16 days ago

Requires PHP

7.4

Your host must be running at least this version.

Requires WordPress

5.8

Requires other plugins

woocommerce

These must be installed and active first.

Contributors

1

A single maintainer. Worth knowing if the plugin is load-bearing for your store.

10+ active installsWordPress.org reports installs in bands, not exact counts.

Maintenance & trust

Scored on how OneStudio Vietnam Address for WooCommerce is looked after — not on how many stores run it.

Well maintained

Not enough public feedback to put a confident number on this one. Little public feedback — score rests mostly on release activity. What we can see is below.

Maintenance

35 / 35

Updated 2 days ago.

WordPress compatibility

20 / 20

Tested to WP 7.1 (current).

Support responsiveness

Not enough data

Only 0 support thread(s) — not enough to judge.

Merchant satisfaction

10 / 15

5.0/5 across 1 rating(s).

Listing transparency

10 / 10

Provides: screenshots, description, homepage

Ratings

5.0

1 rating

5★1

4★0

3★0

2★0

1★0

Every rating WordPress.org holds for this plugin, not a sample. Written reviews live in the plugin's WordPress.org reviews forum.

This is an independent plugin, not affiliated with, endorsed by, or sponsored by WooCommerce or Automattic. WooCommerce is a trademark of Automattic Inc.