Unwan – Address Library for WooCommerce

Description

Full documentation → — setup, every setting explained, theming, and the complete developer hooks reference.

Most WooCommerce stores make customers manage two separate address lists — a billing address and a shipping address — and re-enter the same details every time they order. Unwan replaces that with one address book: every saved address is simply available everywhere, at checkout and in My Account, with no duplication and no confusion about which list a customer is editing.

Unwan ships this feature set complete, with no artificial limits, no “Pro” upsell, and no locked settings.

The full source, including the unminified JavaScript behind every compiled build/ file, is maintained publicly on GitHub at Smart-WP-Plugins/unwan-address-library-for-woocommerce — that’s also where to file a bug report or feature request as an issue.

One address book. Not two.

Instead of a billing list and a separate shipping list, Unwan keeps a single, deduplicated library per customer:

• The WooCommerce billing default, shipping default, and every additional saved address all live in one list.
• An address can be flagged as the billing default, the shipping default, both, or neither — there’s no second copy to keep in sync.
• Reassigning a default is lossless: the address that gets replaced simply drops back into the shared library instead of disappearing.
• Duplicate addresses are detected automatically and merged, so customers never end up with the same address saved three times under three different labels.

Fewer lists to think through means fewer decisions at checkout — which is exactly where every extra click costs you conversions.

Built natively for the block-based checkout

Unwan is built for the block-based checkout from the ground up: the billing and shipping selectors are registered as genuine, forced inner blocks of WooCommerce’s own Checkout Blocks, using the official Blocks integration registry and Store API — the same extension points WooCommerce itself recommends. Classic (shortcode) checkout gets the identical picker, behavior, and labels, so stores that haven’t migrated yet lose nothing.

A genuinely well-designed picker, not a repurposed dropdown

The address picker is a real interface, not a <select> element with a new coat of paint:

• A collapsed summary with a one-tap “Change” action, so returning customers see their address and move on.
• An accessible radio-group list with full keyboard support (arrow keys, Home, End) for choosing between saved addresses.
• Instant search that appears automatically once a customer has enough saved addresses to need it — configurable, and identical at checkout and in My Account.
• A three-dot action menu in My Account for edit, delete, and “make default,” with protected actions clearly disabled instead of hidden.
• Zero layout shift, zero custom elements, zero Shadow DOM — just clean, inspectable, standard-DOM HTML that any theme developer can read and override.

Light, dark, and system themes — with your brand’s accent color

Unwan gives you light, dark, and system (“follow the customer’s device”) theme modes plus a full accent color: pick one, and every button, focus ring, badge, and selected state throughout the picker and My Account updates to match — no custom CSS required. Developers get a small, documented set of --unwan-* CSS variables and stable BEM classes if they want to go further.

Fast, because it isn’t doing anything it doesn’t need to

Unwan adds no custom database tables. It stores additional addresses in a single namespaced user-meta record and reads WooCommerce’s own billing/shipping fields for the two profile defaults — nothing new for your host to back up or your site to slow down. Scripts and styles load only on the checkout and My Account pages, address-book results are cached for the duration of the request, and there is no telemetry, tracking, or external service call of any kind — not even a “phone home” for update checks beyond the standard WordPress.org channel.

Under the hood, Unwan is written with PSR-4 autoloading and namespaced classes (Unwan\AddressLibrary), and every PHP file is checked against the WordPress Coding Standards ruleset before release. That’s not something most customers will ever see directly — but it’s why the plugin stays fast, why it doesn’t conflict with other well-built plugins, and why it’s safe to build on.

Every part of it is configurable

Nothing here is hard-coded. From WooCommerce → Settings → Accounts & Privacy → Unwan you control:

• Whether the billing and/or shipping selector appears at checkout at all.
• The maximum number of additional addresses a customer may save (or unlimited).
• The address count at which the search field appears, at checkout and in My Account.
• Whether addresses entered at checkout are saved automatically, and whether a new address should become the matching profile default.
• Light, dark, or system color mode, plus a single accent color that reflows through the entire interface.
• Every customer-facing label and heading — page titles, button text, empty-state copy, picker headings — all editable, with translations still able to override your text.
• Whether uninstalling the plugin removes Unwan’s data, or leaves it in place (off by default).

Features at a glance

• One combined address book: WooCommerce billing default, shipping default, and unlimited shared additional addresses.
• Every saved address is available in both the billing and shipping checkout selectors.
• Native Checkout Blocks integration via WooCommerce’s Blocks registry and Store API, plus a matching classic-checkout experience.
• Add, edit, delete, and “make default” actions in My Account — nonce-protected, validated, and sanitized end to end.
• Lossless default-address swaps: reassigning a default never deletes the address it replaces.
• Automatic duplicate detection and merging for newly entered checkout addresses.
• Configurable saved-address limit and a shared checkout/My Account search threshold.
• Light, dark, and system color modes with a configurable accent color.
• A concise --unwan-* CSS variable API and stable BEM classes for theme developers.
• Fully keyboard-accessible picker (arrow keys, Home, End, proper role="radio" semantics).
• HPOS and Cart & Checkout Blocks compatibility declared and tested.
• Developer hooks for every filterable behavior — see the plugin’s inline documentation.
• Optional, opt-in complete data cleanup on uninstall.
• No custom database tables, no tracking, no telemetry, no upsell nags.

Unwan is developed and maintained by SmartWP Plugins.

More from SmartWP Plugins

WP CodeKit — Every WordPress generator. One place. Zero guesswork. A growing library of WordPress code generators — CSS, PHP, hooks, and more — each with a live preview, so you see exactly what you’re shipping before you copy a single line.

CSS Gradient Generator — The gradient tool that shows its work: build multi-stop, multi-angle CSS gradients visually and grab production-ready code, no manual color-stop math.

GrowQuest — Custom WordPress development, for when off-the-shelf isn’t enough. Our development studio for custom WordPress and WooCommerce builds — plugins, themes, and full-site work — for stores and businesses that have outgrown generic solutions.