WooCommerce Address Book


Notice – This plugin is does not currently work with the WooCommerce Block Checkout. It currently only supports the Classic WooCommerce checkout. We hope to find a way to integrate with the Block Checkout in the future.

Gives your customers the option to store multiple billing and shipping addresses and retrieve them on checkout. Addresses can be updated and modified quickly and easily in /my-account/, or saved as part of the checkout process.

There is a demo setup if you would like to try this plugin out with a demo store.


The settings for this plugin are located in WooCommerce General settings: WooCommerce -> Settings -> General.

WooCommerce Address Book options:

  • Enable billing/shipping address book
  • Add New Address as default selection
  • Enable setting Billing/Shipping Address Nickname during Checkout


View the source on GitHub. You can also submit an issue or pull request for anything new.


  1. Faça upload da pasta woo-address-book para o diretório /wp-content/plugins/
  2. Certifique-se que você tem o WooCommerce instalado e ativo.
  3. Ative o WooCommerce Address Book pelo menu ‘Plugins’ no WordPress.
  4. Address Book options will now appear on the customer’s account page and checkout once they’ve entered their primary billing or shipping address.


Por que não posso adicionar um novo endereço ao meu catálogo de endereços?

The address book will only begin to display after the primary billing or shipping address has been created for the customer.

Este plug-in permite que meus clientes enviem para vários locais com um único pedido?

Não, este plugin permite apenas o armazenamento de vários endereços de envio. Se um cliente quiser enviar para vários locais, ele deverá concluir vários pedidos.

Why is the address not populating my custom fields at checkout?

Most standard custom fields do work with the Address Book. However, if you have custom fields added by a plugin which are updated by javascript then the Address Book plugin will not always know how to handle the data. If you are running into an issue please post an issue in the support forum or on github with what plugin or code you are using and as much details as you can. We will determine if the Address Book plugin is able to provide support for the plugin or if a custom solution would need to be developed for your use case.

How can I add custom fields to my billing/shipping address?

WooCommerce Address Book uses the standard WooCommerce address functions so any method to modify the address fields will still work.
We have tested that using the standard filters works correctly:
* https://docs.woocommerce.com/document/tutorial-customising-checkout-fields-using-actions-and-filters/
We have also tested this plugin by WooCommerce:
* https://woocommerce.com/products/woocommerce-checkout-field-editor/

Como traduzo esse plugin?

We now use the new way of translating WordPress plugins at https://translate.wordpress.org/

Feel free to contribute a translation at https://translate.wordpress.org/projects/wp-plugins/woo-address-book/

Como minha tradução é aprovada?

Alguém precisa pedir para ser editor de tradução do plugin. Se você contribuiu com uma tradução, pode fazer a solicitação.

You can make the request and that request can be approved by the WordPress Localization editors.
See here for more details: https://make.wordpress.org/polyglots/handbook/rosetta/roles-and-capabilities/pte-request/#pte-request-by-a-translator

Como posso usar minha tradução antes da aprovação?

O que você pode fazer para usá-lo localmente agora é ir para a página de tradução.
Na parte inferior do link Exportar, selecione “Only matching the filter” e “Machine Object Message Catalog (.mo)” e clique em Exportar para baixar o arquivo .mo.

Em seguida, salve este arquivo .mo no seu site WordPress em wp-content/languages/plugins/woo-address-book-LANGUAGE.mo substituindo LANGUAGE pelo código do seu idioma.

For example for German, you would go here:

Em seguida, salve este arquivo .mo em seu site WordPress em wp-content/languages/plugins/woo-address-book-de_DE.mo

Você também pode usar o PoEdit e criar um arquivo de tradução que pode ser exportado como um arquivo .mo para ser salvo no mesmo local.


