Yes. Unlimited saved addresses, both checkout adapters, full light/dark/system theming, custom accent color, editable labels, and every developer hook are all included in the free plugin — there’s no “Pro” version withholding functionality.
Does Unwan support WooCommerce Checkout Blocks?
Yes, natively — see Checkout Blocks. The billing and shipping selectors are registered as forced inner blocks through WooCommerce’s own Blocks integration registry and Store API, not injected after the fact.
Will this slow down my store?
Unwan creates no custom database tables, runs no extra queries beyond what WooCommerce already performs for customer data, caches its results for the duration of each request, and only loads its scripts and styles on checkout and My Account pages. There’s no tracking or external service call of any kind. See Architecture.
Does selecting a saved address at checkout replace the customer's account default?
Not by default. A saved address is used for the current order without silently replacing the WooCommerce default. Store owners can opt into promoting a new checkout address to the matching default under New address defaults. See Checkout Overview.
Are newly entered checkout addresses saved automatically?
Yes, by default (Save checkout addresses). An address matching an existing entry’s normalized first name, last name, first address line, and postcode is reused instead of duplicated — see Default Swaps & Duplicate Detection.
What happens to the previous default address when a new one takes over?
It stays in the address book, demoted to a plain additional address — unless it still holds the other default role, in which case nothing changes for it. Reassigning a default never deletes the address it replaces. See Default Swaps & Duplicate Detection.
What happens to data when Unwan is uninstalled?
Data is retained by default. Enabling Uninstall cleanup first will permanently remove Unwan’s settings and additional customer addresses on uninstall — WooCommerce’s own billing/shipping profile fields are never touched, regardless of this setting. On multisite, saved addresses are shared by the whole network, so they’re removed only when every site that uses Unwan has cleanup turned on.
What languages is Unwan available in?
Unwan ships with translations for ten languages: Spanish, French, German, Italian, Portuguese (Brazil), Dutch, Polish, Russian, Swedish, and Japanese. They cover both the customer-facing screens and the settings page, and apply automatically once WordPress is running in that language — nothing to install or configure.Labels left empty under Text and labels show their default text in each customer’s language. A label you customize is shown exactly as you typed it; on a multilingual site, WPML and Polylang can translate it. If a community translation for your locale is published on translate.wordpress.org, WordPress uses that in preference to the bundled copy.
Can staff use saved addresses when creating orders?
Yes. On the admin order screen, choose a customer and a “Saved addresses” dropdown appears above the billing and shipping fields. Picking an address fills that part of the order, and staff can still edit it. Nothing is added to the customer’s address book and their default addresses don’t change. See Admin Orders.
Does Unwan save custom checkout fields?
Unwan is designed to manage the standard WooCommerce address: name, company, address lines, city, state, postcode, country, and phone. Fields that checkout field editors add to the billing or shipping address stay with your field editor rather than in the address book. At checkout they appear and work as usual, and Unwan never hides, clears or changes them. See Custom checkout fields.
Are saved addresses included in personal data exports?
Yes. WordPress’s Export Personal Data and Erase Personal Data tools include the customer’s additional saved addresses, listed as “Address book”. The billing and shipping defaults are covered by WooCommerce’s own exporter and eraser.
Is Unwan built to WordPress coding standards?
Yes — PSR-4 autoloading with namespaced classes, and every release is checked against the WordPress Coding Standards PHPCS ruleset (WordPress-Extra plus PHPCompatibilityWP) before publishing. See Architecture.
Check, in order: the customer is signed in (Unwan never offers saved addresses to guests); the relevant selector (billing/shipping) is enabled in Accounts & Privacy → Unwan; and the customer actually has at least one address in their book (a billing or shipping profile default counts). The picker deliberately stays invisible rather than rendering an empty state when there’s nothing to pick from.
The address book endpoint doesn't appear in My Account
This usually means permalinks need refreshing. Unwan refreshes them automatically on activation and again the first time each site loads a new version, including every site of a multisite network. If the page still shows “Page not found” (for example after a staging sync that copied the database but not the rewrite rules), visit Settings → Permalinks and click Save Changes once to force a refresh.
A theme or plugin's CSS is bleeding into the picker
This should be rare given Unwan’s ID-rooted CSS reset, but if you hit a specific conflict, load your override CSS after assets/css/unwan.css and target the stable root ID (#unwan-account-list, #unwan-billing-picker, #unwan-shipping-picker) plus the relevant BEM class — that combination has enough specificity to win without !important.
Saving an address fails with 'That address is already in your address book'
This is expected behavior, not a bug: the entry you’re editing would normalize to the same first name, last name, street line, and postcode as a different existing entry. Edit or delete the other entry first if you actually want to merge them. See Default Swaps & Duplicate Detection.
A row's 'Delete' or 'Make default' action is disabled
Both are intentional guardrails, enforced server-side, not just visually: an address currently holding a default role can’t be deleted until it’s reassigned, and an address already holding a role can’t be “made default” for that same role again. Hovering the disabled action shows why.
Settings aren't saving
Unwan settings use WooCommerce’s own settings save pipeline (WooCommerce → Settings → Accounts & Privacy → Unwan) — if changes there aren’t persisting, it’s almost always a WooCommerce-level issue (a conflicting plugin filtering woocommerce_get_settings_account, or a permissions problem), not something Unwan-specific.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SmartWP Plugins Documentation","colors":{"primary":"#5B3FE0","light":"#9D8CFF","dark":"#5B3FE0"},"logo":{"light":"https://mintcdn.com/growquest-technologies/9Hk7Fwl6-q3LJS13/images/LOGO_COLOR.svg?fit=max\u0026auto=format\u0026n=9Hk7Fwl6-q3LJS13\u0026q=85\u0026s=a43b0038924202eea5648ded3320a2f4","dark":"https://mintcdn.com/growquest-technologies/9Hk7Fwl6-q3LJS13/images/LOGO_WHITE.svg?fit=max\u0026auto=format\u0026n=9Hk7Fwl6-q3LJS13\u0026q=85\u0026s=ead0c1fd3af8a736d3d338c06525bd7e"},"favicon":{"light":"https://mintcdn.com/growquest-technologies/9Hk7Fwl6-q3LJS13/images/FAVICON_COLOR.svg?fit=max\u0026auto=format\u0026n=9Hk7Fwl6-q3LJS13\u0026q=85\u0026s=98fa9c4e58c38198cf89896eedf8d32f","dark":"https://mintcdn.com/growquest-technologies/9Hk7Fwl6-q3LJS13/images/FAVICON_WHITE.svg?fit=max\u0026auto=format\u0026n=9Hk7Fwl6-q3LJS13\u0026q=85\u0026s=ab265af6d2219eb743eef13273793b80"},"appearance":{"default":"dark"},"navbar":{"primary":{"type":"button","label":"Support","href":"http://smartwpplugins.com/support"}},"footer":{"socials":{"github":"https://github.com/Smart-WP-Plugins"}},"icons":{"library":"fontawesome"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"fonts":{"family":"Geist"}},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"growquest-technologies","hasAudioNarration":false,"actualSubdomain":"growquest-technologies","customDomains":["docs.smartwpplugins.com"],"gitSource":{"type":"github","owner":"smart-wp-plugins","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6aec81868c2847cc731f8706","collectionId":"9d19a82f-2158-47d7-a2bb-770e9e8f7ca0","liveDeploymentHistoryId":"6aec81868c2847cc731f8706","schemaVersion":"v3"},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aec81868c2847cc731f8706","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"Admin Powerups for WooCommerce","count":35},{"language":"default","tag":"CartPresets for WooCommerce","count":30},{"language":"default","tag":"Unwan","count":18},{"language":"default","tag":"Building presets","count":8},{"language":"default","tag":"Developers","count":8},{"language":"default","tag":"Customers","count":6},{"language":"default","tag":"Orders","count":6},{"language":"default","tag":"Store operations","count":6},{"language":"default","tag":"Developer","count":6},{"language":"default","tag":"Links and the cart","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"unwan/faq","slug":"/unwan/faq","pageMetadata":{"title":"FAQ \u0026 Troubleshooting","description":"Common questions and how to diagnose the usual issues","icon":"circle-question","href":"/unwan/faq"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Common questions and how to diagnose the usual issues\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Heading}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`general`,children:`General`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Is Unwan really free, with no premium tier?`,id:`is-unwan-really-free-with-no-premium-tier`,children:_jsx(_components.p,{children:`Yes. Unlimited saved addresses, both checkout adapters, full light/dark/system theming, custom accent color, editable labels, and every developer hook are all included in the free plugin — there’s no “Pro” version withholding functionality.`})}),_jsx(Accordion,{title:`Does Unwan support WooCommerce Checkout Blocks?`,id:`does-unwan-support-woocommerce-checkout-blocks`,children:_jsxs(_components.p,{children:[`Yes, natively — see `,_jsx(_components.a,{href:`/unwan/checkout/checkout-blocks`,children:`Checkout Blocks`}),`. The billing and shipping selectors are registered as forced inner blocks through WooCommerce’s own Blocks integration registry and Store API, not injected after the fact.`]})}),_jsx(Accordion,{title:`Will this slow down my store?`,id:`will-this-slow-down-my-store`,children:_jsxs(_components.p,{children:[`Unwan creates no custom database tables, runs no extra queries beyond what WooCommerce already performs for customer data, caches its results for the duration of each request, and only loads its scripts and styles on checkout and My Account pages. There’s no tracking or external service call of any kind. See `,_jsx(_components.a,{href:`/unwan/developers/architecture`,children:`Architecture`}),`.`]})}),_jsx(Accordion,{title:`Does selecting a saved address at checkout replace the customer's account default?`,id:`does-selecting-a-saved-address-at-checkout-replace-the-customers-account-default`,children:_jsxs(_components.p,{children:[`Not by default. A saved address is used for the current order without silently replacing the WooCommerce default. Store owners can opt into promoting a new checkout address to the matching default under `,_jsx(_components.strong,{children:`New address defaults`}),`. See `,_jsx(_components.a,{href:`/unwan/checkout/checkout-overview`,children:`Checkout Overview`}),`.`]})}),_jsx(Accordion,{title:`Are newly entered checkout addresses saved automatically?`,id:`are-newly-entered-checkout-addresses-saved-automatically`,children:_jsxs(_components.p,{children:[`Yes, by default (`,_jsx(_components.strong,{children:`Save checkout addresses`}),`). An address matching an existing entry’s normalized first name, last name, first address line, and postcode is reused instead of duplicated — see `,_jsx(_components.a,{href:`/unwan/concepts/default-swaps-and-duplicates`,children:`Default Swaps \u0026 Duplicate Detection`}),`.`]})}),_jsx(Accordion,{title:`What happens to the previous default address when a new one takes over?`,id:`what-happens-to-the-previous-default-address-when-a-new-one-takes-over`,children:_jsxs(_components.p,{children:[`It stays in the address book, demoted to a plain additional address — unless it still holds the `,_jsx(_components.em,{children:`other`}),` default role, in which case nothing changes for it. Reassigning a default never deletes the address it replaces. See `,_jsx(_components.a,{href:`/unwan/concepts/default-swaps-and-duplicates`,children:`Default Swaps \u0026 Duplicate Detection`}),`.`]})}),_jsx(Accordion,{title:`What happens to data when Unwan is uninstalled?`,id:`what-happens-to-data-when-unwan-is-uninstalled`,children:_jsxs(_components.p,{children:[`Data is retained by default. Enabling `,_jsx(_components.strong,{children:`Uninstall cleanup`}),` first will permanently remove Unwan’s settings and additional customer addresses on uninstall — WooCommerce’s own billing/shipping profile fields are never touched, regardless of this setting. On multisite, saved addresses are shared by the whole network, so they’re removed only when every site that uses Unwan has cleanup turned on.`]})}),_jsxs(Accordion,{title:`What languages is Unwan available in?`,id:`what-languages-is-unwan-available-in`,children:[_jsx(_components.p,{children:`Unwan ships with translations for ten languages: Spanish, French, German, Italian, Portuguese (Brazil), Dutch, Polish, Russian, Swedish, and Japanese. They cover both the customer-facing screens and the settings page, and apply automatically once WordPress is running in that language — nothing to install or configure.`}),_jsxs(_components.p,{children:[`Labels left empty under `,_jsx(_components.strong,{children:`Text and labels`}),` show their default text in each customer’s language. A label you customize is shown exactly as you typed it; on a multilingual site, WPML and Polylang can translate it. If a community translation for your locale is published on translate.wordpress.org, WordPress uses that in preference to the bundled copy.`]})]}),_jsx(Accordion,{title:`Can staff use saved addresses when creating orders?`,id:`can-staff-use-saved-addresses-when-creating-orders`,children:_jsxs(_components.p,{children:[`Yes. On the admin order screen, choose a customer and a “Saved addresses” dropdown appears above the billing and shipping fields. Picking an address fills that part of the order, and staff can still edit it. Nothing is added to the customer’s address book and their default addresses don’t change. See `,_jsx(_components.a,{href:`/unwan/admin-orders`,children:`Admin Orders`}),`.`]})}),_jsx(Accordion,{title:`Does Unwan save custom checkout fields?`,id:`does-unwan-save-custom-checkout-fields`,children:_jsxs(_components.p,{children:[`Unwan is designed to manage the standard WooCommerce address: name, company, address lines, city, state, postcode, country, and phone. Fields that checkout field editors add to the billing or shipping address stay with your field editor rather than in the address book. At checkout they appear and work as usual, and Unwan never hides, clears or changes them. See `,_jsx(_components.a,{href:`/unwan/checkout/checkout-overview#custom-checkout-fields`,children:`Custom checkout fields`}),`.`]})}),_jsx(Accordion,{title:`Are saved addresses included in personal data exports?`,id:`are-saved-addresses-included-in-personal-data-exports`,children:_jsxs(_components.p,{children:[`Yes. WordPress’s `,_jsx(_components.strong,{children:`Export Personal Data`}),` and `,_jsx(_components.strong,{children:`Erase Personal Data`}),` tools include the customer’s additional saved addresses, listed as “Address book”. The billing and shipping defaults are covered by WooCommerce’s own exporter and eraser.`]})}),_jsx(Accordion,{title:`Is Unwan built to WordPress coding standards?`,id:`is-unwan-built-to-wordpress-coding-standards`,children:_jsxs(_components.p,{children:[`Yes — PSR-4 autoloading with namespaced classes, and every release is checked against the WordPress Coding Standards PHPCS ruleset (`,_jsx(_components.code,{children:`WordPress-Extra`}),` plus `,_jsx(_components.code,{children:`PHPCompatibilityWP`}),`) before publishing. See `,_jsx(_components.a,{href:`/unwan/developers/architecture`,children:`Architecture`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`The picker isn't showing up at checkout`,id:`the-picker-isnt-showing-up-at-checkout`,children:_jsxs(_components.p,{children:[`Check, in order: the customer is signed in (Unwan never offers saved addresses to guests); the relevant selector (billing/shipping) is enabled in `,_jsx(_components.strong,{children:`Accounts \u0026 Privacy → Unwan`}),`; and the customer actually has at least one address in their book (a billing or shipping profile default counts). The picker deliberately stays invisible rather than rendering an empty state when there’s nothing to pick from.`]})}),_jsx(Accordion,{title:`The address book endpoint doesn't appear in My Account`,id:`the-address-book-endpoint-doesnt-appear-in-my-account`,children:_jsxs(_components.p,{children:[`This usually means permalinks need refreshing. Unwan refreshes them automatically on activation and again the first time each site loads a new version, including every site of a multisite network. If the page still shows “Page not found” (for example after a staging sync that copied the database but not the rewrite rules), visit `,_jsx(_components.strong,{children:`Settings → Permalinks`}),` and click `,_jsx(_components.strong,{children:`Save Changes`}),` once to force a refresh.`]})}),_jsx(Accordion,{title:`A theme or plugin's CSS is bleeding into the picker`,id:`a-theme-or-plugins-css-is-bleeding-into-the-picker`,children:_jsxs(_components.p,{children:[`This should be rare given Unwan’s `,_jsx(_components.a,{href:`/unwan/customization/css-and-markup`,children:`ID-rooted CSS reset`}),`, but if you hit a specific conflict, load your override CSS after `,_jsx(_components.code,{children:`assets/css/unwan.css`}),` and target the stable root ID (`,_jsx(_components.code,{children:`#unwan-account-list`}),`, `,_jsx(_components.code,{children:`#unwan-billing-picker`}),`, `,_jsx(_components.code,{children:`#unwan-shipping-picker`}),`) plus the relevant BEM class — that combination has enough specificity to win without `,_jsx(_components.code,{children:`!important`}),`.`]})}),_jsx(Accordion,{title:`Saving an address fails with 'That address is already in your address book'`,id:`saving-an-address-fails-with-that-address-is-already-in-your-address-book`,children:_jsxs(_components.p,{children:[`This is expected behavior, not a bug: the entry you’re editing would normalize to the same first name, last name, street line, and postcode as a different existing entry. Edit or delete the other entry first if you actually want to merge them. See `,_jsx(_components.a,{href:`/unwan/concepts/default-swaps-and-duplicates`,children:`Default Swaps \u0026 Duplicate Detection`}),`.`]})}),_jsx(Accordion,{title:`A row's 'Delete' or 'Make default' action is disabled`,id:`a-rows-delete-or-make-default-action-is-disabled`,children:_jsx(_components.p,{children:`Both are intentional guardrails, enforced server-side, not just visually: an address currently holding a default role can’t be deleted until it’s reassigned, and an address already holding a role can’t be “made default” for that same role again. Hovering the disabled action shows why.`})}),_jsx(Accordion,{title:`Settings aren't saving`,id:`settings-arent-saving`,children:_jsxs(_components.p,{children:[`Unwan settings use WooCommerce’s own settings save pipeline (`,_jsx(_components.strong,{children:`WooCommerce → Settings → Accounts \u0026 Privacy → Unwan`}),`) — if changes there aren’t persisting, it’s almost always a WooCommerce-level issue (a conflicting plugin filtering `,_jsx(_components.code,{children:`woocommerce_get_settings_account`}),`, or a permissions problem), not something Unwan-specific.`]})})]}),`\n`,_jsxs(_components.p,{children:[`Still stuck? Reach out at `,_jsx(_components.a,{href:`mailto:hello@smartwpplugins.com`,children:`hello@smartwpplugins.com`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"FAQ \u0026 Troubleshooting","description":"Common questions and how to diagnose the usual issues","icon":"circle-question","href":"/unwan/faq"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"General","slug":"general","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"growquest-technologies","siteName":"SmartWP Plugins Documentation","title":"FAQ \u0026 Troubleshooting - SmartWP Plugins Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T13:16:46.919Z","gitLastModified":"2026-11-05T13:15:47.000Z","originalFileLocation":"unwan/faq.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Common questions and how to diagnose the usual issues\">\u003cmeta data-mint-head name=\"application-name\" content=\"SmartWP Plugins Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/growquest-technologies/u3jM5CYmtfp0iNZ0/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/growquest-technologies/u3jM5CYmtfp0iNZ0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/growquest-technologies/u3jM5CYmtfp0iNZ0/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/growquest-technologies/u3jM5CYmtfp0iNZ0/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/growquest-technologies/u3jM5CYmtfp0iNZ0/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/growquest-technologies/u3jM5CYmtfp0iNZ0/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/growquest-technologies/u3jM5CYmtfp0iNZ0/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/growquest-technologies/u3jM5CYmtfp0iNZ0/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/growquest-technologies/u3jM5CYmtfp0iNZ0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"FAQ \u0026amp; Troubleshooting - SmartWP Plugins Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Common questions and how to diagnose the usual issues\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SmartWP Plugins Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.smartwpplugins.com/unwan/faq\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://growquest-technologies.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=FAQ+%26+Troubleshooting\u0026amp;description=Common+questions+and+how+to+diagnose+the+usual+issues\u0026amp;theme=e3ae117994280647e9c5b6db\u0026amp;signature=4b2774683f10ec6e2c1096ccc82a4d6119e71fe2d16f5dc3647962d13a02210f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"FAQ \u0026amp; Troubleshooting - SmartWP Plugins Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Common questions and how to diagnose the usual issues\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://growquest-technologies.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=FAQ+%26+Troubleshooting\u0026amp;description=Common+questions+and+how+to+diagnose+the+usual+issues\u0026amp;theme=e3ae117994280647e9c5b6db\u0026amp;signature=4b2774683f10ec6e2c1096ccc82a4d6119e71fe2d16f5dc3647962d13a02210f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/growquest-technologies/u3jM5CYmtfp0iNZ0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SmartWP Plugins Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5B3FE0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.smartwpplugins.com/unwan/faq\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/unwan/faq.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.smartwpplugins.com/#organization\",\"name\":\"SmartWP Plugins Documentation\",\"url\":\"https://docs.smartwpplugins.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/growquest-technologies/9Hk7Fwl6-q3LJS13/images/LOGO_COLOR.svg?fit=max\u0026auto=format\u0026n=9Hk7Fwl6-q3LJS13\u0026q=85\u0026s=a43b0038924202eea5648ded3320a2f4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.smartwpplugins.com#website\",\"name\":\"SmartWP Plugins Documentation\",\"url\":\"https://docs.smartwpplugins.com\",\"publisher\":{\"@id\":\"https://docs.smartwpplugins.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.smartwpplugins.com/unwan/faq#webpage\",\"url\":\"https://docs.smartwpplugins.com/unwan/faq\",\"name\":\"FAQ \u0026 Troubleshooting\",\"description\":\"Common questions and how to diagnose the usual issues\",\"dateModified\":\"2026-11-05T13:15:47.000Z\",\"isPartOf\":{\"@id\":\"https://docs.smartwpplugins.com#website\"}},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.smartwpplugins.com/unwan/faq#article\",\"headline\":\"FAQ \u0026 Troubleshooting\",\"name\":\"FAQ \u0026 Troubleshooting\",\"description\":\"Common questions and how to diagnose the usual issues\",\"url\":\"https://docs.smartwpplugins.com/unwan/faq\",\"mainEntityOfPage\":{\"@id\":\"https://docs.smartwpplugins.com/unwan/faq#webpage\"},\"dateModified\":\"2026-11-05T13:15:47.000Z\",\"publisher\":{\"@id\":\"https://docs.smartwpplugins.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.smartwpplugins.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SmartWP Plugins Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"SmartWP Plugins Documentation","nav":{"global":null,"products":[{"product":"Unwan","pages":[{"title":"Introduction","icon":"house","href":"/unwan/introduction"},{"title":"Installation","icon":"download","href":"/unwan/installation"},{"title":"Quickstart","icon":"bolt","href":"/unwan/quickstart"},{"title":"The Address Book Page","icon":"address-book","href":"/unwan/my-account"},{"title":"Settings Reference","icon":"sliders","href":"/unwan/settings"},{"title":"Admin Orders","icon":"clipboard-list","href":"/unwan/admin-orders"},{"group":"Checkout","pages":[{"title":"Checkout Blocks","icon":"cube","href":"/unwan/checkout/checkout-blocks"},{"title":"Checkout Overview","icon":"cart-shopping","href":"/unwan/checkout/checkout-overview"},{"title":"Classic Checkout","icon":"receipt","href":"/unwan/checkout/classic-checkout"}]},{"group":"Concepts","pages":[{"title":"The Address Book Model","icon":"layer-group","href":"/unwan/concepts/address-book-model"},{"title":"Default Swaps \u0026 Duplicate Detection","icon":"shuffle","href":"/unwan/concepts/default-swaps-and-duplicates"}]},{"group":"Customization","pages":[{"title":"Appearance \u0026 Theming","icon":"palette","href":"/unwan/customization/appearance-and-theming"},{"title":"CSS Variables \u0026 Markup","icon":"code","href":"/unwan/customization/css-and-markup"}]},{"group":"Developers","pages":[{"title":"Architecture","icon":"sitemap","href":"/unwan/developers/architecture"},{"title":"Hooks Reference","icon":"plug","href":"/unwan/developers/hooks-reference"},{"title":"JavaScript API","description":"The shared picker controller used by both checkout adapters","icon":"square-js","href":"/unwan/developers/javascript-api"}]},{"title":"FAQ \u0026 Troubleshooting","icon":"circle-question","href":"/unwan/faq"},{"title":"Changelog","description":"Release history","icon":"clock-rotate-left","href":"/unwan/changelog"}]},{"product":"CartPresets for WooCommerce","pages":[{"title":"CartPresets for WooCommerce","href":"/cartpresets/introduction"}]},{"product":"Admin Powerups for WooCommerce","pages":[{"title":"Admin Powerups for WooCommerce","href":"/admin-powerups/introduction"}]}]},"basePath":"","title":"FAQ \u0026 Troubleshooting - SmartWP Plugins Documentation","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":[],"chunks":[]}