> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/dynamic-components/components/formatted-address.md).

# Formatted Address

The Avonni Formatted Address component displays a structured address — street, city, province, postal code, and country — with optional label, help text, locale formatting, geographic coordinates, read-only mode, and a static Google Map preview.

## Overview

Use Formatted Address when you want to render a Salesforce address field cleanly within a Dynamic Component page, with support for map visualization and locale-aware formatting.

## Configuration

To configure the Formatted Address, select it on the canvas. The configuration panel opens on the right. The sections below mirror the Properties panel from top to bottom.

### Properties

#### Label

The label displayed above the address. Connect it to a Salesforce field or type a static string.

#### Helptext

A tooltip shown next to the label to provide users with additional context. Requires: **Label** to be set.

#### Variant

Controls the position of the label relative to the address. Requires: **Label** to be set. Options:

* **Standard** (default) — label appears above the address.
* **Label Hidden** — the label is not displayed.
* **Label Inline** — the label appears to the left of the address on the same line.
* **Label Stacked** — the label is stacked above the address.
* **Label Spread** — the label and address are spread across the full width.

#### Street

The street line of the address.

#### City

The city portion of the address.

#### Province

The province or state portion of the address.

#### Postal Code

The postal or ZIP code of the address.

#### Country

The country portion of the address.

#### Latitude

The latitude of the location, if known. Values must be between -90 and 90. Providing latitude and longitude speeds up map rendering.

#### Longitude

The longitude of the location, if known. Values must be between -180 and 180. Providing latitude and longitude speeds up map rendering.

#### Locale

The locale used to format the address (for example, `en-US`). Defaults to `en-US`.

#### Read Only

When enabled, the address is displayed as plain text and cannot be clicked or focused on. Defaults to off.

#### Show Static Map

When enabled, a static Google Maps image of the location is displayed below the address. Defaults to off.

### Set Component Visibility

All components support conditional visibility — see [Component Visibility](/dynamic-components/core-concepts/component-visibility.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.avonnicomponents.com/dynamic-components/components/formatted-address.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.