Skip to main content
This walks through the fastest path to seeing Unwan working end to end: one saved address, one checkout, one styled picker.
1

Confirm the selectors are enabled

Go to WooCommerce → Settings → Accounts & Privacy → Unwan. Under Address book, both Billing checkout selector and Shipping checkout selector are enabled by default — leave them on, or turn off whichever one your store doesn’t need.
2

Create a test customer address

Sign in as (or create) a customer account, visit My Account → Address book, and click Add new address. Fill in a complete address — Unwan requires at least a street address, city, or postcode to consider an entry valid — and save it without checking either default-role box, so it becomes a plain additional address.
3

Set a billing or shipping default (optional)

From the address list, open the row’s action menu and choose Make default billing or Make default shipping. This is optional — the checkout picker also shows addresses that hold no default role.
4

Visit checkout

As the same customer, add a product to the cart and go to checkout (classic or block-based — both work identically). You should see a picker above the billing fields (and shipping fields, if shipping is needed) showing the saved address as a collapsed summary with a Change action.
5

Pick your color mode and accent

Back in Accounts & Privacy → Unwan, set Color mode to Light, Dark, or “Follow the customer’s device,” and pick an Accent color. Reload checkout or My Account to see the whole interface restyle instantly — no CSS needed.
If the picker doesn’t appear, the most common cause is that the signed-in customer has no saved address yet — Unwan deliberately stays invisible until there’s something to pick from. See Checkout Integration for the full rendering rules.

Where to go next

The address book model

Understand roles, defaults, and how the unified library actually works.

Configuration

Every setting, what it controls, and its default.

Appearance & theming

Light, dark, system mode, and the accent color system.

Hooks reference

Every filter and action Unwan exposes.