FAQ

Address Autocomplete questions.

Answers about setup, provider keys, checkout behaviour, privacy, and troubleshooting.

Getting started

What do I need after activation?+

Open WooCommerce → Settings → Address Autocomplete, enable the plugin, choose one provider, enter that provider's API key, and choose Save changes. Test billing and shipping addresses before opening checkout to customers.

Will the plugin load a provider SDK in the browser?+

No provider SDK is bundled into checkout. The plugin loads its own checkout script and sends requests to a WordPress REST endpoint when the shopper enters enough characters.

Can customers still type an address manually?+

Yes. Autocomplete enhances the normal address field; it does not remove manual entry.

Providers and API keys

How many providers are included?+

There are 8 provider modes across 7 services: Google Places (New), Google Places (Legacy), Mapbox Search, HERE Geocoding & Search, TomTom, Loqate, LocationIQ, and Geoapify.

Why are Google Places New and Legacy separate?+

They use separate provider modes and separate API-key fields. New Google Cloud projects should use Places API (New). The legacy mode exists for stores whose existing project still has Places API Legacy access; new projects cannot enable the legacy service.

Is my API key exposed in frontend JavaScript?+

No. Provider requests are made by your WordPress server, so the provider API key is not placed in the page source or frontend JavaScript bundle.

Can I switch providers later?+

Yes. Enter the new provider's key, select that provider, save, and run checkout tests again. Keys for inactive providers can remain saved but are not used.

Which provider is cheapest or most accurate?+

Coverage, pricing, quotas, retention, and permitted uses change over time. Compare the official documentation and pricing links in the provider setup guide, then test representative addresses in every country your store serves.

Which Loqate service does the plugin use?+

It uses Loqate Address Capture. The integration handles container results and retrieves a final address; it is not the separate Address Verify service.

What should I know before using Mapbox?+

The plugin uses Mapbox Search Box. Mapbox documents Search Box results for temporary use, so confirm that your Mapbox agreement permits storing checkout address data before enabling it on a live store.

Checkout behaviour

Does it support WooCommerce block checkout?+

Yes. The selected provider uses WooCommerce Core's native address-autocomplete framework for classic and block checkout where available. Older supported versions use the plugin's compatibility interface.

Does QuixWP require WooPayments?+

No. QuixWP connects your chosen address provider using your own API key. It adds provider integrations and request controls to WooCommerce Core's framework without requiring WooPayments.

What happens when a provider request fails?+

Checkout remains usable and customers can type their address manually. Detailed provider diagnostics appear in a dismissible frontend notice only for logged-in administrators with the manage_options capability. Check the provider key, account status, enabled APIs, quota, and country coverage.

Why is a city, state, or postcode sometimes missing?+

Some provider results, landmarks, rural locations, and partial records do not include every structured address component. Try a more specific street-address result and compare another provider before reporting a problem.

How are countries restricted?+

The plugin derives a read-only restriction from the store's WooCommerce country configuration. Change selling and shipping destinations under WooCommerce → Settings → General. Google Places (New) supports up to 15 region codes and Google Places (Legacy) up to 5 countries.

Can I choose a light or dark dropdown?+

Yes. Select Light or Dark under Dropdown Theme. The chosen theme is explicit and does not depend on the shopper's operating-system preference.

Privacy

What address data reaches the provider?+

The partial address query travels from the shopper's browser to your WordPress site and then to the selected provider. Selecting a suggestion also sends its identifier to retrieve structured address details. The provider API key stays server-side.

Does the plugin make my store GDPR compliant?+

No plugin can make that guarantee by itself. The store owner must review the chosen provider's terms, data-processing agreement, retention, international transfers, and permitted use, then update the store privacy notice and obtain legal advice where needed.

Technical

Does it work with HPOS?+

Yes. Compatibility with WooCommerce High-Performance Order Storage is declared by the plugin.

Where are settings stored?+

Plugin settings are stored in the WordPress options table. Deactivation preserves them; deleting the plugin through WordPress runs the uninstall cleanup.

How do I get support?+

Use the plugin support form. Include the WordPress and WooCommerce versions, checkout type, selected provider, destination country, and a redacted screenshot. Never send an API key.