---
title: purchase.address-autocomplete.format-suggestion
description: "

  \  An extension target that formats the selected address suggestion provided by a [`purchase.address-autocomplete.suggest`](/docs/api/checkout-ui-extensions/2025-07/targets/address/purchase-address-autocomplete-suggest) target. This formatted address is used to auto-populate the fields of the address form.


  \  It must return a [`formattedAddress`](/docs/api/checkout-ui-extensions/2025-07/targets/address/purchase-address-autocomplete-format-suggestion#addressautocompleteformatsuggestionoutput-propertydetail-formattedaddress).


  \  > Caution:

  \  > This extension target is only necessary if the corresponding [`purchase.address-autocomplete.suggest`](/docs/api/checkout-ui-extensions/2025-07/targets/address/purchase-address-autocomplete-suggest) target does not provide a `formattedAddress` for the suggestions. If a formatted address is provided with each suggestion, then this target will not be called.

  \  >

  \  > If the [`purchase.address-autocomplete.suggest`](/docs/api/checkout-ui-extensions/2025-07/targets/address/purchase-address-autocomplete-suggest) target is not implemented, then this target will not work.


  \  > Note:

  \  > - This target does not support rendering UI components.

  \  > - This extension can only be developed as a JavaScript extension using the `ui-extensions` library.

  \  > - The [app extension configuration](/docs/apps/app-extensions/configuration) `shopify.extension.toml` file is shared between this extension target and [`purchase.address-autocomplete.suggest`](/docs/api/checkout-ui-extensions/2025-07/targets/address/purchase-address-autocomplete-suggest). This includes extension settings specified in the configuration file.

  \  "
api_version: 2026-04
api_name: checkout-ui-extensions
source_url:
  html: https://shopify.dev/docs/api/checkout-ui-extensions/latest/targets/address/purchase-address-autocomplete-format-suggestion
  md: https://shopify.dev/docs/api/checkout-ui-extensions/latest/targets/address/purchase-address-autocomplete-format-suggestion.md
---

purchase.​address-autocomplete.​format-suggestion

Not supported in this version.