> ## Documentation Index
> Fetch the complete documentation index at: https://docs.smartwpplugins.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> What Unwan is, the problem it solves, and how it fits into WooCommerce

Unwan gives WooCommerce customers **one address book** instead of the usual pair of disconnected billing and shipping lists. Every saved address lives in a single, deduplicated library per customer, and that same library is what powers both checkout selectors and the My Account address page.

## The problem

Out of the box, WooCommerce treats billing and shipping as two separate profile fields. Most "address book" plugins layer a second set of lists on top of that split instead of removing it — customers still have to think about which list they're editing, and stores end up maintaining two copies of data that's often identical.

Every extra decision at checkout is a place a customer can hesitate, or leave. A shorter path from cart to confirmed order is a conversion feature, not just a convenience one.

## The Unwan model

Unwan keeps one list per customer. An address in that list can be flagged as the **billing default**, the **shipping default**, **both**, or **neither** (a plain additional address). There is no second copy to keep in sync, no separate "shipping addresses" screen, and no ambiguity about where an address lives.

> [card] One library, every context
>
> The same address book powers the billing selector, the shipping selector, and the My Account address page. Add an address once, use it everywhere.

> [card] Native Checkout Blocks support
>
> Billing and shipping selectors are registered as real inner blocks of WooCommerce's Checkout Blocks, through the official Blocks integration registry and Store API — not a shortcode retrofit.

> [card] Light, dark, and system themes
>
> A configurable color mode and a single accent color restyle the entire picker and My Account interface — no custom CSS required.

> [card] Everything included, free
>
> Unlimited saved addresses, both checkout adapters, full theming, and every developer hook ship in the free plugin. Nothing is held back for a paid tier.

## Where Unwan shows up

**1. My Account → Address book**

Signed-in customers get a dedicated **Address book** endpoint (replacing WooCommerce's plain "Addresses" tab) with two default-address summary cards and one combined list of every saved address.

**2. Checkout — Blocks or Classic**

When a customer has saved addresses, a picker appears above the native billing and/or shipping fields, showing a collapsed summary with a **Change** action, or the full list when expanded.

**3. WooCommerce → Orders**

When staff create or edit an order, a **Saved addresses** dropdown fills the order's billing or shipping address from the chosen customer's address book, without saving anything back to it. See [Admin Orders](https://docs.smartwpplugins.com/unwan/admin-orders.md).

**4. WooCommerce → Settings → Accounts & Privacy → Unwan**

Store owners control which selectors are enabled, saved-address limits, checkout-saving behavior, appearance, and every customer-facing label from one settings screen.

## What's next

> [card] [Installation](https://docs.smartwpplugins.com/unwan/installation.md)
>
> Requirements and setup steps.

> [card] [Quickstart](https://docs.smartwpplugins.com/unwan/quickstart.md)
>
> Get a working checkout picker in about five minutes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.