6 setembro, 2023
I have been using this plugin for my highly custom site, and so far, it stands as the best address book plugin for WooCommerce. It is incredibly simple, well-coded (with no noticeable bloat), easy to install and configure, and easy to customize from both a developer and user standpoint. Plugins like this one save me (and everyone else) dozens of hours of development time, so I truly appreciate when people can put out a clean plugin that delivers exactly what it advertises. Great work team 🙌
20 setembro, 2022
The plugin allows to create the address book of customers as described. At this point, it is quite practical and functional. There are currently no functional defects. So it does what it promises. Also, according to Woocommerce updates, the plugin works in harmony and updates are made when necessary. For now, my advice is to improve the my account>addresses section in terms of design. Hopefully, there will be a study for this in the next updates. It could be a more eye-catching design. Thank you.
5 agosto, 2022
This is exactly what I need. Although I think the search address is not needed but it’s actually a quite nice feature to have at your disposal. Nice work. Highly recommend this plugin.
3 fevereiro, 2022
Really nice plugin, compatible with checkout editor plugins and great support. In a few days a new release has been released which solves two issues that I have reported. Thanks!
Leia todas as 22 avaliações

Colaboradores e desenvolvedores

“WooCommerce Address Book” é um software com código aberto. As seguintes pessoas contribuíram para este plugin.


“WooCommerce Address Book” foi traduzido para 16 localizações. Agradecemos aos tradutores por suas contribuições.

Traduzir “WooCommerce Address Book” para o seu idioma.

Interessado no desenvolvimento?

Navegue pelo código, dê uma olhada no repositório SVN ou assine o registro de desenvolvimento via RSS.

Registro de alterações


  • Declare checkout block incompatibility.
  • Bump versions.

2.6.1 and 2.6.2

  • Detect and downgrade from Address Book 3.0 addresses if they exist.


  • Add notice about 3.0.0
  • Warning: 3.x+ will be a breaking change if you have customizations for the plugin.


  • Declare HPOS compatibility.
  • Feature: Add option to use radio button instead of dropdown select.


  • Tweak: Update change detection on Address Book selector so the listeners still work even if the elements are reloaded on the page.


  • New: Setting to block readonly fields from updating when changing addresses. They will be updatable by default.


  • Dev: Rare potential breaking change if overriding javascript Restructured javascript to be more modular and allow external access. #133
  • New: New feature to set a limit for number of saved addresses in the admin settings.


  • Update: When “Enable the shipping calculator on the cart page” is not checked in the admin then the City/State/Zip fields will not be pre-populated on Add New Address.


  • Fix: When using WooCommerce Subscriptions, preserve existing address when doing a manual payment on the subscription.
  • Cleanup: Improve the checking for the address from the cart to prevent some issues with it not being loaded.


  • Fix: Address saving to customer Address Book if Billing or Shipping Address Book was disabled. #128


  • Fix: “Enable setting Billing Address Nickname during Checkout” setting not working properly #121


  • Require jquery-blockui for the script to fix loading order.


  • Add wc_address_book_show_billing_address_button and wc_address_book_show_shipping_address_button so you can programmatically disable the add new address buttons.

