Settings Reference

All Unwan settings live in one place: WooCommerce → Settings → Accounts & Privacy → Unwan. They use WooCommerce’s own settings save pipeline — there’s no separate Unwan admin page, no extra database table, and no additional admin-side request.

Every setting on this page is also filterable from code — see the Hooks Reference if you need to set a value programmatically or per-customer.

Address book

Setting	Option key	Default	Effect
Billing checkout selector	`unwan_billing_enable`	On	Lets customers choose any address-book entry for billing at checkout
Shipping checkout selector	`unwan_shipping_enable`	On	Lets customers choose any address-book entry for shipping at checkout
Admin order dropdown	`unwan_admin_order_addresses`	On	Lets staff fill an order’s billing or shipping address from the customer’s saved addresses on the admin order screen. Independent of the two checkout selectors. See Admin Orders
Additional address limit	`unwan_address_save_limit`	`0` (unlimited)	Maximum additional addresses per customer. Billing and shipping defaults don’t count against this — and a displaced default from a role swap always bypasses it, see Default Swaps
Address search threshold	`unwan_address_search_threshold`	`4`	Saved-address count above which the search field appears, in both checkout and My Account. `0` always shows it
Save checkout addresses	`unwan_save_checkout_addresses`	On	Whether a new, validated address entered at checkout is added to the customer’s address book
New address defaults	`unwan_checkout_default_behavior`	Preserve	`preserve` keeps existing profile defaults untouched; `update` makes a newly saved checkout address the matching billing/shipping default. Has no effect when Save checkout addresses is off

Appearance

Setting	Option key	Default	Effect
Color mode	`unwan_color_scheme`	Light	`light`, `dark`, or “follow the customer’s device” (`system`)
Accent color	`unwan_accent_color`	`#6b3fa0`	A six-digit hex color driving every accent surface across the picker and My Account

See Appearance & Theming for how these actually apply.

Text and labels

Every customer-facing string — page titles, button text, empty-state copy, picker headings — is editable from this section. Each field starts empty and shows its default text as a placeholder. Leave a field empty and customers see the default, translated into their language; type your own text and it’s shown exactly as typed. See Appearance & Theming for the full list of editable keys and their defaults.

Data removal

Setting	Option key	Default	Effect
Uninstall cleanup	`unwan_remove_data_on_uninstall`	Off	When enabled, deleting the plugin permanently removes all Unwan settings and additional customer addresses. WooCommerce’s own billing and shipping profile fields are never removed, regardless of this setting

Uninstall cleanup is destructive and cannot be undone once the plugin is deleted. Leave it off unless you specifically want a clean slate.

On multisite, settings are removed site by site. Customers’ saved addresses are shared by the whole network, so they’re removed only when every site that uses Unwan has turned Uninstall cleanup on.

Checkout

Concepts

Customization

Developers

Address book

Appearance

Text and labels

Data removal

​Address book

​Appearance

​Text and labels

​Data removal

Address book

Appearance

Text and labels

Data removal