2.0.2 and 2.0.3


  • Fix select address issue when ‘Add New Address as default selection’ is enabled for shipping address.
  • Improve backwards compatibility with versions prior to 2.0.0
  • Better support custom field types other than standard input field.


  • This is version 2.0.0 which is a major update with new functionality, be sure to review the changes below.
  • Billing and Shipping address support. This release adds support for Billing addresses in addition to Shipping addresses.
  • New settings to be able to Enable or Disable the address book for billing or shipping. Thanks Hinyka
    • Make sure to set these settings for your store after updating. Both are enabled by default.
  • Adds settings to set if new address should be selected or primary address on checkout.
  • Adds setting if the address nickname field should show on checkout.
  • Fix checkbox to change address that didn’t work from showing with WooCommerce Subscriptions plugin.
  • Adds confirmation when deleting an address from the address book.
  • Support for PHP 8 and jQuery 3. Thanks Hinyka
  • Various other fixes, see #97 for details.


  • Atualize as strings de país que foram alteradas no WooCommerce 4.0
  • adicionado load_plugin_textdomain


  • Atualização para suportar as versões mais recentes do WooCommerce 3.x e 4.0.0 com funções CRUD do cliente.


  • Corrige a regressão que causou um erro ao criar um novo usuário durante a finalização de compra.


  • Corrige a regressão da atualização de segurança em 1.6.0 que impedia o salvamento de novos endereços na finalização de compra.
  • Limpeza do Código.


  • Corrigido se você tinha selectize.js instalado no site, mas ainda usando selectWoo para checkout. Agora você deve aplicar manualmente a seleção ao seletor do catálogo de endereços se desejar usar a seleção na finalização da compra.


  • Fixed issue with selectWoo not loadingon checkout if “Ship to a different address?” was not enabled by default. Thanks titodevera#62
  • Adicionado suporte para selectize.js se usado selectWoo nos campos de seleção de lista.


  • Remove unneeded nopriv ajax actions. #60 #61


  • Added support for address nicknames. Thanks titodevera#60 #59
  • Segurança: Atualizadas todas chamadas de salvamento para realizar verificações nonce.
  • Atualiza a geração de url do endpoint para evitar que o parâmetro de consulta seja filtrado. Correções de conflito com o plugin WPML.


  • Stop enqueuing the plugin styles and scripts on every page. Only enqueue them when needed. Thanks titodevera#58 #59


  • Corrige a alteração do país se o campo estiver definido como somente leitura. Não altera nenhum campo definido como somente leitura.


  • Fix missing close div in address book form. Thanks ThomasK0lasa#54
  • Usa uma versão minificada do scripts.js
  • Melhoria no salvamento de endereços determinando qual o próximo a ser usado.
  • Fix first address creation on checkout from being set to shipping2 #55
  • Não mostra a seleção de endereços para novos usuários que ainda não tem endereço cadastrado.


  • Fix regression from 1.5.0 which broke switching primary address. Thanks ThomasK0lasa#53


  • Atualiza o campo do país com atualizações do WooCommerce 3.6.x. Corrige inconsistências com a versão de estoque atualizada.
  • Suporta SelectWoo além do select2 para seletor de endereços ao finalizar a compra.


  • Atualiza os links do catálogo de endereços para que não tenham uma barra final.


  • Corrige o salvamento de novos endereços no catálogo no WooCommerce 3.6.x devido a uma alteração no processo de salvamento de endereços.
  • Corrige o manuseio de catálogos de endereços vazios. Não preenche mais catálogos de endereços de todos os usuários na ativação, pois agora lidamos com catálogos vazios.
  • Corrigido o problema ao salvar mais de 10 endereços no catálogo de endereços. Obrigado @ JonBoss5


  • Limit get_users to just returning IDs. Significantly decreases the amount of memory needed on activation on a site with many users. (thanks pjv)
  • Limpeza de formatação PHP e JS.


  • Remove todas as barras finais ao obter o nome do endereço do URL
  • Não exibir a lista do catálogo de endereços ao finalizar a compra se um endereço de entrega padrão não tiver sido definido.
  • Correção de bugs diversos.


  • Adicionado filtro wc_address_book_addresses para permitir modificações no catálogo de endereço.
  • Melhorias de JS da lista de endereços do catálogo ao finalizar a compra. Obrigado ebelrose pela contribuição.


  • Adicionada pasta languages com arquivo .pot para i18n.
  • Adicionado condições isset() para address_select_label() caso campos tenham sido removidos.


  • Atualizado o filtro wc_address_book_address_select_label para adicionar $address e $name, o que deve abrir várias opções para modificar a saída.
  • Limpeza na base do código do plugin de acordo com WordPress-Coding-Standards.


  • Adicionado domínio de texto e atualizado o escopo de AJAX em minha conta. Obrigado a pabl0rg e nicolasmn por suas contribuições!


  • Corrigido um bug para redefinir corretamente o valor do estado ao selecionar ‘novo endereço’.


  • Corrigido um bug que impedia o campo do país de envio de limpar se apenas um país fosse uma opção ao finalizar a compra.


  • Adicionado suporte multisite.


  • Corrigido um bug que impedia de salvar o endereço.


  • Limpa campos de finalização de compra quando adicionado novo endereço.


  • Alterado para utilizar variáveis $_GET e permitir campos customizados de serem salvos.


  • Versão inicial.